testcontainers / helloworld

A Docker image to support Testcontainers' self-test suites

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Testcontainers Helloworld Docker Image

This is a Docker image for use by Testcontainers' own self-test suites. It is not intended for use outside of the Testcontainers project.

It features a small HTTP server with the following characteristics:

  • It serves content on two ports (8080 and 8081) to enable testing that multiple Docker container ports can be exposed.
  • It serves an HTML root page, with a few basic elements, to enable verification that browser-based test tools can access the container.
  • It serves a non-HTML endpoint at /ping, to enable plain HTTP testing.
  • It serves a UUID unique to this running instance of the container, at /uuid, to enable testing of multiple container instances or testing of stop/start behaviour.
  • It implements a configurable delay at startup before each port's server is started, to enable testing of startup wait strategies (TCP or HTTP-based). Setting the environment variable DELAY_START_MSEC to a non-zero number will:
    • wait for the defined duration
    • start the port 8080 server
    • wait again for the same duration
    • start the port 8081 server
  • It emits a basic log message after starting which can be used to test log-based wait strategies.

Example usage

$ docker run -p 8080:8080 -p 8081:8081 -e DELAY_START_MSEC=2000 testcontainers/helloworld

2020/09/26 08:50:55 DELAY_START_MSEC: 2000
2020/09/26 08:50:55 Sleeping for 2000 ms
2020/09/26 08:50:57 Starting server on port 8080
2020/09/26 08:50:57 Sleeping for 2000 ms
2020/09/26 08:50:59 Starting server on port 8081
2020/09/26 08:50:59 Ready, listening on 8080 and 8081

License

See LICENSE.

Copyright

Copyright (c) 2020 Richard North and other authors.

About

A Docker image to support Testcontainers' self-test suites

License:MIT License


Languages

Language:Go 61.8%Language:HTML 27.4%Language:Dockerfile 10.7%