18.2. Performing a health check using the command line

Procedure

1. Define a health check:

   $ podman run -dt --name=hc-container -p 8080:8080 --health-cmd='curl http://localhost:8080 || exit 1' --health-interval=0 registry.access.redhat.com/ubi10/httpd-24

   • The --health-cmd option sets a health check command for the container.
   • The --health-interval=0 option with 0 value indicates that you want to run the health check manually.

2. Check the health status of the hc-container container:

   • Using the podman inspect command:

     $ podman inspect --format='{{json .State.Health.Status}}' hc-container
     healthy

   • Using the podman ps command:

     $ podman ps
     CONTAINER ID  IMAGE                 COMMAND               CREATED      STATUS          PORTS       NAMES
     a680c6919fe  localhost/hc-container:latest  /usr/bin/run-http...  2 minutes ago  Up 2 minutes (healthy) hc-container

   • Using the podman healthcheck run command:

     $ podman healthcheck run hc-container
     healthy