Generation 1

Health Checks

By default, for a deployment to succeed, it must pass certain “health checks.”

If the Process does not expose ports it is considered healthy if it starts and doesn’t immediately exit or crash.

If the Process exposes ports is it considered healthy after it:

• Registers behind a load balancer
• Passes a certain number of network connection health checks

Common causes for not passing health checks are:

• The cluster does not have sufficient memory or CPU resources available to start a new process
• The cluster does not have sufficient instances where a new process port is not already reserved by an older release
• A process crashes immediately after starting due to a problem in the latest code
• A process takes too long to initialize its server and therefore fails a network health check

Health Check Options

By default Convox will set up a tcp health check to your application, defining that a process must boot and pass the network health check in 3 seconds. If your app takes longer to boot, you may need to increase this to up to 60 seconds by adding a label by adding one or more of the following labels to your docker-compose.yml file.

version: "2"
services:
  web:
    labels:
        - convox.health.interval=10
        - convox.health.path=/_health
        - convox.health.port=5000
        - convox.health.threshold.healthy=3
        - convox.health.threshold.unhealthy=4
        - convox.health.timeout=3
    ports:
      - "443:5000"

See also

• Load Balancers
• Rolling Updates