on master help sign in
Updates docs and examples
6dbf176Deni Bertovic
examples/Example.hs+52−43
@@ -1,55 +1,64 @@
1import Docker.Client
1import Docker.Client
2
2
3runNginxContainer :: IO ContainerID
3runNginxContainer :: IO ContainerID
4+runNginxContainer = do
5+ h <- defaultHttpHandler
4−runNginxContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
6+ runDockerT (defaultClientOpts, h) $
5− let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
7+ do let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
6− let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
8+ let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
7− cid <- createContainer myCreateOpts (Just "myNginxContainer")
9+ cid <- createContainer myCreateOpts (Just "myNginxContainer")
8− case cid of
10+ case cid of
9− Left err -> error $ show err
11+ Left err -> error $ show err
10− Right i -> do
12+ Right i -> do
11− _ <- startContainer defaultStartOpts i
13+ _ <- startContainer defaultStartOpts i
12− return i
14+ return i
13
15
14stopNginxContainer :: ContainerID -> IO ()
16stopNginxContainer :: ContainerID -> IO ()
17+stopNginxContainer cid = do
18+ h <- defaultHttpHandler
15−stopNginxContainer cid = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
19+ runDockerT (defaultClientOpts, h) $
16− r <- stopContainer DefaultTimeout cid
20+ do r <- stopContainer DefaultTimeout cid
17− case r of
21+ case r of
18− Left _ -> error "I failed to stop the container"
22+ Left _ -> error "I failed to stop the container"
19− Right _ -> return ()
23+ Right _ -> return ()
20
24
21runPostgresContainer :: IO ContainerID
25runPostgresContainer :: IO ContainerID
26+runPostgresContainer = do
27+ h <- defaultHttpHandler
22−runPostgresContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
28+ runDockerT (defaultClientOpts, h) $
23− let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
29+ do let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
24− let b = Bind "/tmp" "/tmp" Nothing
30+ let b = Bind "/tmp" "/tmp" Nothing
25− let myCreateOpts = addBind b $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
31+ let myCreateOpts = addBind b $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
26− cid <- createContainer myCreateOpts Nothing
32+ cid <- createContainer myCreateOpts Nothing
27− case cid of
33+ case cid of
28− Left err -> error $ show err
34+ Left err -> error $ show err
29− Right i -> do
35+ Right i -> do
30− _ <- startContainer defaultStartOpts i
36+ _ <- startContainer defaultStartOpts i
31− return i
37+ return i
32
38
33-- | Example of how we can start a database container while hosting it's
39-- | Example of how we can start a database container while hosting it's
34-- data in a data volume living inside another container.
40-- data in a data volume living inside another container.
35runPostgresWithDataContainer :: IO ContainerID
41runPostgresWithDataContainer :: IO ContainerID
36−runPostgresWithDataContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
42+runPostgresWithDataContainer = do
43+ h <- defaultHttpHandler
44+ runDockerT (defaultClientOpts, h) $
37− -- We use a dummy command like /bin/true because we don't want to start
45+ -- 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
46+ -- the postgres database in the data container we just want it to
39− -- create a container filesystem for us.
47+ -- create a container filesystem for us.
40− let dataOpts = setCmd "/bin/true" $ defaultCreateOpts "postgres:9.5"
48+ do let dataOpts = setCmd "/bin/true" $ defaultCreateOpts "postgres:9.5"
41− cid <- createContainer dataOpts (Just "myDataContainer")
49+ cid <- createContainer dataOpts (Just "myDataContainer")
50+ _ <-
42− _ <- case cid of
51+ case cid of
43− Left err -> error $ show err
52+ Left err -> error $ show err
44− Right i -> startContainer defaultStartOpts i
53+ Right i -> startContainer defaultStartOpts i
45− let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
54+ let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
46− -- Default permission is read-write if we don't specify anything
55+ -- Default permission is read-write if we don't specify anything
47− let vf = VolumeFrom "myDataContainer" Nothing
56+ let vf = VolumeFrom "myDataContainer" Nothing
48− let myCreateOpts = addVolumeFrom vf $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
57+ let myCreateOpts = addVolumeFrom vf $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
49− ccid <- createContainer myCreateOpts (Just "pgContainer")
58+ ccid <- createContainer myCreateOpts (Just "pgContainer")
50− case ccid of
59+ case ccid of
51− Left err -> error $ show err
60+ Left err -> error $ show err
52− Right i -> do
61+ Right i -> do
53− _ <- startContainer defaultStartOpts i
62+ _ <- startContainer defaultStartOpts i
54− return i
63+ return i
55
64
src/Docker/Client.hs+11−4
@@ -20,7 +20,9 @@ the host.
20import Docker.Client
20import Docker.Client
21
21
22runNginxContainer :: IO ContainerID
22runNginxContainer :: IO ContainerID
23+runNginxContainer = do
24+ h <- defaultHttpHandler
23−runNginxContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
25+ runDockerT (defaultClientOpts, h) $ do
24 let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
26 let pb = PortBinding 80 TCP [HostPort "0.0.0.0" 8000]
25 let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
27 let myCreateOpts = addPortBinding pb $ defaultCreateOpts "nginx:latest"
26 cid <- createContainer myCreateOpts
28 cid <- createContainer myCreateOpts
@@ -42,7 +44,9 @@ Let's stop the container now:
42
44
43@
45@
44stopNginxContainer :: ContainerID -> IO ()
46stopNginxContainer :: ContainerID -> IO ()
47+stopNginxContainer cid = do
48+ h <- defaultHttpHandler
45−stopNginxContainer cid = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
49+ runDockerT (defaultClientOpts, h) $ do
46 r <- stopContainer DefaultTimeout cid
50 r <- stopContainer DefaultTimeout cid
47 case r of
51 case r of
48 Left err -> error "I failed to stop the container"
52 Left err -> error "I failed to stop the container"
@@ -57,7 +61,9 @@ persist on the host file system.
57
61
58@
62@
59runPostgresContainer :: IO ContainerID
63runPostgresContainer :: IO ContainerID
64+runPostgresContainer = do
65+ h <- defaultHttpHandler
60−runPostgresContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
66+ runDockerT (defaultClientOpts, h) $ do
61 let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
67 let pb = PortBinding 5432 TCP [HostPort "0.0.0.0" 5432]
62 let myCreateOpts = addBinds [Bind "\/tmp" "\/tmp" Nothing] $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
68 let myCreateOpts = addBinds [Bind "\/tmp" "\/tmp" Nothing] $ addPortBinding pb $ defaultCreateOpts "postgres:9.5"
63 cid <- createContainer myCreateOpts
69 cid <- createContainer myCreateOpts
@@ -70,7 +76,8 @@ runPostgresContainer = runDockerT (defaultClientOpts, defaultHttpHandler) $ do
70
76
71= Get Docker API Version
77= Get Docker API Version
72
78
79+>>> h <- defaultHttpHandler
73−>>> runDockerT (defaultClientOpts, defaultHttpHandler) $ getDockerVersion
80+>>> runDockerT (defaultClientOpts, h) $ getDockerVersion
74Right (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"})
81Right (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"})
75
82
76= Setup SSL Authentication
83= Setup SSL Authentication