on 665b834 help sign in
22 files changed+399−981
since splitsnapshots
unifiedsplit
.gitignore−1 .travis.yml+7−40 CHANGELOG.md−71 CONTRIBUTING.md+2−12 LICENSE+1−1 Makefile+2−21 README.md+10−37 docker.cabal+12−26 examples/Example.hs+43−52 src/Docker/Client.hs+5−12 src/Docker/Client/Api.hs+59−80 src/Docker/Client/Http.hs+37−72 src/Docker/Client/Internal.hs+24−40 src/Docker/Client/Types.hs+89−233 stack-7.10.yaml−32 stack-8.0.2.yaml−4 stack-8.0.yaml−5 stack-8.6.4.yaml−4 stack-8.8.2.yaml−5 stack.yaml+32−1 tests/Dockerfile+1−1 tests/tests.hs+75−231
.gitignore−1
@@ -4,4 +4,3 @@
44*~
55.stack-work/
66dist-newstyle
7−/cabal.project.local
.travis.yml+7−40
@@ -1,12 +1,6 @@
11sudo: required
22dist: trusty
33
4−# Only build master and release tags
5−branches:
6− only:
7− - master
8− - /^v\d+\.\d+(\.\d+)?(-\S*)?$/
9−
104# Choose a lightweight base image; we provide our own build tools.
115language:
126 c
@@ -22,30 +16,7 @@ services:
2216 - docker
2317
2418env:
25− global:
26− - RUN_INTEGRATION_TESTS=1
27− - STACK_ARGS=""
28−
29− matrix:
30− - DOCKER_VERSION="1.12.3-0~trusty" GHCVER=7.10
31− - DOCKER_VERSION="1.13.1-0~ubuntu-trusty" GHCVER=7.10
32− - DOCKER_VERSION="17.05.0~ce-0~ubuntu-trusty" GHCVER=7.10
33−
34− - DOCKER_VERSION="1.12.3-0~trusty" GHCVER=8.0
35− - DOCKER_VERSION="1.13.1-0~ubuntu-trusty" GHCVER=8.0
36− - DOCKER_VERSION="17.05.0~ce-0~ubuntu-trusty" GHCVER=8.0
37−
38− - DOCKER_VERSION="1.12.3-0~trusty" GHCVER=8.0.2
39− - DOCKER_VERSION="1.13.1-0~ubuntu-trusty" GHCVER=8.0.2
40− - DOCKER_VERSION="17.05.0~ce-0~ubuntu-trusty" GHCVER=8.0.2
41−
42− - DOCKER_VERSION="1.12.3-0~trusty" GHCVER=8.6.4
43− - DOCKER_VERSION="1.13.1-0~ubuntu-trusty" GHCVER=8.6.4
44− - DOCKER_VERSION="17.05.0~ce-0~ubuntu-trusty" GHCVER=8.6.4
45−
46− - DOCKER_VERSION="1.12.3-0~trusty" GHCVER=8.8.2
47− - DOCKER_VERSION="1.13.1-0~ubuntu-trusty" GHCVER=8.8.2
48− - DOCKER_VERSION="17.05.0~ce-0~ubuntu-trusty" GHCVER=8.8.2
19+ - STACK_ARGS=""
4920
5021addons:
5122 apt:
@@ -53,24 +24,20 @@ addons:
5324 - libgmp-dev
5425
5526before_install:
56− # Upgrade docker to 1.12.3.0
27+ # Upgrade docker to 1.12
5728 - sudo sh -c 'echo "deb https://apt.dockerproject.org/repo ubuntu-trusty main" > /etc/apt/sources.list.d/docker.list'
5829 - sudo apt-key adv --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
5930 - sudo apt-get update
60− - sudo apt-get -qqy -o Dpkg::Options::="--force-confdef" -o Dpkg::Options::="--force-confold" install docker-engine=$DOCKER_VERSION
61−
62−install:
31+ - sudo apt-get -qqy -o Dpkg::Options::="--force-confdef" -o Dpkg::Options::="--force-confold" install docker-engine=1.12.0-0~trusty
6332 - mkdir -p "$HOME"/.local/bin
6433 - export PATH=$HOME/.local/bin:$PATH
65− - export STACK_YAML=stack-$GHCVER.yaml
34+
6635 # install Stack
6736 - travis_retry curl -L https://www.stackage.org/stack/linux-x86_64 | tar xz --wildcards --strip-components=1 -C $HOME/.local/bin '*/stack'
68− - export PATH=$(stack path --local-install-root):$PATH
69− - stack --version
37+ - export PATH=$(stack --stack-yaml stack.yaml path --local-install-root):$PATH
38+ - stack setup
39+
7040
7141script:
72− - stack setup
73− - stack update
74− - stack build
7542 - stack test
7643
CHANGELOG.md−71
@@ -1,76 +1,5 @@
11# CHANGELOG
22
3−## 0.6.0.3 (2020-02-17)
4−
5−- Support for ghc 8.8.2.
6−- Bump dependency version.
7−- Use MonadFail for later versions.
8−
9−## 0.6.0.1 (2019-05-23)
10−
11−- Support ghc 8.6.4.
12−- Bump containers version.
13−
14−## 0.6.0.0 (2018-06-28)
15−
16−- Rename DeleteOpts to ContainerDeleteOpts.
17−- Implement image deletion.
18−- Bump aeson version.
19−- Implement network aliases.
20−- Implement creating/deleting networks.
21−
22−## 0.5.1.1 (2018-03-09)
23−
24−- Bump aeson version.
25−
26−## 0.5.1.0 (2018-02-23)
27−
28−- Support http-conduit-2.3.0.
29−- Bump http-types versions.
30−
31−## 0.5.0.1 (2018-01-26)
32−
33−- Bumps upper bound for http-types (properly this time).
34−
35−## 0.5.0.0 (2018-01-24)
36−
37−- Added (some) contribution and general docs
38−- Fix case when stopping non-existent container
39−- Added more integration tests
40−- Fixed error while parsing list container endpoint output
41−- Changed State/Status data type (related to the above fix)
42−- Added tests against different docker version to travis CIA
43−- Fixed EnvVar JSON encoding
44−- Fixed NetworkMode parsing
45−- Allow http-types 0.11
46−
47−## 0.4.1.1 (2017-10-16)
48−
49−- Small change to add env var for skipping integration tests.
50− This is mostly to avoid running those on stackage.
51−
52−## 0.4.1.0 (2017-10-04)
53−
54−- Relaxed aeson, tls and time upper bounds
55−
56−
57−## 0.4.0.2 (2017-09-19)
58−
59−- Support LTS 9.4
60−
61−## 0.4.0.1 (2017-06-29)
62−
63−- fixes omKillDisable parsing from json
64−- adds Entrypoint data type and tests edge cases
65−- more tests
66−- small comsmetic changes
67−
68−## 0.4.0.0 (2017-03-20)
69−
70−- Adds streaming support via conduits (changes API a bit hence the major version release)
71−- Added support for streaming log output
72−- Added support for pulling images from the hub (and streaming the output)
73−
743## 0.3.0.1 (2016-09-07)
754
765- Small cosmetic changes and marking OVERLAPPING instance
CONTRIBUTING.md+2−12
@@ -1,14 +1,4 @@
1−# Contributing
1+# TODO
22
3−If you wish to contribute please see [any issue on GitHub tagged with "help
4−wanted"](https://github.com/denibertovic/docker-hs/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22).
5−Before starting to work, consider commenting on the issue you want to resolve or
6−open a new issue to discuss design decisions and implementation details. This is
7−so that no development cycles go to waste on implementing a feature that might
8−not get merged either because of implementation details or other reasons.
3+Add basic guidelines here, things like style guide (using .configuration files from the repo) etc etc.
94
10−Make sure to submit your PR's against the `master` branch.
11−
12−## Project Setup
13−
14−See the `README.md` file on how to setup the project on your development machine.
LICENSE+1−1
@@ -1,4 +1,4 @@
1−Copyright (c) 2014, Deni Bertovic
1+Copyright (c) 2016, Deni Bertovic
22
33All rights reserved.
44
Makefile+2−21
@@ -1,6 +1,4 @@
1−.PHONY: build repl test release help
2−
3−.DEFAULT_GOAL = help
1+.PHONY: build repl test release
42
53PROJECT_NAME ?= $(shell grep "^name" docker.cabal | cut -d " " -f17)
64VERSION ?= $(shell grep "^version:" docker.cabal | cut -d " " -f14)
@@ -8,35 +6,18 @@ RESOLVER ?= $(shell grep "^resolver:" stack.yaml | cut -d " " -f2)
86GHC_VERSION ?= $(shell stack ghc -- --version | cut -d " " -f8)
97ARCH=$(shell uname -m)
108
11−## Run build
129build:
1310 @stack build
1411
15−## Run repl
1612repl:
1713 @stack repl
1814
19−## Run tests. Example RUN_INTEGRATION_TESTS=1 make test
2015test:
21− @RUN_INTEGRATION_TESTS=1 stack test
16+ @stack test
2217
23−## Cut new release
2418release:
2519 @stack build --haddock
2620 @stack sdist
2721 @echo "\n\nDone. Now run: \n\nstack upload <path_to_tarball>\n"
2822 @echo "\nAnd: \n\ngit tag ${VERSION} && git push --tags\n"
2923
30−## Show help screen.
31−help:
32− @echo "Please use \`make <target>' where <target> is one of\n\n"
33− @awk '/^[a-zA-Z\-\_0-9]+:/ { \
34− helpMessage = match(lastLine, /^## (.*)/); \
35− if (helpMessage) { \
36− helpCommand = substr($$1, 0, index($$1, ":")-1); \
37− helpMessage = substr(lastLine, RSTART + 3, RLENGTH); \
38− printf "%-30s %s\n", helpCommand, helpMessage; \
39− } \
40− } \
41− { lastLine = $$0 }' $(MAKEFILE_LIST)
42−
README.md+10−37
@@ -1,48 +1,21 @@
11# An API client for docker written in Haskell
22
3−| Master |
4−| -------|
5−| [![master](https://travis-ci.org/denibertovic/docker-hs.svg?branch=master)](https://travis-ci.org/denibertovic/docker-hs) |
3+| Master | Dev |
4+| -------| ---- |
5+| [![master](https://travis-ci.org/denibertovic/docker-hs.svg?branch=master)](https://travis-ci.org/denibertovic/docker-hs) | [![dev](https://travis-ci.org/denibertovic/docker-hs.svg?branch=dev)](https://travis-ci.org/denibertovic/docker-hs) |
66
77
88## Current state
99
10−Supported Docker Engine Api version: `v1.24` and onwards.
11−
12−Anything upward of that should work since Docker versions their API.
13−Older docker version and engine api versions are not supported at the moment.
14−
15−## Documentation
16−
17−The API-documentation is available at
18−[Hackage](https://hackage.haskell.org/package/docker). There are also some
19−usage-examples in the main library source file,
20−[`Client.hs`](https://hackage.haskell.org/package/docker/docs/Docker-Client.html).
10+**API is still no stable.**
11+We're looking to stabilize the API after the next release (0.4.0.0)
2112
2213## Contributing
2314
24−Please see [CONTRIBUTING.md](CONTRIBUTING.md).
25−
26−### Project Setup
27−
28−For working on the library, you need the Haskell Tool Stack installed (see [the
29−Haskell Tool Stack
30−website](https://docs.haskellstack.org/en/stable/install_and_upgrade/)). You
31−also need `make` to use the `Makefile` included in the project. Run `make help`
32−to see the available commands (for building, running the tests and releasing).
33−
34−### Tests
35−
36−Tests are located in the `tests` directory and can be run with `make test`. This
37−only runs the unit tests.
38−
39−To run integration tests, you need Docker installed and listening on Port `2375`
40−of `localhost` (docker only listens to a Unix socket by default, see the [Docker
41−documentation](https://docs.docker.com/engine/reference/commandline/dockerd/#daemon-socket-option)
42−for details). Set the environment variable `RUN_INTEGRATION_TESTS`, i.e.
43−`RUN_INTEGRATION_TESTS=1 make test`.
15+If you wish to contribute please see any issue tagged with "help wanted".
16+Make sure to submit your PR's against the `dev` branch.
4417
45−## IRC
18+Please consider filling an Issue first and discuss design decisions and implementation details before
19+writing any code. This is so that no development cycles go to waste on implementing a feature that
20+might not get merged either because of implementation details or other reasons.
4621
47−If you have any questions or suggestions you can find the maintainers in `#docker-haskell`
48−on freenode.
docker.cabal+12−26
@@ -1,5 +1,5 @@
11name: docker
2−version: 0.6.0.3
2+version: 0.3.0.1
33synopsis: An API client for docker written in Haskell
44description: See API documentation below.
55homepage: https://github.com/denibertovic/docker-hs
@@ -14,29 +14,24 @@ extra-source-files: README.md
1414cabal-version: >=1.10
1515stability: experimental
1616
17−-- Flag small-http-conduit
18−-- Description: Resolve whether http-conduit < 2.3.0.
19−-- Manual: False
20−-- Default: True
21−
2217library
23− default-extensions: DeriveGeneric, OverloadedStrings, ScopedTypeVariables, ExplicitForAll, MultiParamTypeClasses, FlexibleContexts, GeneralizedNewtypeDeriving, RankNTypes, DeriveFunctor, FlexibleInstances, CPP
18+ default-extensions: DeriveGeneric, OverloadedStrings, ScopedTypeVariables, ExplicitForAll, MultiParamTypeClasses, FlexibleContexts, GeneralizedNewtypeDeriving, RankNTypes, DeriveFunctor, FlexibleInstances
2419 hs-source-dirs: src
2520 exposed-modules: Docker.Client, Docker.Client.Api, Docker.Client.Types, Docker.Client.Internal, Docker.Client.Http, Docker.Client.Utils
2621 -- other-modules: Docker.Internal
2722 build-depends: base >= 4.7 && < 5
28− , aeson >= 0.9.0 && < 2.0.0
23+ , aeson >= 0.9.0 && < 1.1.0
2924 , blaze-builder >= 0.4.0 && < 0.5.0
3025 , bytestring >= 0.10.0 && < 0.11.0
31− , containers >= 0.5.0 && < 0.7.0
26+ , containers >= 0.5.0 && < 0.6.0
3227 , data-default-class >= 0.0.1 && < 0.2.0
33− , http-client >= 0.4.0 && < 0.7.0
34− , http-types >= 0.9 && < 0.13
35− , vector
28+ , http-client >= 0.4.0 && < 0.5.0
29+ , http-types >= 0.9 && < 0.10.0
3630 , conduit
3731 , conduit-combinators
3832 , conduit-extra
3933 , exceptions
34+ , http-conduit
4035 , monad-control
4136 , resourcet
4237 , transformers
@@ -51,20 +46,13 @@ library
5146 , mtl >= 2.0.0 && < 3.0.0
5247 , network >= 2.6.0
5348 , text >= 1.0.0 && < 2.0.0
54− , time >= 1.5.0 && < 2.0.0
49+ , time >= 1.5.0 && < 1.7.0
5550 , scientific >= 0.3.0 && < 0.4.0
56− , tls >= 1.3.7 && < 1.6.0
51+ , tls >= 1.3.7 && < 1.4.0
5752 , unordered-containers >= 0.2.0 && < 0.3.0
58− , x509 >= 1.6.0 && < 1.8.0
59− , x509-store >= 1.6.0 && < 1.8.0
60− , x509-system >= 1.6.0 && < 1.8.0
61− , http-conduit
62− , unliftio-core >= 0.1.0.0 && < 0.2.0
63− -- if flag(small-http-conduit)
64− -- build-depends: http-conduit < 2.3.0
65− -- else
66− -- build-depends: http-conduit >= 2.3.0
67− -- , unliftio-core
53+ , x509 >= 1.6.0 && < 1.7.0
54+ , x509-store >= 1.6.0 && < 1.7.0
55+ , x509-system >= 1.6.0 && < 1.7.0
6856 default-language: Haskell2010
6957 ghc-options: -Wall -fno-warn-name-shadowing
7058
@@ -73,7 +61,6 @@ test-suite docker-hs-tests
7361 , bytestring
7462 , connection
7563 , docker
76− , directory
7764 , aeson
7865 , containers
7966 , unordered-containers
@@ -89,7 +76,6 @@ test-suite docker-hs-tests
8976 , transformers
9077 , QuickCheck
9178 , process
92− , vector
9379 type: exitcode-stdio-1.0
9480 main-is: tests.hs
9581 hs-source-dirs: tests
examples/Example.hs+43−52
@@ -1,64 +1,55 @@
11import Docker.Client
22
33runNginxContainer :: IO ContainerID
4−runNginxContainer = do
5− h <- defaultHttpHandler
6− runDockerT (defaultClientOpts, h) $
7− do let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
8− let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
9− cid <- createContainer myCreateOpts (Just "myNginxContainer")
10− case cid of
11− Left err -> error $ show err
12− Right i -> do
13− _ <- startContainer defaultStartOpts i
14− return i
4+runNginxContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
5+ let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
6+ let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
7+ cid <- createContainer myCreateOpts (Just "myNginxContainer")
8+ case cid of
9+ Left err -> error $ show err
10+ Right i -> do
11+ _ <- startContainer defaultStartOpts i
12+ return i
1513
1614stopNginxContainer :: ContainerID -> IO ()
17−stopNginxContainer cid = do
18− h <- defaultHttpHandler
19− runDockerT (defaultClientOpts, h) $
20− do r <- stopContainer DefaultTimeout cid
21− case r of
22− Left _ -> error "I failed to stop the container"
23− Right _ -> return ()
15+stopNginxContainer cid = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
16+ r <- stopContainer DefaultTimeout cid
17+ case r of
18+ Left _ -> error "I failed to stop the container"
19+ Right _ -> return ()
2420
2521runPostgresContainer :: IO ContainerID
26−runPostgresContainer = do
27− h <- defaultHttpHandler
28− runDockerT (defaultClientOpts, h) $
29− do let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
30− let b = Bind "/tmp" "/tmp" Nothing
31− let myCreateOpts = addBind b $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
32− cid <- createContainer myCreateOpts Nothing
33− case cid of
34− Left err -> error $ show err
35− Right i -> do
36− _ <- startContainer defaultStartOpts i
37− return i
22+runPostgresContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
23+ let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
24+ let b = Bind "/tmp" "/tmp" Nothing
25+ let myCreateOpts = addBind b $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
26+ cid <- createContainer myCreateOpts Nothing
27+ case cid of
28+ Left err -> error $ show err
29+ Right i -> do
30+ _ <- startContainer defaultStartOpts i
31+ return i
3832
3933-- | Example of how we can start a database container while hosting it's
4034-- data in a data volume living inside another container.
4135runPostgresWithDataContainer :: IO ContainerID
42−runPostgresWithDataContainer = do
43− h <- defaultHttpHandler
44− runDockerT (defaultClientOpts, h) $
45− -- We use a dummy command like /bin/true because we don't want to start
46− -- the postgres database in the data container we just want it to
47− -- create a container filesystem for us.
48− do let dataOpts = setCmd "/bin/true" $ defaultCreateOpts "postgres:9.5"
49− cid <- createContainer dataOpts (Just "myDataContainer")
50− _ <-
51− case cid of
52− Left err -> error $ show err
53− Right i -> startContainer defaultStartOpts i
54− let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
55− -- Default permission is read-write if we don't specify anything
56− let vf = VolumeFrom "myDataContainer" Nothing
57− let myCreateOpts = addVolumeFrom vf $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
58− ccid <- createContainer myCreateOpts (Just "pgContainer")
59− case ccid of
60− Left err -> error $ show err
61− Right i -> do
62− _ <- startContainer defaultStartOpts i
63− return i
36+runPostgresWithDataContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
37+ -- We use a dummy command like /bin/true because we don't want to start
38+ -- the postgres database in the data container we just want it to
39+ -- create a container filesystem for us.
40+ let dataOpts = setCmd "/bin/true" $ defaultCreateOpts "postgres:9.5"
41+ cid <- createContainer dataOpts (Just "myDataContainer")
42+ _ <- case cid of
43+ Left err -> error $ show err
44+ Right i -> startContainer defaultStartOpts i
45+ let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
46+ -- Default permission is read-write if we don't specify anything
47+ let vf = VolumeFrom "myDataContainer" Nothing
48+ let myCreateOpts = addVolumeFrom vf $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
49+ ccid <- createContainer myCreateOpts (Just "pgContainer")
50+ case ccid of
51+ Left err -> error $ show err
52+ Right i -> do
53+ _ <- startContainer defaultStartOpts i
54+ return i
6455
src/Docker/Client.hs+5−12
@@ -3,7 +3,7 @@
33
44{-|
55Module : Docker.Client
6−Copyright : (c) Deni Bertovic, 2014
6+Copyright : (c) Deni Bertovic, 2016
77License : BSD3
88Maintainer : deni@denibertovic.com
99Stability : experimental
@@ -20,9 +20,7 @@ the host.
2020import Docker.Client
2121
2222runNginxContainer :: IO ContainerID
23−runNginxContainer = do
24− h <- defaultHttpHandler
25− runDockerT (defaultClientOpts, h) $ do
23+runNginxContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
2624 let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
2725 let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
2826 cid <- createContainer myCreateOpts
@@ -44,9 +42,7 @@ Let's stop the container now:
4442
4543@
4644stopNginxContainer :: ContainerID -> IO ()
47−stopNginxContainer cid = do
48− h <- defaultHttpHandler
49− runDockerT (defaultClientOpts, h) $ do
45+stopNginxContainer cid = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
5046 r <- stopContainer DefaultTimeout cid
5147 case r of
5248 Left err -> error "I failed to stop the container"
@@ -61,9 +57,7 @@ persist on the host file system.
6157
6258@
6359runPostgresContainer :: IO ContainerID
64−runPostgresContainer = do
65− h <- defaultHttpHandler
66− runDockerT (defaultClientOpts, h) $ do
60+runPostgresContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
6761 let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
6862 let myCreateOpts = addBinds [Bind "\/tmp" "\/tmp" Nothing] $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
6963 cid <- createContainer myCreateOpts
@@ -76,8 +70,7 @@ runPostgresContainer = do
7670
7771= Get Docker API Version
7872
79−>>> h <- defaultHttpHandler
80−>>> runDockerT (defaultClientOpts, h) $ getDockerVersion
73+>>> runDockerT (defaultClientOpts, defaultHttpHandler) $ getDockerVersion
8174Right (DockerVersion {version = "1.12.0", apiVersion = "1.24", gitCommit = "8eab29e", goVersion = "go1.6.3", os = "linux", arch = "amd64", kernelVersion = "4.6.0-1-amd64", buildTime = "2016-07-28T21:46:40.664812891+00:00"})
8275
8376= Setup SSL Authentication
src/Docker/Client/Api.hs+59−80
@@ -7,7 +7,6 @@ module Docker.Client.Api (
77 , createContainer
88 , startContainer
99 , stopContainer
10− , waitContainer
1110 , killContainer
1211 , restartContainer
1312 , pauseContainer
@@ -15,39 +14,33 @@ module Docker.Client.Api (
1514 , deleteContainer
1615 , inspectContainer
1716 , getContainerLogs
18− , getContainerLogsStream
1917 -- * Images
2018 , listImages
21− , deleteImage
2219 , buildImageFromDockerfile
23− , pullImage
24− -- * Network
25− , createNetwork
26− , removeNetwork
2720 -- * Other
2821 , getDockerVersion
2922 ) where
3023
31−import Control.Monad.Catch (MonadMask (..))
24+import Control.Monad.Catch (MonadMask(..))
3225import Control.Monad.IO.Class
3326import Control.Monad.Reader (ask, lift)
27+import Control.Monad.Trans.Resource
3428import Data.Aeson (FromJSON, eitherDecode')
3529import qualified Data.ByteString as BS
3630import qualified Data.ByteString.Lazy as BSL
37−import Data.Conduit (Sink)
31+import Data.Conduit (($$), Sink)
3832import qualified Data.Conduit.Binary as Conduit
39−import qualified Data.Text as T
4033import qualified Data.Text as Text
41−import Network.HTTP.Client (responseStatus)
34+import Network.HTTP.Client (responseBody, responseStatus)
35+import qualified Network.HTTP.Simple as NHS
4236import Network.HTTP.Types (StdMethod (..))
43−import System.Exit (ExitCode (..))
4437
4538import Docker.Client.Http
4639import Docker.Client.Types
4740import Docker.Client.Utils
4841
4942requestUnit :: (MonadIO m, MonadMask m) => HttpVerb -> Endpoint -> DockerT m (Either DockerError ())
50−requestUnit verb endpoint = fmap (const ()) <$> requestHelper verb endpoint
43+requestUnit verb endpoint = const (Right ()) <$> requestHelper verb endpoint
5144
5245requestHelper :: (MonadIO m, MonadMask m) => HttpVerb -> Endpoint -> DockerT m (Either DockerError BSL.ByteString)
5346requestHelper verb endpoint = requestHelper' verb endpoint Conduit.sinkLbs
@@ -59,16 +52,54 @@ requestHelper' verb endpoint sink = do
5952 Nothing ->
6053 return $ Left $ DockerInvalidRequest endpoint
6154 Just request -> do
62− -- JP: Do we need runResourceT?
63− -- lift $ NHS.httpSink request $ \response ->
64− lift $ httpHandler request $ \response ->
55+ -- response <- ExceptT $ lift $ httpHandler request $ const Conduit.sinkLbs
56+ -- TODO: Catch things XXX
57+
58+ -- TODO: Do we need runResourceT? XX
59+ -- lift $ NHS.httpSink request $ \response ->
60+ lift $ httpHandler request $ \response ->
6561 -- Check status code.
6662 let status = responseStatus response in
6763 case statusCodeToError endpoint status of
6864 Just err ->
6965 return $ Left err
7066 Nothing ->
71− fmap Right sink
67+ fmap Right sink -- $ Conduit.sinkLbs response
68+ -- return
69+
70+ -- lift $ runResourceT $ do
71+ -- NHS.httpSource request $$ \response -> do
72+
73+ -- -- Check status code.
74+ -- let status = responseStatus response
75+
76+ -- -- TODO
77+ -- maybe (return ()) throwError $
78+ -- statusCodeToError endpoint status
79+
80+ -- httpHandler response
81+ -- -- return response
82+
83+-- requestHelper :: (Monad m) => HttpVerb -> Endpoint -> DockerT m (Either DockerError Response)
84+-- requestHelper verb endpoint = runExceptT $ do
85+-- (opts, HttpHandler httpHandler) <- lift ask
86+-- case mkHttpRequest verb endpoint opts of
87+-- Nothing ->
88+-- throwError $ DockerInvalidRequest endpoint
89+-- Just request -> do
90+-- -- response <- ExceptT $ lift $ httpHandler request $ const Conduit.sinkLbs
91+-- lift $ runResourceT $ do
92+-- NHS.httpSource request $$ \response -> do
93+--
94+-- -- Check status code.
95+-- let status = responseStatus response
96+--
97+-- -- TODO
98+-- maybe (return ()) throwError $
99+-- statusCodeToError endpoint status
100+--
101+-- httpHandler response
102+-- -- return response
72103
73104parseResponse :: (FromJSON a, Monad m) => Either DockerError BSL.ByteString -> DockerT m (Either DockerError a)
74105parseResponse (Left err) =
@@ -94,12 +125,6 @@ listContainers opts = requestHelper GET (ListContainersEndpoint opts) >>= parseR
94125listImages :: forall m. (MonadIO m, MonadMask m) => ListOpts -> DockerT m (Either DockerError [Image])
95126listImages opts = requestHelper GET (ListImagesEndpoint opts) >>= parseResponse
96127
97−-- | Deletes an image with the given 'ImageID'.
98−-- See "ImageDeleteOpts" for options and use 'defaultImageDeleteOpts' for sane
99−-- defaults.
100−deleteImage :: forall m. (MonadIO m, MonadMask m) => ImageDeleteOpts -> ImageID -> DockerT m (Either DockerError ())
101−deleteImage dopts iid = requestUnit DELETE $ DeleteImageEndpoint dopts iid
102−
103128-- | Creates a docker container but does __not__ start it. See
104129-- 'CreateOpts' for a list of options and you can use 'defaultCreateOpts'
105130-- for some sane defaults.
@@ -119,14 +144,6 @@ startContainer sopts cid = requestUnit POST $ StartContainerEndpoint sopts cid
119144stopContainer :: forall m. (MonadIO m, MonadMask m) => Timeout -> ContainerID -> DockerT m (Either DockerError ())
120145stopContainer t cid = requestUnit POST $ StopContainerEndpoint t cid
121146
122−-- | Blocks until a container with the given 'ContainerID' stops,
123−-- then returns the exit code
124−waitContainer :: forall m. (MonadIO m, MonadMask m) => ContainerID -> DockerT m (Either DockerError ExitCode)
125−waitContainer cid = fmap (fmap statusCodeToExitCode) (requestHelper POST (WaitContainerEndpoint cid) >>= parseResponse)
126− where
127− statusCodeToExitCode (StatusCode 0) = ExitSuccess
128− statusCodeToExitCode (StatusCode x) = ExitFailure x
129−
130147-- | Sends a 'Signal' to the container with the given 'ContainerID'. Same
131148-- as 'stopContainer' but you choose the signal directly.
132149killContainer :: forall m. (MonadIO m, MonadMask m) => Signal -> ContainerID -> DockerT m (Either DockerError ())
@@ -145,9 +162,9 @@ unpauseContainer :: forall m. (MonadIO m, MonadMask m) => ContainerID -> DockerT
145162unpauseContainer cid = requestUnit GET $ UnpauseContainerEndpoint cid
146163
147164-- | Deletes a container with the given 'ContainerID'.
148−-- See "ContainerDeleteOpts" for options and use 'defaultContainerDeleteOpts' for sane
165+-- See "DeleteOpts" for options and use 'defaultDeleteOpts' for sane
149166-- defaults.
150−deleteContainer :: forall m. (MonadIO m, MonadMask m) => ContainerDeleteOpts -> ContainerID -> DockerT m (Either DockerError ())
167+deleteContainer :: forall m. (MonadIO m, MonadMask m) => DeleteOpts -> ContainerID -> DockerT m (Either DockerError ())
151168deleteContainer dopts cid = requestUnit DELETE $ DeleteContainerEndpoint dopts cid
152169
153170-- | Gets 'ContainerDetails' for a given 'ContainerID'.
@@ -161,67 +178,29 @@ inspectContainer cid = requestHelper GET (InspectContainerEndpoint cid) >>= pars
161178-- See 'LogOpts' for options that you can pass and
162179-- 'defaultLogOpts' for sane defaults.
163180--
164−-- __NOTE__: his function will fetch the entire log that the
181+-- __NOTE__: Currently streaming logs is
182+-- not supported and this function will fetch the entire log that the
165183-- container produced in the json-file on disk. Depending on the logging
166184-- setup of the process in your container this can be a significant amount
167185-- which might block your application...so use with caution.
168186--
169−-- If you want to stream the logs from the container continuosly then use
170−-- 'getContainerLogsStream'
171−--
172−-- __NOTE__: It's recommended to use one of the other 'LogDriverType's available (like
187+-- The recommended method is to use one of the other 'LogDriverType's available (like
173188-- syslog) for creating your containers.
174189getContainerLogs :: forall m. (MonadIO m, MonadMask m) => LogOpts -> ContainerID -> DockerT m (Either DockerError BSL.ByteString)
175190getContainerLogs logopts cid = requestHelper GET (ContainerLogsEndpoint logopts False cid)
176191
177−{-| Continuously gets the container's logs as a stream. Uses conduit.
192+-- TODO: Use http-conduit to output to a sink.
193+-- getContainerLogsStream :: forall m. Monad m => Sink BSL.ByteString m b -> LogOpts -> ContainerID -> DockerT m (Either DockerError b)
194+-- getContainerLogsStream sink logopts cid = runResourceT $ do
195+-- response <- http request manager
196+-- responseBody response C.$$+- sink
178197
179−__Example__:
180−
181−@
182−>>> import Docker.Client
183−>>> import Data.Maybe
184−>>> import Conduit
185−>>> h <- defaultHttpHanlder
186−>>> let cid = fromJust $ toContainerID "fee86e1d522b"
187−>>> runDockerT (defaultClientOpts, h) $ getContainerLogsStream defaultLogOpts cid stdoutC
188−@
189−
190−-}
191−getContainerLogsStream :: forall m b . (MonadIO m, MonadMask m) => LogOpts -> ContainerID -> Sink BS.ByteString m b -> DockerT m (Either DockerError b)
192−getContainerLogsStream logopts cid = requestHelper' GET (ContainerLogsEndpoint logopts True cid)
193−-- JP: Should the second (follow) argument be True? XXX
194−
195−-- | Build an Image from a Dockerfile
196−--
197198-- TODO: Add X-Registry-Config
198−--
199199-- TODO: Add support for remote URLs to a Dockerfile
200−--
201200-- TODO: Clean up temp tar.gz file after the image is built
202201buildImageFromDockerfile :: forall m. (MonadIO m, MonadMask m) => BuildOpts -> FilePath -> DockerT m (Either DockerError ())
203202buildImageFromDockerfile opts base = do
204203 ctx <- makeBuildContext $ BuildContextRootDir base
205204 case ctx of
206− Left e -> return $ Left e
205+ Left e -> return $ Left e
207206 Right c -> requestUnit POST (BuildImageEndpoint opts c)
208−
209−-- | Pulls an image from Docker Hub (by default).
210−--
211−-- TODO: Add support for X-Registry-Auth and pulling from private docker
212−-- registries.
213−--
214−-- TODO: Implement importImage function that uses he same
215−-- CreateImageEndpoint but rather than pulling from docker hub it imports
216−-- the image from a tarball or a URL.
217−pullImage :: forall m b . (MonadIO m, MonadMask m) => T.Text -> Tag -> Sink BS.ByteString m b -> DockerT m (Either DockerError b)
218−pullImage name tag = requestHelper' POST (CreateImageEndpoint name tag Nothing)
219−
220−-- | Creates network
221−createNetwork :: forall m. (MonadIO m, MonadMask m) => CreateNetworkOpts -> DockerT m (Either DockerError NetworkID)
222−createNetwork opts = requestHelper POST (CreateNetworkEndpoint opts) >>= parseResponse
223−
224−-- | Removes a network
225−removeNetwork :: forall m. (MonadIO m, MonadMask m) => NetworkID -> DockerT m (Either DockerError ())
226−removeNetwork nid = requestUnit DELETE $ RemoveNetworkEndpoint nid
227−
src/Docker/Client/Http.hs+37−72
@@ -1,14 +1,13 @@
11{-# LANGUAGE RankNTypes #-}
22{-# LANGUAGE ScopedTypeVariables #-}
3+{-# LANGUAGE TypeFamilies, UndecidableInstances #-}
34
45module Docker.Client.Http where
56
6−-- import Control.Monad.Base (MonadBase(..), liftBaseDefault)
7−import Control.Monad.Catch (MonadMask (..))
8−#if MIN_VERSION_http_conduit(2,3,0)
9−import Control.Monad.IO.Unlift (MonadUnliftIO)
10−#endif
11−import Control.Monad.Reader (ReaderT (..), runReaderT)
7+import Control.Monad.Base (MonadBase(..), liftBaseDefault)
8+import Control.Monad.Catch (MonadMask(..), MonadCatch(..), MonadThrow(..))
9+import Control.Monad.Reader (ReaderT(..), runReaderT)
10+import Control.Monad.Trans.Control (MonadBaseControl(..), ComposeSt, defaultLiftBaseWith, defaultRestoreM, MonadTransControl(..), defaultLiftWith, defaultRestoreT)
1211import qualified Data.ByteString.Char8 as BSC
1312import qualified Data.ByteString.Lazy as BL
1413import Data.Conduit (Sink)
@@ -18,15 +17,15 @@ import Data.Text.Encoding (encodeUtf8)
1817import Data.X509 (CertificateChain (..))
1918import Data.X509.CertificateStore (makeCertificateStore)
2019import Data.X509.File (readKeyFile, readSignedObject)
21−import Network.HTTP.Client (defaultManagerSettings,
20+import Network.HTTP.Client (defaultManagerSettings, httpLbs,
2221 managerRawConnection, method,
23− newManager, parseRequest,
22+ newManager, parseUrl,
2423 requestBody, requestHeaders)
2524import qualified Network.HTTP.Client as HTTP
2625import Network.HTTP.Client.Internal (makeConnection)
27−import qualified Network.HTTP.Simple as NHS
2826import Network.HTTP.Types (StdMethod, status101, status200,
2927 status201, status204)
28+import qualified Network.HTTP.Simple as NHS
3029import Network.TLS (ClientHooks (..),
3130 ClientParams (..), Shared (..),
3231 Supported (..),
@@ -34,7 +33,7 @@ import Network.TLS (ClientHooks (..),
3433import Network.TLS.Extra (ciphersuite_strong)
3534import System.X509 (getSystemCertificateStore)
3635
37−import Control.Monad.Catch (try)
36+import Control.Exception (try)
3837import Control.Monad.Except
3938import Control.Monad.Reader.Class
4039import Data.Text as T
@@ -48,19 +47,19 @@ import Docker.Client.Internal (getEndpoint,
4847 getEndpointContentType,
4948 getEndpointRequestBody)
5049import Docker.Client.Types (DockerClientOpts, Endpoint (..),
51− apiVer, baseUrl)
50+ baseUrl)
5251
5352type Request = HTTP.Request
5453type Response = HTTP.Response BL.ByteString
5554type HttpVerb = StdMethod
5655newtype HttpHandler m = HttpHandler (forall a . Request -> (HTTP.Response () -> Sink BSC.ByteString m (Either DockerError a)) -> m (Either DockerError a))
5756
58−data DockerError = DockerConnectionError NHS.HttpException
57+data DockerError = DockerConnectionError
5958 | DockerInvalidRequest Endpoint
6059 | DockerClientError Text
6160 | DockerClientDecodeError Text -- ^ Could not parse the response from the Docker endpoint.
6261 | DockerInvalidStatusCode HTTP.Status -- ^ Invalid exit code received from Docker endpoint.
63− | GenericDockerError Text deriving (Show, Typeable)
62+ | GenericDockerError Text deriving (Eq, Show, Typeable)
6463
6564newtype DockerT m a = DockerT {
6665 unDockerT :: Monad m => ReaderT (DockerClientOpts, HttpHandler m) m a
@@ -84,8 +83,8 @@ instance MonadTrans DockerT where
8483instance MonadIO m => MonadIO (DockerT m) where
8584 liftIO = lift . liftIO
8685
87−-- instance MonadBase IO m => MonadBase IO (DockerT m) where
88−-- liftBase = liftBaseDefault
86+instance MonadBase IO m => MonadBase IO (DockerT m) where
87+ liftBase = liftBaseDefault
8988
9089runDockerT :: Monad m => (DockerClientOpts, HttpHandler m) -> DockerT m a -> m a
9190runDockerT (opts, h) r = runReaderT (unDockerT r) (opts, h)
@@ -96,8 +95,8 @@ runDockerT (opts, h) r = runReaderT (unDockerT r) (opts, h)
9695-- benefit from testing that on all of our Endpoints
9796mkHttpRequest :: HttpVerb -> Endpoint -> DockerClientOpts -> Maybe Request
9897mkHttpRequest verb e opts = request
99− where fullE = T.unpack (baseUrl opts) ++ T.unpack (getEndpoint (apiVer opts) e)
100− initialR = parseRequest fullE
98+ where fullE = T.unpack (baseUrl opts) ++ T.unpack (getEndpoint e)
99+ initialR = parseUrl fullE
101100 request' = case initialR of
102101 Just ir ->
103102 return $ ir {method = (encodeUtf8 . T.pack $ show verb),
@@ -107,48 +106,38 @@ mkHttpRequest verb e opts = request
107106 requestHeaders = [("Content-Type", "application/json; charset=utf-8")]}) $ getEndpointRequestBody e) <$> request'
108107 -- Note: Do we need to set length header?
109108
110−defaultHttpHandler :: (
111−#if MIN_VERSION_http_conduit(2,3,0)
112− MonadUnliftIO m,
113−#endif
114− MonadIO m, MonadMask m) => m (HttpHandler m)
115−defaultHttpHandler = do
109+defaultHttpHandler :: MonadIO m => HttpHandler m
110+defaultHttpHandler = HttpHandler $ \request sink -> do
116111 manager <- liftIO $ newManager defaultManagerSettings
117− return $ httpHandler manager
112+ httpHandler manager request sink
118113
119−httpHandler :: (
120−#if MIN_VERSION_http_conduit(2,3,0)
121− MonadUnliftIO m,
122−#endif
123− MonadIO m, MonadMask m) => HTTP.Manager -> HttpHandler m
124−httpHandler manager = HttpHandler $ \request' sink -> do -- runResourceT ..
125− let request = NHS.setRequestManager manager request'
114+httpHandler = undefined
115+
116+{-
117+httpHandler :: MonadIO m => HTTP.Manager -> HttpHandler m
118+httpHandler manager request' sink = liftIO $ do -- runResourceT ..
126119 try (NHS.httpSink request sink) >>= \res -> case res of
127− Right res -> return res
128−#if MIN_VERSION_http_client(0,5,0)
129− Left e@(HTTP.HttpExceptionRequest _ HTTP.ConnectionFailure{}) -> return $ Left $ DockerConnectionError e
130−#else
131− Left e@HTTP.FailedConnectionException{} -> return $ Left $ DockerConnectionError e
132− Left e@HTTP.FailedConnectionException2{} -> return $ Left $ DockerConnectionError e
133−#endif
120+ Right res -> return $ Right res
121+ Left HTTP.FailedConnectionException{} -> return $ Left DockerConnectionError
122+ Left HTTP.FailedConnectionException2{} -> return $ Left DockerConnectionError
134123 Left e -> return $ Left $ GenericDockerError (T.pack $ show e)
135124
125+ where
126+ request = NHS.setRequestManager request'
127+-}
128+
136129-- | Connect to a unix domain socket (the default docker socket is
137130-- at \/var\/run\/docker.sock)
138131--
139132-- Docker seems to ignore the hostname in requests sent over unix domain
140133-- sockets (and the port obviously doesn't matter either)
141−unixHttpHandler :: (
142−#if MIN_VERSION_http_conduit(2,3,0)
143− MonadUnliftIO m,
144−#endif
145− MonadIO m, MonadMask m) => FilePath -- ^ The socket to connect to
146− -> m (HttpHandler m)
147−unixHttpHandler fp = do
134+unixHttpHandler :: MonadIO m => FilePath -- ^ The socket to connect to
135+ -> HttpHandler m
136+unixHttpHandler fp = HttpHandler $ \request sink -> do
148137 let mSettings = defaultManagerSettings
149138 { managerRawConnection = return $ openUnixSocket fp}
150139 manager <- liftIO $ newManager mSettings
151− return $ httpHandler manager
140+ httpHandler manager request sink
152141
153142 where
154143 openUnixSocket filePath _ _ _ = do
@@ -156,7 +145,7 @@ unixHttpHandler fp = do
156145 S.connect s (S.SockAddrUnix filePath)
157146 makeConnection (SBS.recv s 8096)
158147 (SBS.sendAll s)
159− (S.close s)
148+ (S.sClose s)
160149
161150-- TODO:
162151-- Move this to http-client-tls or network?
@@ -223,11 +212,6 @@ statusCodeToError (StopContainerEndpoint _ _) st =
223212 Nothing
224213 else
225214 Just $ DockerInvalidStatusCode st
226−statusCodeToError (WaitContainerEndpoint _) st =
227− if st == status200 then
228− Nothing
229− else
230− Just $ DockerInvalidStatusCode st
231215statusCodeToError (KillContainerEndpoint _ _) st =
232216 if st == status204 then
233217 Nothing
@@ -268,23 +252,4 @@ statusCodeToError (BuildImageEndpoint _ _) st =
268252 Nothing
269253 else
270254 Just $ DockerInvalidStatusCode st
271−statusCodeToError (CreateImageEndpoint _ _ _) st =
272− if st == status200 then
273− Nothing
274− else
275− Just $ DockerInvalidStatusCode st
276−statusCodeToError (DeleteImageEndpoint _ _) st =
277− if st == status200 then
278− Nothing
279− else
280− Just $ DockerInvalidStatusCode st
281−statusCodeToError (CreateNetworkEndpoint _) st =
282− if st == status201 then
283− Nothing
284− else
285− Just $ DockerInvalidStatusCode st
286−statusCodeToError (RemoveNetworkEndpoint _) st =
287− if st == status204 then
288− Nothing
289− else
290− Just $ DockerInvalidStatusCode st
255+
src/Docker/Client/Internal.hs+24−40
@@ -5,13 +5,12 @@ import qualified Data.Aeson as JSON
55import Data.ByteString (ByteString)
66import qualified Data.ByteString.Char8 as BSC
77import qualified Data.Conduit.Binary as CB
8−import qualified Data.Text as T
8+import Data.Text as T
99import Data.Text.Encoding (decodeUtf8, encodeUtf8)
1010import qualified Network.HTTP.Client as HTTP
1111import Network.HTTP.Conduit (requestBodySourceChunked)
1212import Network.HTTP.Types (Query, encodePath,
1313 encodePathSegments)
14−import Prelude hiding (all)
1514
1615import Docker.Client.Types
1716
@@ -25,44 +24,43 @@ encodeURLWithQuery ps q = decodeUtf8 $ toByteString $ encodePath ps q
2524encodeQ :: String -> ByteString
2625encodeQ = encodeUtf8 . T.pack
2726
28−getEndpoint :: ApiVersion -> Endpoint -> T.Text
29−getEndpoint v VersionEndpoint = encodeURL [v, "version"]
30−getEndpoint v (ListContainersEndpoint (ListOpts all)) = encodeURLWithQuery [v, "containers", "json"] [("all", Just (encodeQ $ show all))]
31−getEndpoint v (ListImagesEndpoint _) = encodeURL [v, "images", "json"] -- Make use of lsOpts here
32−getEndpoint v (CreateContainerEndpoint _ cn) = case cn of
33− Just cn -> encodeURLWithQuery [v, "containers", "create"] [("name", Just (encodeQ $ T.unpack cn))]
34− Nothing -> encodeURL [v, "containers", "create"]
35−getEndpoint v (StartContainerEndpoint startOpts cid) = encodeURLWithQuery [v, "containers", fromContainerID cid, "start"] query
27+getEndpoint :: Endpoint -> T.Text
28+getEndpoint VersionEndpoint = encodeURL ["version"]
29+getEndpoint (ListContainersEndpoint _) = encodeURL ["containers", "json"] -- Make use of lsOpts here
30+getEndpoint (ListImagesEndpoint _) = encodeURL ["images", "json"] -- Make use of lsOpts here
31+getEndpoint (CreateContainerEndpoint _ cn) = case cn of
32+ Just cn -> encodeURLWithQuery ["containers", "create"] [("name", Just (encodeQ $ T.unpack cn))]
33+ Nothing -> encodeURL ["containers", "create"]
34+getEndpoint (StartContainerEndpoint startOpts cid) = encodeURLWithQuery ["containers", fromContainerID cid, "start"] query
3635 where query = case (detachKeys startOpts) of
3736 WithCtrl c -> [("detachKeys", Just (encodeQ $ ctrl ++ [c]))]
3837 WithoutCtrl c -> [("detachKeys", Just (encodeQ [c]))]
3938 DefaultDetachKey -> []
4039 ctrl = ['c', 't', 'r', 'l', '-']
41−getEndpoint v (StopContainerEndpoint t cid) = encodeURLWithQuery [v, "containers", fromContainerID cid, "stop"] query
40+getEndpoint (StopContainerEndpoint t cid) = encodeURLWithQuery ["containers", fromContainerID cid, "stop"] query
4241 where query = case t of
43− Timeout x -> [("t", Just (encodeQ $ show x))]
42+ Timeout x -> [("t", Just (encodeQ $ show x))]
4443 DefaultTimeout -> []
45−getEndpoint v (WaitContainerEndpoint cid) = encodeURL [v, "containers", fromContainerID cid, "wait"]
46−getEndpoint v (KillContainerEndpoint s cid) = encodeURLWithQuery [v, "containers", fromContainerID cid, "kill"] query
44+getEndpoint (KillContainerEndpoint s cid) = encodeURLWithQuery ["containers", fromContainerID cid, "kill"] query
4745 where query = case s of
4846 SIG x -> [("signal", Just (encodeQ $ show x))]
49− _ -> [("signal", Just (encodeQ $ show s))]
50−getEndpoint v (RestartContainerEndpoint t cid) = encodeURLWithQuery [v, "containers", fromContainerID cid, "restart"] query
47+ _ -> [("signal", Just (encodeQ $ show s))]
48+getEndpoint (RestartContainerEndpoint t cid) = encodeURLWithQuery ["containers", fromContainerID cid, "restart"] query
5149 where query = case t of
52− Timeout x -> [("t", Just (encodeQ $ show x))]
50+ Timeout x -> [("t", Just (encodeQ $ show x))]
5351 DefaultTimeout -> []
54−getEndpoint v (PauseContainerEndpoint cid) = encodeURL [v, "containers", fromContainerID cid, "pause"]
55−getEndpoint v (UnpauseContainerEndpoint cid) = encodeURL [v, "containers", fromContainerID cid, "unpause"]
52+getEndpoint (PauseContainerEndpoint cid) = encodeURL ["containers", fromContainerID cid, "pause"]
53+getEndpoint (UnpauseContainerEndpoint cid) = encodeURL ["containers", fromContainerID cid, "unpause"]
5654-- Make use of since/timestamps/tail logopts here instead of ignoreing them
57−getEndpoint v (ContainerLogsEndpoint (LogOpts stdout stderr _ _ _) follow cid) =
58− encodeURLWithQuery [v, "containers", fromContainerID cid, "logs"] query
55+getEndpoint (ContainerLogsEndpoint (LogOpts stdout stderr _ _ _) follow cid) =
56+ encodeURLWithQuery ["containers", fromContainerID cid, "logs"] query
5957 where query = [("stdout", Just (encodeQ $ show stdout)), ("stderr", Just (encodeQ $ show stderr)), ("follow", Just (encodeQ $ show follow))]
60−getEndpoint v (DeleteContainerEndpoint (ContainerDeleteOpts removeVolumes force) cid) =
61− encodeURLWithQuery [v, "containers", fromContainerID cid] query
58+getEndpoint (DeleteContainerEndpoint (DeleteOpts removeVolumes force) cid) =
59+ encodeURLWithQuery ["containers", fromContainerID cid] query
6260 where query = [("v", Just (encodeQ $ show removeVolumes)), ("force", Just (encodeQ $ show force))]
63−getEndpoint v (InspectContainerEndpoint cid) =
64− encodeURLWithQuery [v, "containers", fromContainerID cid, "json"] []
65−getEndpoint v (BuildImageEndpoint o _) = encodeURLWithQuery [v, "build"] query
61+getEndpoint (InspectContainerEndpoint cid) =
62+ encodeURLWithQuery ["containers", fromContainerID cid, "json"] []
63+getEndpoint (BuildImageEndpoint o _) = encodeURLWithQuery ["build"] query
6664 where query = [("t", Just t), ("dockerfile", Just dockerfile), ("q", Just q), ("nocache", Just nocache), ("rm", Just rm), ("forcerm", Just forcerm), ("pull", Just pull)]
6765 t = encodeQ $ T.unpack $ buildImageName o
6866 dockerfile = encodeQ $ T.unpack $ buildDockerfileName o
@@ -71,13 +69,6 @@ getEndpoint v (BuildImageEndpoint o _) = encodeURLWithQuery [v, "build"] query
7169 rm = encodeQ $ show $ buildRemoveItermediate o
7270 forcerm = encodeQ $ show $ buildForceRemoveIntermediate o
7371 pull = encodeQ $ show $ buildPullParent o
74−getEndpoint v (CreateImageEndpoint name tag _) = encodeURLWithQuery [v, "images", "create"] query
75− where query = [("fromImage", Just n), ("tag", Just t)]
76− n = encodeQ $ T.unpack name
77− t = encodeQ $ T.unpack tag
78−getEndpoint v (DeleteImageEndpoint _ cid) = encodeURL [v, "images", fromImageID cid]
79−getEndpoint v (CreateNetworkEndpoint _) = encodeURL [v, "networks", "create"]
80−getEndpoint v (RemoveNetworkEndpoint nid) = encodeURL [v, "networks", fromNetworkID nid]
8172
8273getEndpointRequestBody :: Endpoint -> Maybe HTTP.RequestBody
8374getEndpointRequestBody VersionEndpoint = Nothing
@@ -86,7 +77,6 @@ getEndpointRequestBody (ListImagesEndpoint _) = Nothing
8677getEndpointRequestBody (CreateContainerEndpoint opts _) = Just $ HTTP.RequestBodyLBS (JSON.encode opts)
8778getEndpointRequestBody (StartContainerEndpoint _ _) = Nothing
8879getEndpointRequestBody (StopContainerEndpoint _ _) = Nothing
89−getEndpointRequestBody (WaitContainerEndpoint _) = Nothing
9080getEndpointRequestBody (KillContainerEndpoint _ _) = Nothing
9181getEndpointRequestBody (RestartContainerEndpoint _ _) = Nothing
9282getEndpointRequestBody (PauseContainerEndpoint _) = Nothing
@@ -94,13 +84,7 @@ getEndpointRequestBody (UnpauseContainerEndpoint _) = Nothing
9484getEndpointRequestBody (ContainerLogsEndpoint _ _ _) = Nothing
9585getEndpointRequestBody (DeleteContainerEndpoint _ _) = Nothing
9686getEndpointRequestBody (InspectContainerEndpoint _) = Nothing
97−
9887getEndpointRequestBody (BuildImageEndpoint _ fp) = Just $ requestBodySourceChunked $ CB.sourceFile fp
99−getEndpointRequestBody (CreateImageEndpoint _ _ _) = Nothing
100−getEndpointRequestBody (DeleteImageEndpoint _ _) = Nothing
101−
102−getEndpointRequestBody (CreateNetworkEndpoint opts) = Just $ HTTP.RequestBodyLBS (JSON.encode opts)
103−getEndpointRequestBody (RemoveNetworkEndpoint _) = Nothing
10488
10589getEndpointContentType :: Endpoint -> BSC.ByteString
10690getEndpointContentType (BuildImageEndpoint _ _) = BSC.pack "application/tar"
src/Docker/Client/Types.hs+89−233
@@ -11,11 +11,7 @@ module Docker.Client.Types (
1111 , ImageID
1212 , fromImageID
1313 , toImageID
14− , NetworkID
15− , fromNetworkID
16− , toNetworkID
1714 , Timeout(..)
18− , StatusCode(..)
1915 , Signal(..)
2016 , ContainerDetails(..)
2117 , DockerClientOpts(..)
@@ -26,12 +22,11 @@ module Docker.Client.Types (
2622 , ContainerPortInfo(..)
2723 , Container(..)
2824 , ContainerState(..)
29− , State(..)
25+ , Status(..)
3026 , Digest
3127 , Label(..)
3228 , Tag
3329 , Image(..)
34− , Entrypoint(..)
3530 , dropImagePrefix
3631 , CreateOpts(..)
3732 , BuildOpts(..)
@@ -40,16 +35,12 @@ module Docker.Client.Types (
4035 , DetachKeys(..)
4136 , StartOpts(..)
4237 , defaultStartOpts
43− , ContainerDeleteOpts(..)
44− , defaultContainerDeleteOpts
45− , ImageDeleteOpts(..)
46− , defaultImageDeleteOpts
38+ , DeleteOpts(..)
39+ , defaultDeleteOpts
4740 , Timestamp
4841 , TailLogOpt(..)
4942 , LogOpts(..)
5043 , defaultLogOpts
51− , CreateNetworkOpts(..)
52− , defaultCreateNetworkOpts
5344 , VolumePermission(..)
5445 , Bind(..)
5546 , Volume(..)
@@ -75,8 +66,6 @@ module Docker.Client.Types (
7566 , UTSMode(..)
7667 , HostConfig(..)
7768 , defaultHostConfig
78− , NetworkingConfig(..)
79− , EndpointConfig(..)
8069 , Ulimit(..)
8170 , ContainerResources(..)
8271 , defaultContainerResources
@@ -96,8 +85,6 @@ module Docker.Client.Types (
9685 , addLink
9786 , addVolume
9887 , addVolumeFrom
99− , MemoryConstraint(..)
100− , MemoryConstraintSize(..)
10188 ) where
10289
10390import Data.Aeson (FromJSON, ToJSON, genericParseJSON,
@@ -112,7 +99,6 @@ import Data.Scientific (floatingOrInteger)
11299import Data.Text (Text)
113100import qualified Data.Text as T
114101import Data.Time.Clock (UTCTime)
115−import qualified Data.Vector as V
116102import GHC.Generics (Generic)
117103import Prelude hiding (all, tail)
118104import Text.Read (readMaybe)
@@ -125,20 +111,15 @@ data Endpoint =
125111 | CreateContainerEndpoint CreateOpts (Maybe ContainerName)
126112 | StartContainerEndpoint StartOpts ContainerID
127113 | StopContainerEndpoint Timeout ContainerID
128− | WaitContainerEndpoint ContainerID
129114 | KillContainerEndpoint Signal ContainerID
130115 | RestartContainerEndpoint Timeout ContainerID
131116 | PauseContainerEndpoint ContainerID
132117 | UnpauseContainerEndpoint ContainerID
133118 | ContainerLogsEndpoint LogOpts Bool ContainerID -- ^ Second argument (Bool) is whether to follow which is currently hardcoded to False.
134119 -- See note in 'Docker.Client.Api.getContainerLogs' for explanation why.
135− | DeleteContainerEndpoint ContainerDeleteOpts ContainerID
120+ | DeleteContainerEndpoint DeleteOpts ContainerID
136121 | InspectContainerEndpoint ContainerID
137122 | BuildImageEndpoint BuildOpts FilePath
138− | CreateImageEndpoint T.Text Tag (Maybe T.Text) -- ^ Either pull an image from docker hub or imports an image from a tarball (or URL)
139− | DeleteImageEndpoint ImageDeleteOpts ImageID
140− | CreateNetworkEndpoint CreateNetworkOpts
141− | RemoveNetworkEndpoint NetworkID
142123 deriving (Eq, Show)
143124
144125-- | We should newtype this
@@ -185,20 +166,6 @@ toImageID t =
185166-- | Timeout used for stopping a container. DefaultTimeout is 10 seconds.
186167data Timeout = Timeout Integer | DefaultTimeout deriving (Eq, Show)
187168
188−data StatusCode = StatusCode Int
189−
190−instance ToJSON StatusCode where
191− toJSON (StatusCode c) = object ["StatusCode" .= c]
192−
193−instance FromJSON StatusCode where
194− parseJSON (JSON.Object o) = do
195− c <- o .: "StatusCode"
196− if c >= 0 && c <= 255 then
197− return (StatusCode c)
198− else
199− fail "Unknown exit code"
200− parseJSON _ = fail "Unknown exit code"
201−
202169-- TODO: Add more Signals or use an existing lib
203170-- | Signal used for sending to the process running in the container.
204171-- The default signal is SIGTERM.
@@ -213,16 +180,16 @@ data Signal = SIGHUP
213180
214181instance FromJSON Signal where
215182 parseJSON (JSON.String "SIGTERM") = return SIGTERM
216− parseJSON (JSON.String "SIGHUP") = return SIGHUP -- Note: Guessing on the string values for these.
217− parseJSON (JSON.String "SIGINT") = return SIGINT
183+ parseJSON (JSON.String "SIGHUP") = return SIGHUP -- Note: Guessing on the string values for these.
184+ parseJSON (JSON.String "SIGINT") = return SIGINT
218185 parseJSON (JSON.String "SIGQUIT") = return SIGQUIT
219186 parseJSON (JSON.String "SIGSTOP") = return SIGSTOP
220187 parseJSON (JSON.String "SIGUSR1") = return SIGUSR1
221− parseJSON _ = fail "Unknown Signal"
188+ parseJSON _ = fail "Unknown Signal"
222189
223190instance ToJSON Signal where
224− toJSON SIGHUP = "SIGHUP"
225− toJSON SIGINT = "SIGINT"
191+ toJSON SIGHUP = "SIGHUP"
192+ toJSON SIGINT = "SIGINT"
226193 toJSON SIGQUIT = "SIGQUIT"
227194 toJSON SIGSTOP = "SIGSTOP"
228195 toJSON SIGTERM = "SIGTERM"
@@ -250,7 +217,7 @@ data ContainerDetails = ContainerDetails {
250217 , processLabel :: Text
251218 , resolveConfPath :: FilePath
252219 , restartCount :: Int
253− , containerDetailsState :: ContainerState
220+ , state :: ContainerState
254221 , mounts :: [Mount]
255222 }
256223 deriving (Eq, Show, Generic)
@@ -258,11 +225,11 @@ data ContainerDetails = ContainerDetails {
258225-- | Data type used for parsing the mount information from a container
259226-- list.
260227data Mount = Mount {
261− mountName :: Maybe Text -- this is optional
228+ mountName :: Text
262229 , mountSource :: FilePath
263230 , mountDestination :: FilePath
264− , mountDriver :: Maybe Text
265− -- , mountMode :: Maybe VolumePermission -- apparently this can be null
231+ , mountDriver :: Text
232+ , mountMode :: Maybe VolumePermission -- apparently this can be null
266233 , mountRW :: Bool
267234 , mountPropogation :: Text
268235 }
@@ -270,14 +237,14 @@ data Mount = Mount {
270237
271238instance FromJSON Mount where
272239 parseJSON (JSON.Object o) = do
273− name <- o .:? "Name"
240+ name <- o .: "Name"
274241 src <- o .: "Source"
275242 dest <- o .: "Destination"
276− driver <- o .:? "Driver"
277− -- mode <- o .: "Mode"
243+ driver <- o .: "Driver"
244+ mode <- o .: "Mode"
278245 rw <- o .: "RW"
279246 prop <- o .: "Propagation"
280− return $ Mount name src dest driver rw prop
247+ return $ Mount name src dest driver mode rw prop
281248 parseJSON _ = fail "Mount is not an object"
282249
283250-- | Data type used for parsing the container state from a list of
@@ -293,7 +260,7 @@ data ContainerState = ContainerState {
293260 , restarting :: Bool
294261 , running :: Bool
295262 , startedAt :: UTCTime
296− , state :: State
263+ , status :: Status
297264 }
298265 deriving (Eq, Show, Generic)
299266
@@ -523,8 +490,7 @@ data Container = Container
523490 , containerImageId :: ImageID
524491 , containerCommand :: Text
525492 , containerCreatedAt :: Int
526− , containerState :: State
527− , containerStatus :: Maybe Text
493+ , containerStatus :: Status
528494 , containerPorts :: [ContainerPortInfo]
529495 , containerLabels :: [Label]
530496 , containerNetworks :: [Network]
@@ -532,14 +498,13 @@ data Container = Container
532498 } deriving (Show, Eq)
533499
534500instance FromJSON Container where
535− parseJSON o@(JSON.Object v) =
536− Container <$> parseJSON o
501+ parseJSON (JSON.Object v) =
502+ Container <$> (v .: "Id")
537503 <*> (v .: "Names")
538504 <*> (v .: "Image")
539− <*> (v .: "ImageID") -- Doesn't exist anymore
540− <*> (v .: "Command") -- Doesn't exist anymore
505+ <*> (v .: "ImageID")
506+ <*> (v .: "Command")
541507 <*> (v .: "Created")
542− <*> (v .: "State")
543508 <*> (v .: "Status")
544509 <*> (v .: "Ports")
545510 <*> (v .: "Labels")
@@ -549,20 +514,21 @@ instance FromJSON Container where
549514 parseNetworks (JSON.Object v) =
550515 (v .: "Networks") >>= parseJSON
551516 parseNetworks _ = fail "Container NetworkSettings: Not a JSON object."
517+
552518 parseJSON _ = fail "Container: Not a JSON object."
553519
554−-- | Represents the state of the container life cycle.
555−data State = Created | Restarting | Running | Paused | Exited | Dead
520+-- | Represents the status of the container life cycle.
521+data Status = Created | Restarting | Running | Paused | Exited | Dead
556522 deriving (Eq, Show, Generic)
557523
558−instance FromJSON State where
559− parseJSON (JSON.String "running") = return Running
560− parseJSON (JSON.String "created") = return Created -- Note: Guessing on the string values of these.
524+instance FromJSON Status where
525+ parseJSON (JSON.String "running") = return Running
526+ parseJSON (JSON.String "created") = return Created -- Note: Guessing on the string values of these.
561527 parseJSON (JSON.String "restarting") = return Restarting
562− parseJSON (JSON.String "paused") = return Paused
563− parseJSON (JSON.String "exited") = return Exited
564− parseJSON (JSON.String "dead") = return Dead
565− parseJSON s = fail $ "Unknown Status: " ++ show s
528+ parseJSON (JSON.String "paused") = return Paused
529+ parseJSON (JSON.String "exited") = return Exited
530+ parseJSON (JSON.String "dead") = return Dead
531+ parseJSON _ = fail "Unknown Status"
566532
567533-- | Alias for representing a RepoDigest. We could newtype this and add
568534-- some validation.
@@ -623,46 +589,20 @@ instance FromJSON Image where
623589 return $ DockerImage imageId imageCreated imageParentId imageRepoTags imageRepoDigests imageSize imageVirtualSize imageLabels
624590 parseJSON _ = fail "Failed to parse DockerImage."
625591
626−-- | Alias for Aliases.
627−type Alias = Text
628−
629−-- | EndpointsConfig is container configuration for a specific network
630−newtype EndpointConfig = EndpointConfig [Alias] deriving (Eq, Show)
631−
632−instance ToJSON EndpointConfig where
633− toJSON (EndpointConfig aliases) = JSON.object
634− [ "Aliases" .= aliases
635− ]
636−
637−-- | Alias for endpoint name
638−type EndpointName = Text
639−
640−-- | Data type for the NetworkingConfig section of the container settings
641−newtype NetworkingConfig = NetworkingConfig
642− { endpointsConfig :: HM.HashMap EndpointName EndpointConfig
643− } deriving (Eq, Show)
644−
645−instance ToJSON NetworkingConfig where
646− toJSON (NetworkingConfig endpointsConfig) = JSON.object
647− [ "EndpointsConfig" .= endpointsConfig
648− ]
649592
650593-- | Options used for creating a Container.
651594data CreateOpts = CreateOpts {
652− containerConfig :: ContainerConfig
653− , hostConfig :: HostConfig
654− , networkingConfig :: NetworkingConfig
595+ containerConfig :: ContainerConfig
596+ , hostConfig :: HostConfig
655597 } deriving (Eq, Show)
656598
657599instance ToJSON CreateOpts where
658− toJSON (CreateOpts cc hc nc) = do
600+ toJSON (CreateOpts cc hc) = do
659601 let ccJSON = toJSON cc
660602 let hcJSON = toJSON hc
661603 case ccJSON of
662604 JSON.Object (o :: HM.HashMap T.Text JSON.Value) -> do
663− let o1 = HM.insert "HostConfig" hcJSON o
664− let o2 = HM.insert "NetworkingConfig" (toJSON nc) o1
665− JSON.Object o2
605+ JSON.Object $ HM.insert "HostConfig" hcJSON o
666606 _ -> error "ContainerConfig is not an object." -- This should never happen.
667607
668608-- | Container configuration used for creating a container with sensible
@@ -684,7 +624,7 @@ defaultContainerConfig imageName = ContainerConfig {
684624 , cmd=[]
685625 , volumes=[]
686626 , workingDir=Nothing
687− , entrypoint=Entrypoint []
627+ , entrypoint=Nothing
688628 , networkDisabled=Nothing
689629 , macAddress=Nothing
690630 , labels=[]
@@ -697,7 +637,7 @@ defaultHostConfig = HostConfig {
697637 binds=[]
698638 , containerIDFile=Nothing
699639 , logConfig=LogDriverConfig JsonFile []
700− , networkMode=NetworkBridge
640+ , networkMode=Bridge
701641 , portBindings=[]
702642 , restartPolicy=RestartOff
703643 , volumeDriver=Nothing
@@ -737,18 +677,14 @@ defaultContainerResources = ContainerResources {
737677 , memory=Nothing
738678 , memoryReservation=Nothing
739679 , memorySwap=Nothing
740− , oomKillDisable=Just False
680+ , oomKillDisable=False
741681 , ulimits=[]
742682 }
743683
744684-- | Default create options when creating a container. You only need to
745685-- specify an image name and the rest is all sensible defaults.
746686defaultCreateOpts :: T.Text -> CreateOpts
747−defaultCreateOpts imageName = CreateOpts
748− { containerConfig = defaultContainerConfig imageName
749− , hostConfig = defaultHostConfig
750− , networkingConfig = NetworkingConfig HM.empty
751− }
687+defaultCreateOpts imageName = CreateOpts { containerConfig = defaultContainerConfig imageName, hostConfig = defaultHostConfig }
752688
753689-- | Override the key sequence for detaching a container.
754690-- Format is a single character [a-Z] or ctrl-<value> where <value> is one of: a-z, @, ^, [, , or _.
@@ -762,7 +698,7 @@ defaultStartOpts :: StartOpts
762698defaultStartOpts = StartOpts { detachKeys = DefaultDetachKey }
763699
764700-- | Options for deleting a container.
765−data ContainerDeleteOpts = ContainerDeleteOpts {
701+data DeleteOpts = DeleteOpts {
766702 deleteVolumes :: Bool -- ^ Automatically cleanup volumes that the container created as well.
767703 , force :: Bool -- ^ If the container is still running force deletion anyway.
768704 } deriving (Eq, Show)
@@ -792,15 +728,8 @@ defaultBuildOpts nameTag = BuildOpts { buildImageName = nameTag
792728-- | Default options for deleting a container. Most of the time we DON'T
793729-- want to delete the container's volumes or force delete it if it's
794730-- running.
795−defaultContainerDeleteOpts :: ContainerDeleteOpts
796−defaultContainerDeleteOpts = ContainerDeleteOpts { deleteVolumes = False, force = False }
797−
798−-- | Image delete opts
799−data ImageDeleteOpts = ImageDeleteOpts deriving (Eq, Show)
800−
801−-- | Sane image deletion defaults
802−defaultImageDeleteOpts :: ImageDeleteOpts
803−defaultImageDeleteOpts = ImageDeleteOpts
731+defaultDeleteOpts :: DeleteOpts
732+defaultDeleteOpts = DeleteOpts { deleteVolumes = False, force = False }
804733
805734-- | Timestamp alias.
806735type Timestamp = Integer
@@ -828,50 +757,18 @@ defaultLogOpts = LogOpts { stdout = True
828757 , tail = All
829758 }
830759
831−-- | Options for creating a network
832−data CreateNetworkOpts = CreateNetworkOpts
833− { createNetworkName :: Text -- ^ The network's name
834− , createNetworkCheckDuplicate :: Bool -- ^ Check for networks with duplicate names.
835− , createNetworkDriver :: Text -- ^ Name of the network driver plugin to use.
836− , createNetworkInternal :: Bool -- ^ Restrict external access to the network.
837− , createNetworkEnableIPv6 :: Bool -- ^ Enable IPv6 on the network.
838− } deriving (Eq, Show)
839−
840−-- | Sensible defalut for create network options
841−defaultCreateNetworkOpts :: Text -> CreateNetworkOpts
842−defaultCreateNetworkOpts name =
843− CreateNetworkOpts
844− { createNetworkName = name
845− , createNetworkCheckDuplicate = False
846− , createNetworkDriver = "bridge"
847− , createNetworkInternal = True
848− , createNetworkEnableIPv6 = False
849− }
850−
851−instance ToJSON CreateNetworkOpts where
852− toJSON opts =
853− object
854− [ "Name" .= createNetworkName opts
855− , "CheckDuplicate" .= createNetworkCheckDuplicate opts
856− , "Driver" .= createNetworkDriver opts
857− , "Internal" .= createNetworkInternal opts
858− , "EnableIPv6" .= createNetworkEnableIPv6 opts
859− ]
860−
861760-- TOOD: Add support for SELinux Volume labels (eg. "ro,z" or "ro/Z")
862761-- | Set permissions on volumes that you mount in the container.
863762data VolumePermission = ReadWrite | ReadOnly deriving (Eq, Show, Generic)
864763
865764instance ToJSON VolumePermission where
866765 toJSON ReadWrite = "rw"
867− toJSON ReadOnly = "ro"
766+ toJSON ReadOnly = "ro"
868767
869768instance FromJSON VolumePermission where
870769 parseJSON "rw" = return ReadWrite
871770 parseJSON "ro" = return ReadOnly
872− parseJSON "RW" = return ReadWrite
873− parseJSON "RO" = return ReadOnly
874− parseJSON _ = fail "Failed to parse VolumePermission"
771+ parseJSON _ = fail "Failed to parse VolumePermission"
875772
876773-- | Used for marking a directory in the container as "exposed" hence
877774-- taking it outside of the COW filesystem and making it mountable
@@ -893,8 +790,8 @@ instance {-# OVERLAPPING #-} ToJSON [Volume] where
893790
894791instance {-# OVERLAPPING #-} FromJSON [Volume] where
895792 parseJSON (JSON.Object o) = return $ map (Volume . T.unpack) $ HM.keys o
896− parseJSON (JSON.Null) = return []
897− parseJSON _ = fail "Volume is not an object"
793+ parseJSON (JSON.Null) = return []
794+ parseJSON _ = fail "Volume is not an object"
898795
899796
900797data Bind = Bind { hostSrc :: Text
@@ -904,10 +801,10 @@ data Bind = Bind { hostSrc :: Text
904801
905802instance FromJSON Bind where
906803 parseJSON (JSON.String t) = case T.split (== ':') t of
907− [src, dest] -> return $ Bind src dest Nothing
804+ [src, dest] -> return $ Bind src dest Nothing
908805 [src, dest, "rw"] -> return $ Bind src dest $ Just ReadWrite
909806 [src, dest, "ro"] -> return $ Bind src dest $ Just ReadOnly
910− _ -> fail "Could not parse Bind"
807+ _ -> fail "Could not parse Bind"
911808 parseJSON _ = fail "Bind is not a string"
912809
913810data Device = Device {
@@ -930,15 +827,15 @@ data VolumeFrom = VolumeFrom ContainerName (Maybe VolumePermission) deriving (Eq
930827
931828instance FromJSON VolumeFrom where
932829 parseJSON (JSON.String t) = case T.split (== ':') t of
933− [vol] -> return $ VolumeFrom vol Nothing
830+ [vol] -> return $ VolumeFrom vol Nothing
934831 [vol, "rw"] -> return $ VolumeFrom vol $ Just ReadWrite
935832 [vol, "ro"] -> return $ VolumeFrom vol $ Just ReadOnly
936− _ -> fail "Could not parse VolumeFrom"
833+ _ -> fail "Could not parse VolumeFrom"
937834 parseJSON _ = fail "VolumeFrom is not a string"
938835
939836instance ToJSON VolumeFrom where
940837 toJSON (VolumeFrom n p) = case p of
941− Nothing -> toJSON $ n <> ":" <> "rw"
838+ Nothing -> toJSON $ n <> ":" <> "rw"
942839 Just per -> toJSON $ n <> ":" <> (T.pack $ show per)
943840
944841instance ToJSON Bind where
@@ -950,40 +847,40 @@ data Link = Link Text (Maybe Text) deriving (Eq, Show)
950847
951848instance FromJSON Link where
952849 parseJSON (JSON.String t) = case T.split (== ':') t of
953− [f] -> return $ Link f Nothing
850+ [f] -> return $ Link f Nothing
954851 [f,s] -> return $ Link f $ Just s
955− _ -> fail "Could not parse Link"
852+ _ -> fail "Could not parse Link"
956853 parseJSON _ = fail "Link is not a string"
957854
958855instance ToJSON Link where
959856 toJSON (Link n1 n2) = toJSON $ case n2 of
960857 Nothing -> T.concat[n1, ":", n1] -- use same name in container
961− Just n -> T.concat[n1, ":", n] -- used specified name in container
858+ Just n -> T.concat[n1, ":", n] -- used specified name in container
962859
963860-- { "Type": "<driver_name>", "Config": {"key1": "val1"} }
964861data LogDriverType = JsonFile | Syslog | Journald | Gelf | Fluentd | AwsLogs | Splunk | Etwlogs | LoggingDisabled deriving (Eq, Show)
965862
966863instance FromJSON LogDriverType where
967864 parseJSON (JSON.String "json-file") = return JsonFile
968− parseJSON (JSON.String "syslog") = return Syslog
969− parseJSON (JSON.String "journald") = return Journald
970− parseJSON (JSON.String "gelf") = return Gelf
971− parseJSON (JSON.String "fluentd") = return Fluentd
972− parseJSON (JSON.String "awslogs") = return AwsLogs
973− parseJSON (JSON.String "splunk") = return Splunk
974− parseJSON (JSON.String "etwlogs") = return Etwlogs
975− parseJSON (JSON.String "none") = return LoggingDisabled
976− parseJSON _ = fail "Unknown LogDriverType"
865+ parseJSON (JSON.String "syslog") = return Syslog
866+ parseJSON (JSON.String "journald") = return Journald
867+ parseJSON (JSON.String "gelf") = return Gelf
868+ parseJSON (JSON.String "fluentd") = return Fluentd
869+ parseJSON (JSON.String "awslogs") = return AwsLogs
870+ parseJSON (JSON.String "splunk") = return Splunk
871+ parseJSON (JSON.String "etwlogs") = return Etwlogs
872+ parseJSON (JSON.String "none") = return LoggingDisabled
873+ parseJSON _ = fail "Unknown LogDriverType"
977874
978875instance ToJSON LogDriverType where
979− toJSON JsonFile = JSON.String "json-file"
980− toJSON Syslog = JSON.String "syslog"
981− toJSON Journald = JSON.String "journald"
982− toJSON Gelf = JSON.String "gelf"
983− toJSON Fluentd = JSON.String "fluentd"
984− toJSON AwsLogs = JSON.String "awslogs"
985− toJSON Splunk = JSON.String "splunk"
986− toJSON Etwlogs = JSON.String "etwlogs"
876+ toJSON JsonFile = JSON.String "json-file"
877+ toJSON Syslog = JSON.String "syslog"
878+ toJSON Journald = JSON.String "journald"
879+ toJSON Gelf = JSON.String "gelf"
880+ toJSON Fluentd = JSON.String "fluentd"
881+ toJSON AwsLogs = JSON.String "awslogs"
882+ toJSON Splunk = JSON.String "splunk"
883+ toJSON Etwlogs = JSON.String "etwlogs"
987884 toJSON LoggingDisabled = JSON.String "none"
988885
989886data LogDriverOption = LogDriverOption Name Value deriving (Eq, Show)
@@ -1017,41 +914,19 @@ instance FromJSON LogDriverConfig where
1017914 parseJSON _ = fail "LogDriverConfig is not an object"
1018915
1019916-- TODO: Add container:<name|id> mode
1020−data NetworkMode = NetworkBridge | NetworkHost | NetworkDisabled | NetworkNamed Text
917+data NetworkMode = Bridge | Host | NetworkDisabled
1021918 deriving (Eq, Show, Ord)
1022919
1023920instance FromJSON NetworkMode where
1024− parseJSON (JSON.String "bridge") = return NetworkBridge
1025− parseJSON (JSON.String "host") = return NetworkHost -- Note: Guessing on these.
1026− parseJSON (JSON.String "none") = return NetworkDisabled
1027− parseJSON (JSON.String n) = return $ NetworkNamed n
1028− parseJSON _ = fail "Unknown NetworkMode"
921+ parseJSON (JSON.String "bridge") = return Bridge
922+ parseJSON (JSON.String "host") = return Host -- Note: Guessing on these.
923+ parseJSON (JSON.String "none") = return NetworkDisabled
924+ parseJSON _ = fail "Unknown NetworkMode"
1029925
1030926instance ToJSON NetworkMode where
1031− toJSON NetworkBridge = JSON.String "bridge"
1032− toJSON NetworkHost = JSON.String "host"
927+ toJSON Bridge = JSON.String "bridge"
928+ toJSON Host = JSON.String "host"
1033929 toJSON NetworkDisabled = JSON.String "none"
1034− toJSON (NetworkNamed n) = JSON.String n
1035−
1036−newtype NetworkID = NetworkID Text
1037− deriving (Eq, Show)
1038−
1039−-- | Used for extracting the id of the container from the newtype
1040−fromNetworkID :: NetworkID -> Text
1041−fromNetworkID (NetworkID t) = t
1042−
1043−-- | Used for parsing a Text value into a NetworkID.
1044−toNetworkID :: Text -> Maybe NetworkID
1045−toNetworkID t = Just $ NetworkID t
1046−
1047−instance FromJSON NetworkID where
1048− parseJSON (JSON.Object o) = do
1049− nid <- o .: "Id"
1050− return $ NetworkID nid
1051− parseJSON _ = fail "NetworkID is not an object."
1052−
1053−instance ToJSON NetworkID where
1054− toJSON (NetworkID nid) = object ["Id" .= nid]
1055930
1056931data PortType = TCP | UDP deriving (Eq, Generic, Read, Ord)
1057932
@@ -1067,7 +942,7 @@ instance FromJSON PortType where
1067942 parseJSON val = case val of
1068943 "tcp" -> return TCP
1069944 "udp" -> return UDP
1070− _ -> fail "PortType: Invalid port type."
945+ _ -> fail "PortType: Invalid port type."
1071946
1072947-- newtype NetworkInterface = NetworkInterface Text deriving (Eq, Show)
1073948--
@@ -1197,7 +1072,7 @@ instance FromJSON RestartPolicy where
11971072 "on-failure" -> do
11981073 retry <- o .: "MaximumRetryCount"
11991074 return $ RestartOnFailure retry
1200− "no" -> return RestartOff
1075+ "off" -> return RestartOff
12011076 _ -> fail "Could not parse RestartPolicy"
12021077 parseJSON _ = fail "RestartPolicy is not an object"
12031078
@@ -1205,7 +1080,7 @@ instance ToJSON RestartPolicy where
12051080 toJSON RestartAlways = object ["Name" .= JSON.String "always"]
12061081 toJSON RestartUnlessStopped = object ["Name" .= JSON.String "unless-stopped"]
12071082 toJSON (RestartOnFailure c) = object ["Name" .= JSON.String "on-failure", "MaximumRetryCount" .= c]
1208− toJSON RestartOff = object ["Name" .= JSON.String "no"]
1083+ toJSON RestartOff = object ["Name" .= JSON.String "off"]
12091084
12101085data Isolation = Default | Process | Hyperv deriving (Eq, Show)
12111086
@@ -1383,7 +1258,7 @@ data MemoryConstraintSize = B | MB | GB deriving (Eq, Show)
13831258data MemoryConstraint = MemoryConstraint Integer MemoryConstraintSize deriving (Eq, Show)
13841259
13851260instance ToJSON MemoryConstraint where
1386− toJSON (MemoryConstraint x B) = toJSON x
1261+ toJSON (MemoryConstraint x B) = toJSON x
13871262 toJSON (MemoryConstraint x MB) = toJSON $ x * 1024 * 1024
13881263 toJSON (MemoryConstraint x GB) = toJSON $ x * 1024 * 1024 * 1024
13891264
@@ -1414,7 +1289,7 @@ data ContainerResources = ContainerResources {
14141289 , memoryReservation :: Maybe MemoryConstraint
14151290 , memorySwap :: Maybe MemoryConstraint
14161291 -- , memorySwappiness :: Integer -- 1.24: Missing from inspecting container details... Going to omit for now.
1417− , oomKillDisable :: Maybe Bool
1292+ , oomKillDisable :: Bool
14181293 -- , pidsLimit :: Integer -- 1.24: Missing from inspecting container details... Going to omit for now.
14191294 , ulimits :: [Ulimit]
14201295 -- TODO: Missing from 1.24
@@ -1452,7 +1327,7 @@ instance FromJSON EnvVar where
14521327 parseJSON _ = fail "EnvVar is not a string"
14531328
14541329instance ToJSON EnvVar where
1455− toJSON (EnvVar n v) = JSON.String $ n <> T.pack "=" <> v
1330+ toJSON (EnvVar n v) = object [n .= v]
14561331
14571332-- | ExposedPort represents a port (and it's type)
14581333-- that a container should expose to other containers or the host system.
@@ -1492,21 +1367,6 @@ instance {-# OVERLAPPING #-} ToJSON [ExposedPort] where
14921367 where key (ExposedPort p t) = show p <> slash <> show t
14931368 slash = T.unpack "/"
14941369
1495−data Entrypoint = Entrypoint [T.Text] deriving (Eq, Show, Generic)
1496−
1497−instance ToJSON Entrypoint where
1498− toJSON (Entrypoint (e:es)) = toJSON (e:es)
1499− toJSON (Entrypoint []) = JSON.Null
1500−
1501−instance FromJSON Entrypoint where
1502− parseJSON (JSON.String e) = return $ Entrypoint [e]
1503− parseJSON (JSON.Array ar) = do
1504− arr <- mapM parseJSON (V.toList ar)
1505− return $ Entrypoint arr
1506− parseJSON JSON.Null = return $ Entrypoint []
1507− parseJSON _ = fail "Failed to parse Entrypoint"
1508−
1509−
15101370data ContainerConfig = ContainerConfig {
15111371 hostname :: Maybe Text
15121372 , domainname :: Maybe Text
@@ -1525,7 +1385,7 @@ data ContainerConfig = ContainerConfig {
15251385 , image :: Text
15261386 , volumes :: [Volume]
15271387 , workingDir :: Maybe FilePath
1528− , entrypoint :: Entrypoint
1388+ , entrypoint :: Maybe Text -- Can be null?
15291389 , networkDisabled :: Maybe Bool -- Note: Should we expand the JSON instance and take away the Maybe? Null is False?
15301390 , macAddress :: Maybe Text
15311391 -- , onBuild :: Maybe Text -- For 1.24, only see this in the inspect response.
@@ -1533,7 +1393,6 @@ data ContainerConfig = ContainerConfig {
15331393 , stopSignal :: Signal
15341394 } deriving (Eq, Show, Generic)
15351395
1536−
15371396instance ToJSON ContainerConfig where
15381397 toJSON = genericToJSON defaultOptions {
15391398 fieldLabelModifier = (\(x:xs) -> toUpper x : xs)}
@@ -1555,7 +1414,7 @@ instance FromJSON ContainerConfig where
15551414 image <- o .: "Image"
15561415 volumes <- o .: "Volumes"
15571416 workingDir <- o .:? "WorkingDir"
1558− entrypoint <- o .: "Entrypoint"
1417+ entrypoint <- o .:? "Entrypoint"
15591418 networkDisabled <- o .:? "networkDisabled"
15601419 macAddress <- o .:? "MacAddress"
15611420 labels <- o .:? "Labels" .!= []
@@ -1564,11 +1423,7 @@ instance FromJSON ContainerConfig where
15641423 macAddress labels stopSignal
15651424 parseJSON _ = fail "NetworkSettings is not an object."
15661425
1567−#if MIN_VERSION_base(4,13,0)
1568−parseIntegerText :: (MonadFail m) => Text -> m Integer
1569−#else
15701426parseIntegerText :: (Monad m) => Text -> m Integer
1571−#endif
15721427parseIntegerText t = case readMaybe $ T.unpack t of
15731428 Nothing ->
15741429 fail "Could not parse Integer"
@@ -1590,3 +1445,4 @@ toJsonKeyVal vs getKey getVal = JSON.Object $ foldl f HM.empty vs
15901445-- | Helper function that return an empty dictionary "{}"
15911446emptyJsonObject :: JSON.Value
15921447emptyJsonObject = JSON.Object HM.empty
1448+
stack-7.10.yamldeleted−32
@@ -1,32 +0,0 @@
1−# For more information, see: https://github.com/commercialhaskell/stack/blob/release/doc/yaml_configuration.md
2−
3−# Specifies the GHC version and set of packages available (e.g., lts-3.5, nightly-2015-09-21, ghc-7.10.2)
4−resolver: lts-6.30
5−
6−# Local packages, usually specified by relative directory name
7−packages:
8−- '.'
9−
10−# Override default flag values for local packages and extra-deps
11−flags: {}
12−
13−# Extra package databases containing global packages
14−extra-deps:
15−- directory-1.2.7.0
16−- unliftio-core-0.1.1.0
17−- process-1.6.5.1
18−
19−# Control whether we use the GHC we find on the path
20−# system-ghc: true
21−
22−# Require a specific version of stack, using version ranges
23−# require-stack-version: -any # Default
24−# require-stack-version: >= 0.1.4.0
25−
26−# Override the architecture used by stack, especially useful on Windows
27−# arch: i386
28−# arch: x86_64
29−
30−# Extra directories used by stack for building
31−# extra-include-dirs: [/path/to/dir]
32−# extra-lib-dirs: [/path/to/dir]
stack-8.0.2.yamldeleted−4
@@ -1,4 +0,0 @@
1−resolver: lts-9.4
2−packages:
3−- '.'
4−extra-deps: []
stack-8.0.yamldeleted−5
@@ -1,5 +0,0 @@
1−resolver: lts-7.12
2−packages:
3−- '.'
4−extra-deps:
5−- unliftio-core-0.1.1.0
stack-8.6.4.yamldeleted−4
@@ -1,4 +0,0 @@
1−resolver: lts-13.19
2−packages:
3−- '.'
4−extra-deps: []
stack-8.8.2.yamldeleted−5
@@ -1,5 +0,0 @@
1−resolver: lts-15.0
2−packages:
3−- '.'
4−extra-deps: []
5−
stack.yamlmode 120000 → 100644+32−1
@@ -1 +0,0 @@
1−stack-8.6.4.yaml
@@ -0,0 +1,32 @@
1+# For more information, see: https://github.com/commercialhaskell/stack/blob/release/doc/yaml_configuration.md
2+
3+# Specifies the GHC version and set of packages available (e.g., lts-3.5, nightly-2015-09-21, ghc-7.10.2)
4+resolver: lts-5.18
5+
6+# Local packages, usually specified by relative directory name
7+packages:
8+- '.'
9+
10+# Packages to be pulled from upstream that are not in the resolver (e.g., acme-missiles-0.3)
11+extra-deps: [directory-1.2.7.0]
12+
13+# Override default flag values for local packages and extra-deps
14+flags: {}
15+
16+# Extra package databases containing global packages
17+extra-package-dbs: []
18+
19+# Control whether we use the GHC we find on the path
20+# system-ghc: true
21+
22+# Require a specific version of stack, using version ranges
23+# require-stack-version: -any # Default
24+# require-stack-version: >= 0.1.4.0
25+
26+# Override the architecture used by stack, especially useful on Windows
27+# arch: i386
28+# arch: x86_64
29+
30+# Extra directories used by stack for building
31+# extra-include-dirs: [/path/to/dir]
32+# extra-lib-dirs: [/path/to/dir]
tests/Dockerfile+1−1
@@ -1,4 +1,4 @@
11FROM debian:jessie
22
3−CMD ["/bin/bash", "-c", "echo $TEST"]
3+CMD ["/bin/bash", "-c", "echo 123"]
44
tests/tests.hs+75−231
@@ -2,8 +2,6 @@
22
33module Main where
44
5−import Data.Either (rights)
6−import Prelude hiding (all)
75import qualified Test.QuickCheck.Monadic as QCM
86import Test.Tasty
97import Test.Tasty.HUnit
@@ -11,284 +9,130 @@ import Test.Tasty.QuickCheck (testProperty)
119
1210import Control.Concurrent (threadDelay)
1311import Control.Lens ((^.), (^?))
14−import Control.Monad (forM_)
1512import Control.Monad.IO.Class
1613import Control.Monad.Trans.Class (lift)
1714import qualified Data.Aeson as JSON
18−import Data.Aeson ((.=))
19−import Data.Aeson.Lens (key, _Array, _Null, _Object,
20− _String, _Value)
15+import Data.Aeson.Lens (key, _Object, _String, _Value)
2116import qualified Data.ByteString as B
2217import qualified Data.ByteString.Char8 as C
2318import qualified Data.ByteString.Lazy as BL
2419import qualified Data.HashMap.Strict as HM
2520import Data.Int (Int)
2621import qualified Data.Map as M
27−import Data.Maybe (fromJust, isJust, isNothing, listToMaybe)
22+import Data.Maybe (fromJust, isJust)
2823import Data.Monoid
2924import Data.Text (Text, unpack)
30−import qualified Data.Vector as V
3125import Network.Connection (TLSSettings (..))
3226import Network.HTTP.Client (newManager)
3327import Network.HTTP.Client.TLS
3428import Network.HTTP.Types.Status
35−import System.Directory (getCurrentDirectory)
36−import System.Environment (lookupEnv)
3729import System.Process (system)
3830
3931import Docker.Client
4032
4133-- opts = defaultClientOpts
42−testImageName = "docker-hs/test"
43−imageToDeleteFullName = "hello-world:latest"
34+
35+testImageName = "docker-hs-test"
4436
4537toStrict1 = B.concat . BL.toChunks
4638
47−runDocker f
48− -- let opts = defaultClientOpts {baseUrl = "https://127.0.0.1:2376/"}
49− -- params' <- clientParamsWithClientAuthentication "127.0.0.1" 2376 "~/.docker/test-client-key.pem" "~/.docker/test-client-cert.pem" >>= fromRight
50− -- params <- clientParamsSetCA params' "~/.docker/test-ca.pem"
51− -- let settings = mkManagerSettings (TLSSettings params) Nothing
52− -- mgr <- newManager settings
53− = do
54− h <- defaultHttpHandler
55− runDockerT (defaultClientOpts, h) f
39+runDocker f = do
40+ -- let opts = defaultClientOpts {baseUrl = "https://127.0.0.1:2376/"}
41+ -- params' <- clientParamsWithClientAuthentication "127.0.0.1" 2376 "~/.docker/test-client-key.pem" "~/.docker/test-client-cert.pem" >>= fromRight
42+ -- params <- clientParamsSetCA params' "~/.docker/test-ca.pem"
43+ -- let settings = mkManagerSettings (TLSSettings params) Nothing
44+ -- mgr <- newManager settings
45+ runDockerT (defaultClientOpts, defaultHttpHandler) f
5646
5747testDockerVersion :: IO ()
58−testDockerVersion =
59− runDocker $
60− do v <- getDockerVersion
61− lift $ assert $ isRight v
62−
63−testStopNonexisting :: IO ()
64−testStopNonexisting = runDocker $ do
65− res <- stopContainer DefaultTimeout $ fromJust $ toContainerID "thisshouldnotexist"
66− lift $ assert $ isLeft res
48+testDockerVersion = runDocker $ do
49+ v <- getDockerVersion
50+ lift $ assert $ isRight v
6751
6852testFindImage :: IO ()
69−testFindImage =
70− runDocker $
71− do images <- listImages defaultListOpts >>= fromRight
72− let xs = filter (elem imageFullName . imageRepoTags) images
73− lift $ assert $ length xs == 1
74− where
75− imageFullName = testImageName <> ":latest"
76−
77−testDeleteImage :: IO ()
78−testDeleteImage = runDocker $ do
79− img <- fmap fromJust findTestImage
80− result <- deleteImage defaultImageDeleteOpts (imageId img)
81− lift $ assert $ isRight result
82− maybeTestImageAfter <- findTestImage
83− lift $ assert $ isNothing maybeTestImageAfter
84− where
85− findTestImage =
86− do
53+testFindImage = runDocker $ do
8754 images <- listImages defaultListOpts >>= fromRight
88− return $ listToMaybe
89− $ filter (elem imageToDeleteFullName . imageRepoTags) images
90−
91−testListContainers :: IO ()
92−testListContainers =
93− runDocker $
94− do containerId <- createContainer (defaultCreateOpts (testImageName <> ":latest")) Nothing
95− c <- fromRight containerId
96− res <- listContainers $ ListOpts { all=True }
97− deleteContainer (ContainerDeleteOpts True True) c
98− lift $ assert $ isRight res
99−
100−testBuildFromDockerfile :: IO ()
101−testBuildFromDockerfile = do
102− cur <- getCurrentDirectory
103− let ctxDir = cur ++ "/tests"
104− runDocker $ do
105− r <- buildImageFromDockerfile (defaultBuildOpts "docker-hs/dockerfile-test") ctxDir
106− lift $ assert $ isRight r
107−
55+ let xs = filter ((== [imageFullName]) . imageRepoTags) images
56+ lift $ assert $ length xs == 1
57+ where imageFullName = testImageName <> ":latest"
10858
10959testRunAndReadLog :: IO ()
110−testRunAndReadLog = testRunAndReadLogHelper $ NetworkingConfig HM.empty
111−
112−testRunAndReadLogWithNetworking :: IO ()
113−testRunAndReadLogWithNetworking = testRunAndReadLogHelper $ NetworkingConfig $ HM.fromList [("test-network", EndpointConfig ["cellar-door"])]
114−
115−testRunAndReadLogHelper :: NetworkingConfig -> IO ()
116−testRunAndReadLogHelper networkingConfig =
117− runDocker $
118− do let containerConfig = (defaultContainerConfig (testImageName <> ":latest")) {env = [EnvVar "TEST" "123"]}
119− createdNetworks <- rights <$> mapM createNetworkWithName networkNames
120− containerId <- createContainer (CreateOpts containerConfig defaultHostConfig networkingConfig) Nothing
121− c <- fromRight containerId
122− status1 <- startContainer defaultStartOpts c
123− _ <- inspectContainer c >>= fromRight
124− lift $ threadDelay 300000 -- give 300ms for the application to finish
125− lift $ assertBool ("starting the container, unexpected status: " ++ show status1) $ isRightUnit status1
126− logs <- getContainerLogs defaultLogOpts c >>= fromRight
127− lift $ assert $ (C.pack "123") `C.isInfixOf` (toStrict1 logs)
128− status3 <- deleteContainer (ContainerDeleteOpts True True) c
129− lift $ assertBool ("deleting container, unexpected status: " ++ show status3) $ isRightUnit status3
130− mapM_ removeNetwork createdNetworks
131− where
132− isRightUnit (Right ()) = True
133− isRightUnit _ = False
134− networkNames = HM.keys $ endpointsConfig networkingConfig
135− createNetworkWithName name = createNetwork $
136− (defaultCreateNetworkOpts name) { createNetworkCheckDuplicate = True }
137−
138−testCreateRemoveNetwork :: IO ()
139−testCreateRemoveNetwork = do
140− runDocker $ do
141− createStatus <- createNetwork $ defaultCreateNetworkOpts "test-network"
142− lift $ assertBool ("creating a network, unexpected status: " ++ show createStatus) $ isRight createStatus
143− nid <- fromRight createStatus
144− removeStatus <- removeNetwork nid
145− lift $ assertBool ("removing a network, unexpected status: " ++ show removeStatus) $ isRight removeStatus
60+testRunAndReadLog = runDocker $ do
61+ containerId <- createContainer (defaultCreateOpts (testImageName <> ":latest")) Nothing
62+ c <- fromRight containerId
63+ status1 <- startContainer defaultStartOpts c
64+ _ <- inspectContainer c >>= fromRight
65+ lift $ threadDelay 300000 -- give 300ms for the application to finish
66+ lift $ assert $ status1 == Right ()
67+ status2 <- killContainer SIGTERM c
68+ logs <- getContainerLogs defaultLogOpts c >>= fromRight
69+ lift $ assert $ status2 == Right ()
70+ lift $ assert $ (C.pack "123") `C.isInfixOf` (toStrict1 logs)
71+ status3 <- deleteContainer (DeleteOpts True True) c
72+ lift $ assert $ status3 == Right ()
14673
14774testLogDriverOptionsJson :: TestTree
148−testLogDriverOptionsJson = testGroup "Testing LogDriverOptions JSON" [test1, test2, test3]
149− where
150− test1 = testCase "Driver option 1" $ assert $ JSON.toJSON sample ^. key key1 . _String == val1
151− test2 = testCase "Driver option 2" $ assert $ JSON.toJSON sample ^. key key2 . _String == val2
152− test3 =
153− testCase "Test override" $ assert $ JSON.toJSON sample2 ^. key key1 . _String == "override"
154− sample = [LogDriverOption key1 val1, LogDriverOption key2 val2]
155− sample2 = [LogDriverOption key1 val1, LogDriverOption key1 "override"]
156− key1 = "some-key"
157− val1 = "some-val"
158− key2 = "some-key2"
159− val2 = "some-key2"
75+testLogDriverOptionsJson = testGroup "Testing LogDriverOptions JSON" [ test1, test2, test3 ]
76+ where
77+ test1 = testCase "Driver option 1" $ assert $ JSON.toJSON sample ^. key key1 . _String == val1
78+ test2 = testCase "Driver option 2" $ assert $ JSON.toJSON sample ^. key key2 . _String == val2
79+ test3 = testCase "Test override" $ assert $ JSON.toJSON sample2 ^. key key1 . _String == "override"
80+ sample = [LogDriverOption key1 val1, LogDriverOption key2 val2]
81+ sample2 = [LogDriverOption key1 val1, LogDriverOption key1 "override"]
82+ key1 = "some-key"
83+ val1 = "some-val"
84+ key2 = "some-key2"
85+ val2 = "some-key2"
16086
16187testExposedPortsJson :: TestTree
162−testExposedPortsJson = testGroup "Testing ExposedPorts JSON" [testTCP, testUDP]
163− where
164− testTCP = testCase "tcp port" $ assert $ JSON.toJSON sampleEP ^. key "80/tcp" . _Object == HM.empty
165− testUDP =
166− testCase "udp port" $ assert $ JSON.toJSON sampleEP ^. key "1337/tcp" . _Object == HM.empty
167− sampleEP = [ExposedPort 80 TCP, ExposedPort 1337 UDP]
88+testExposedPortsJson = testGroup "Testing ExposedPorts JSON" [ testTCP, testUDP ]
89+ where
90+ testTCP = testCase "tcp port" $ assert $ JSON.toJSON sampleEP ^. key "80/tcp" . _Object == HM.empty
91+ testUDP = testCase "udp port" $ assert $ JSON.toJSON sampleEP ^. key "1337/tcp" . _Object == HM.empty
92+ sampleEP = [ExposedPort 80 TCP, ExposedPort 1337 UDP]
16893
16994testLabelsJson :: TestTree
170−testLabelsJson = testGroup "Testing Labels JSON" [testLS1, testLS2, testOverride]
171− where
172− testLS1 = testCase "test label key1" $ assert $ JSON.toJSON sampleLS ^. key key1 . _String == val1
173− testLS2 = testCase "test label key2" $ assert $ JSON.toJSON sampleLS ^. key key2 . _String == val2
174− testOverride =
175− testCase "test label override" $ assert $ JSON.toJSON [Label key1 val1, Label key1 "override"] ^.
176− key key1 .
177− _String ==
178− "override"
179− sampleLS = [Label key1 val1, Label key2 val2]
180− key1 = "com.example.some-label"
181− val1 = "some-value"
182− key2 = "something"
183− val2 = "value"
95+testLabelsJson = testGroup "Testing Labels JSON" [ testLS1, testLS2, testOverride ]
96+ where
97+ testLS1 = testCase "test label key1" $ assert $ JSON.toJSON sampleLS ^. key key1 . _String == val1
98+ testLS2 = testCase "test label key2" $ assert $ JSON.toJSON sampleLS ^. key key2 . _String == val2
99+ testOverride = testCase "test label override" $ assert $ JSON.toJSON [Label key1 val1, Label key1 "override"] ^. key key1 . _String == "override"
100+ sampleLS = [Label key1 val1, Label key2 val2]
101+ key1 = "com.example.some-label"
102+ val1 = "some-value"
103+ key2 = "something"
104+ val2 = "value"
184105
185106testVolumesJson :: TestTree
186−testVolumesJson = testGroup "Testing Volumes JSON" [testSample1, testSample2]
187− where
188− testSample1 =
189− testCase "Test exposing volume: /tmp" $ assert $ JSON.toJSON sampleVolumes ^. key "/tmp" . _Object ==
190− HM.empty
191− testSample2 =
192− testCase "Test exposing volume: /opt" $ assert $ JSON.toJSON sampleVolumes ^. key "/opt" . _Object ==
193− HM.empty
194− sampleVolumes = [Volume "/tmp", Volume "/opt"]
195−
196−testEntrypointJson :: TestTree
197−testEntrypointJson = testGroup "Testing ContainerConfig JSON" [testSample1, testSample2, testSample3, testSample4, testSample5]
198− where
199− testSample1 =
200− testCase "Test toJSON with empty entrypoint (null)" $ assert $ JSON.toJSON (Entrypoint []) ^. _Null == ()
201− testSample2 =
202− testCase "Test toJSON with entrypoint as Array" $ assert $
203− JSON.toJSON (Entrypoint sampleEntrypointArr) ==
204− JSON.toJSON sampleEntrypointArr
205− testSample3 =
206− testCase "Test decoding entrypoint as string" $ assert $ (JSON.decode "\"cmd\"") ==
207− Just (Entrypoint ["cmd"])
208− testSample4 =
209− testCase "Test decoding as null" $ assert $ (JSON.decode "null" :: Maybe Entrypoint) ==
210− Just (Entrypoint [])
211− testSample5 =
212− testCase "Test decoding as array" $ assert $ (JSON.decode (JSON.encode sampleEntrypointArr) :: Maybe Entrypoint) ==
213− Just (Entrypoint sampleEntrypointArr)
214− sampleEntrypointArr = ["cmd", "--some-flag", "--some-flag2"]
215−
216−testEnvVarJson :: TestTree
217−testEnvVarJson = testGroup "Testing EnvVar JSON" [testSampleEncode, testSampleDecode]
218− where
219− testSampleEncode =
220− testCase "Test toJSON" $ assert $ JSON.toJSON (EnvVar "cellar" "door") == JSON.String "cellar=door"
221− testSampleDecode =
222− testCase "Test fromJSON" $ assert $ (JSON.decode "\"cellar=door\"" :: Maybe EnvVar) ==
223− Just (EnvVar "cellar" "door")
224−
225−testNetworkingConfigJson :: TestTree
226−testNetworkingConfigJson = testGroup "Testing NetworkingConfig JSON" [testSampleEncode]
227− where
228− testSampleEncode =
229− let networkingConfig = NetworkingConfig $ HM.fromList [("custom-network", EndpointConfig ["cellar", "door"])]
230− in testCase "Test toJSON" $ assert $ JSON.toJSON networkingConfig ==
231− JSON.object
232− [ "EndpointsConfig" .= JSON.object
233− [ "custom-network" .= JSON.object
234− [ "Aliases" .= (["cellar", "door"] :: [Text])
235− ]
236− ]
237− ]
107+testVolumesJson = testGroup "Testing Volumes JSON" [ testSample1, testSample2 ]
108+ where
109+ testSample1 = testCase "Test exposing volume: /tmp" $ assert $ JSON.toJSON sampleVolumes ^. key "/tmp" . _Object == HM.empty
110+ testSample2 = testCase "Test exposing volume: /opt" $ assert $ JSON.toJSON sampleVolumes ^. key "/opt" . _Object == HM.empty
111+ sampleVolumes = [Volume "/tmp", Volume "/opt"]
238112
239113integrationTests :: TestTree
240−integrationTests =
241− testGroup
242− "Integration Tests"
243− [ testCase "Get docker version" testDockerVersion
244− , testCase "Build image from Dockerfile" testBuildFromDockerfile
245− , testCase "Find image by name" testFindImage
246− , testCase "Delete image" testDeleteImage
247− , testCase "List containers" testListContainers
248− , testCase "Run a dummy container and read its log" testRunAndReadLog
249− , testCase "Run a dummy container with networking and read its log" testRunAndReadLogWithNetworking
250− , testCase "Try to stop a container that doesn't exist" testStopNonexisting
251− , testCase "Create and remove a network" testCreateRemoveNetwork
252− ]
114+integrationTests = testGroup "Integration Tests" [
115+ testCase "Get docker version" testDockerVersion,
116+ testCase "Find image by name" testFindImage,
117+ testCase "Run a dummy container and read its log" testRunAndReadLog]
253118
254119jsonTests :: TestTree
255−jsonTests =
256− testGroup
257− "JSON Tests"
258− [ testExposedPortsJson
259− , testVolumesJson
260− , testLabelsJson
261− , testLogDriverOptionsJson
262− , testEntrypointJson
263− , testEnvVarJson
264− , testNetworkingConfigJson
265− ]
120+jsonTests = testGroup "JSON Tests" [testExposedPortsJson, testVolumesJson, testLabelsJson, testLogDriverOptionsJson]
266121
267122setup :: IO ()
268−setup =
269− mapM_ system
270− [ "docker pull " ++ unpack imageToDeleteFullName
271− , "docker build -t " ++ unpack testImageName ++ " tests"
272− ]
273−
274−isLeft = not . isRight
123+setup = system ("docker build -t "++unpack testImageName++" tests") >> return ()
275124
276−isRight (Left _) = False
125+isRight (Left _) = False
277126isRight (Right _) = True
278127
279−fromRight
280− :: (MonadIO m, Show l)
281− => Either l r -> m r
128+fromRight :: (MonadIO m, Show l) => Either l r -> m r
282129fromRight (Left l) = do
283− liftIO $ assertFailure $ "Left: " ++ show l
284− undefined
130+ liftIO $ assertFailure $ "Left: " ++ show l
131+ undefined
285132fromRight (Right r) = return r
286133
287134main :: IO ()
288135main = do
289− stackage <- lookupEnv "RUN_INTEGRATION_TESTS"
290− case stackage of
291− Nothing -> defaultMain $ testGroup "Tests" [jsonTests]
292− Just _ -> do
293− setup
294− defaultMain $ testGroup "Tests" [jsonTests, integrationTests]
136+ setup
137+ defaultMain $ testGroup "Tests" [jsonTests, integrationTests]
138+