ContainerHealthCheck
Instructions on when and how to check the health of a support container in a container fleet. These properties override any Docker health checks that are set in the container image. For more information on container health checks, see HealthCheck command in the Amazon Elastic Container Service API. Game server containers don't have a health check parameter; Amazon GameLift automatically handles health checks for these containers.
The following example instructs the container to initiate a health check command every 60 seconds and wait 10 seconds for it to succeed. If it fails, retry the command 3 times before flagging the container as unhealthy. It also tells the container to wait 100 seconds after launch before counting failed health checks.
{"Command": [ "CMD-SHELL", "ps cax | grep "processmanager" || exit 1" ], "Interval":
60, "Timeout": 10, "Retries": 3, "StartPeriod": 100 }
Part of: SupportContainerDefinition, SupportContainerDefinitionInput
Contents
Note
In the following list, the required parameters are described first.
- Command
-
A string array that specifies the command that the container runs to determine if it's healthy.
Type: Array of strings
Array Members: Minimum number of 1 item. Maximum number of 20 items.
Length Constraints: Minimum length of 1. Maximum length of 255.
Required: Yes
- Interval
-
The time period (in seconds) between each health check.
Type: Integer
Valid Range: Minimum value of 60. Maximum value of 300.
Required: No
- Retries
-
The number of times to retry a failed health check before flagging the container unhealthy. The first run of the command does not count as a retry.
Type: Integer
Valid Range: Minimum value of 5. Maximum value of 10.
Required: No
- StartPeriod
-
The optional grace period (in seconds) to give a container time to bootstrap before the first failed health check counts toward the number of retries.
Type: Integer
Valid Range: Minimum value of 0. Maximum value of 300.
Required: No
- Timeout
-
The time period (in seconds) to wait for a health check to succeed before counting a failed health check.
Type: Integer
Valid Range: Minimum value of 30. Maximum value of 60.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
