Start and Shutdown
IdBuilder service are deployed to a docker image. For on-premises environments the docker image is deployed and initially started using Ansible-Tower, but it can later be managed with use of console commands; for Azure environments the docker image is handled by Kubernetes.
One can verify whether IdBuilder application is started or not with help of liveness health check endpoint. If the service is up, then this endpoint returns 200 code. Otherwise, a Kubernetes probe would attempt to restart the whole container with ID Builder service.
Graceful Shutdown
A graceful shutdown helps the application finishes ongoing tasks before it stops.
When you stop the application, it waits for a set time before shutting down. This wait time is controlled by a variable HostSettings__ShutdownTimeoutSeconds, which defaults to 30 seconds but can be changed.
Exit Codes
After shutdown, the application will exit with a code to show what happened. These codes help you or support teams understand how the app stopped:
-
None (0)– The application shut down cleanly with no issues. -
Timeout (1)– Shutdown exceeded the configured timeout (e.g., 30 seconds) before tasks could finish. -
ShutdownError (2)– An error occurred while shutting down, such as a failure in resource cleanup.