Networking

Using IP addresses

You can network manually by just reading the IP addresses of containers

for {
  docker <- Docker[IO]
  nginx  <- docker("nginx", "latest")
  _      <- nginx.waitForPort(80)
  curl   <- docker("byrnedo/alpine-curl", "latest", command = Some(List(s"http://${nginx.ipAddress}")))
  exited <- curl.waitForExit(docker)
} yield exited

Using container names

Creating a network

You can create a docker network as a resource using the client, this will be cleaned up for you

for {
  docker <- Docker[IO]
  network <- docker.network("mynetwork")
} yield network

Running containers in a network

You can then run some containers and set their network, allowing them to resolve each other’s names

for {
  docker <- Docker[IO]
  test1  <- docker.network("test1")
  nginx  <- docker("nginx", "latest", name = Some("nginx1"), network = Some(test1.id()))
  _      <- nginx.waitForPort(80)
  curl   <- docker("byrnedo/alpine-curl", "latest", network = Some(test1.id()), command = Some(List("http://nginx1/")))
  exited <- curl.waitForExit(docker)
} yield exited

Binding a port to the host

You can bind ports onto the host if you need more predictable addressing, there’s syntax available for the tcp/udp arguments

import net.andimiller.whales.syntax._

for {
  docker <- Docker[IO]
  nginx  <- docker("nginx", "latest",
    bindings = Map(80.tcp -> Binding(port = Some(8080))) // bind the container's 80 onto the host's 8080
  )
  _      <- nginx.waitForPort(80)
} yield nginx

Binding to a random port on the host

You can also bind to a random port on the host if you’d like

scala> import net.andimiller.whales.syntax._
import net.andimiller.whales.syntax._

scala> { for {
     |   docker <- Docker[IO]
     |   nginx  <- docker("nginx", "latest",
     |     bindings = Map(80.tcp -> Binding(hostname = Some("0.0.0.0")))
     |   )
     |   _      <- nginx.waitForPort(80)
     |   boundPorts = nginx.ports
     | } yield (boundPorts) }.use(IO.pure).unsafeRunSync()
res4: Map[net.andimiller.whales.Port,List[(String, Int)]] = Map(80/tcp -> List((0.0.0.0,32783)))