clj-test-containers.core
bind-filesystem!clj
(bind-filesystem! {:keys [container] :as container-config}
{:keys [host-path container-path mode]})Binds a source from the filesystem to the given container path. Should be called before starting the container!
Binds a source from the filesystem to the given container path. Should be called before starting the container!
copy-file-to-container!clj
(copy-file-to-container! {:keys [container id] :as container-config}
{:keys [container-path path type]})If a container is not yet started, adds a mapping from mountable file to container path that will be copied to the container on startup. If the container is already running, copy the file to the running container.
If a container is not yet started, adds a mapping from mountable file to container path that will be copied to the container on startup. If the container is already running, copy the file to the running container.
createclj
(create {:keys [image-name] :as options})Creates a generic testcontainer and sets its properties
Creates a generic testcontainer and sets its properties
create-from-docker-fileclj
(create-from-docker-file {:keys [docker-file] :as options})Creates a testcontainer from a provided Dockerfile
Creates a testcontainer from a provided Dockerfile
create-networkclj
(create-network)(create-network {:keys [ipv6 driver]})Creates a network. The optional map accepts config values for enabling ipv6 and setting the driver
Creates a network. The optional map accepts config values for enabling ipv6 and setting the driver
dump-logsclj
(dump-logs container-config)Dumps the logs found by invoking the function on the :string-log key
Dumps the logs found by invoking the function on the :string-log key
execute-command!clj
(execute-command! {:keys [container]} command)Executes a command in the container, and returns the result
Executes a command in the container, and returns the result
initclj
(init {:keys [container exposed-ports env-vars command network network-aliases
wait-for]
:as init-options})Sets the properties for a testcontainer instance
Sets the properties for a testcontainer instance
logcljmultimethod
Sets a log strategy on the container as a means of accessing the container logs. It currently only supports a :string as the strategy to use.
String Strategy
The :string strategy sets up a function in the returned map, under the
string-log key. This function enables the dumping of the logs when passed to
the dump-logs function.
Example:
{:log-strategy :string}
Then, later in your program, you can access the logs thus:
(def container-config (tc/start! container))
(tc/dump-logs container-config)
Sets a log strategy on the container as a means of accessing the container
logs. It currently only supports a :string as the strategy to use.
## String Strategy
The :string strategy sets up a function in the returned map, under the
`string-log` key. This function enables the dumping of the logs when passed to
the `dump-logs` function.
Example:
```clojure
{:log-strategy :string}
```
Then, later in your program, you can access the logs thus:
```clojure
(def container-config (tc/start! container))
(tc/dump-logs container-config)
```
map-classpath-resource!clj
(map-classpath-resource! {:keys [container] :as container-config}
{:keys [resource-path container-path mode]})Maps a resource in the classpath to the given container path. Should be called before starting the container!
Maps a resource in the classpath to the given container path. Should be called before starting the container!
perform-cleanup!clj
(perform-cleanup!)Stops and removes all container instances which were created in the active JVM or REPL session
Stops and removes all container instances which were created in the active JVM or REPL session
start!clj
(start! {:keys [container log-to exposed-ports] :as container-config})Starts the underlying testcontainer instance and adds new values to the response map, e.g. :id and :first-mapped-port
Starts the underlying testcontainer instance and adds new values to the response map, e.g. :id and :first-mapped-port
stop!clj
(stop! {:keys [container] :as container-config})Stops the underlying container
Stops the underlying container
waitcljmultimethod
Sets a wait strategy to the container. Supports :http, :health and :log as strategies.
HTTP Strategy
The :http strategy will only accept the container as initialized if it can be accessed via HTTP. It accepts a path, a port, a vector of status codes, a boolean that specifies if TLS is enabled, a read timeout in seconds and a map with basic credentials, containing username and password. Only the path is required, all others are optional.
Example:
(wait {:wait-strategy :http
:port 80
:path "/"
:status-codes [200 201]
:tls true
:read-timeout 5
:basic-credentials {:username "user"
:password "password"}}
container)
Health Strategy
The :health strategy only accepts a true or false value. This enables support for Docker's healthcheck feature, whereby you can directly leverage the healthy state of your container as your wait condition.
Example:
(wait {:wait-strategy :health :true} container)
Log Strategy
The :log strategy accepts a message which simply causes the output of your
container's log to be used in determining if the container is ready or not.
The output is grepped against the log message.
Example:
(wait {:wait-strategy :log
:message "accept connections"} container)
Sets a wait strategy to the container. Supports :http, :health and :log as
strategies.
## HTTP Strategy
The :http strategy will only accept the container as initialized if it can be
accessed via HTTP. It accepts a path, a port, a vector of status codes, a
boolean that specifies if TLS is enabled, a read timeout in seconds and a map
with basic credentials, containing username and password. Only the path is
required, all others are optional.
Example:
```clojure
(wait {:wait-strategy :http
:port 80
:path "/"
:status-codes [200 201]
:tls true
:read-timeout 5
:basic-credentials {:username "user"
:password "password"}}
container)
```
## Health Strategy
The :health strategy only accepts a true or false value. This enables support
for Docker's healthcheck feature, whereby you can directly leverage the
healthy state of your container as your wait condition.
Example:
```clojure
(wait {:wait-strategy :health :true} container)
```
## Log Strategy
The :log strategy accepts a message which simply causes the output of your
container's log to be used in determining if the container is ready or not.
The output is `grepped` against the log message.
Example:
```clojure
(wait {:wait-strategy :log
:message "accept connections"} container)
```cljdoc is a website building & hosting documentation for Clojure/Script libraries
× close