Lightsail / Client / get_container_service_deployments
get_container_service_deployments#
- Lightsail.Client.get_container_service_deployments(**kwargs)#
Returns the deployments for your Amazon Lightsail container service
A deployment specifies the settings, such as the ports and launch command, of containers that are deployed to your container service.
The deployments are ordered by version in ascending order. The newest version is listed at the top of the response.
Note
A set number of deployments are kept before the oldest one is replaced with the newest one. For more information, see Amazon Lightsail endpoints and quotas in the Amazon Web Services General Reference.
See also: AWS API Documentation
Request Syntax
response = client.get_container_service_deployments( serviceName='string' )
- Parameters:
serviceName (string) –
[REQUIRED]
The name of the container service for which to return deployments.
- Return type:
dict
- Returns:
Response Syntax
{ 'deployments': [ { 'version': 123, 'state': 'ACTIVATING'|'ACTIVE'|'INACTIVE'|'FAILED', 'containers': { 'string': { 'image': 'string', 'command': [ 'string', ], 'environment': { 'string': 'string' }, 'ports': { 'string': 'HTTP'|'HTTPS'|'TCP'|'UDP' } } }, 'publicEndpoint': { 'containerName': 'string', 'containerPort': 123, 'healthCheck': { 'healthyThreshold': 123, 'unhealthyThreshold': 123, 'timeoutSeconds': 123, 'intervalSeconds': 123, 'path': 'string', 'successCodes': 'string' } }, 'createdAt': datetime(2015, 1, 1) }, ] }
Response Structure
(dict) –
deployments (list) –
An array of objects that describe deployments for a container service.
(dict) –
Describes a container deployment configuration of an Amazon Lightsail container service.
A deployment specifies the settings, such as the ports and launch command, of containers that are deployed to your container service.
version (integer) –
The version number of the deployment.
state (string) –
The state of the deployment.
A deployment can be in one of the following states:
Activating
- The deployment is being created.Active
- The deployment was successfully created, and it’s currently running on the container service. The container service can have only one deployment in an active state at a time.Inactive
- The deployment was previously successfully created, but it is not currently running on the container service.Failed
- The deployment failed. Use theGetContainerLog
action to view the log events for the containers in the deployment to try to determine the reason for the failure.
containers (dict) –
An object that describes the configuration for the containers of the deployment.
(string) –
(dict) –
Describes the settings of a container that will be launched, or that is launched, to an Amazon Lightsail container service.
image (string) –
The name of the image used for the container.
Container images sourced from your Lightsail container service, that are registered and stored on your service, start with a colon (
:
). For example, if your container service name iscontainer-service-1
, the container image label ismystaticsite
, and you want to use the third (3
) version of the registered container image, then you should specify:container-service-1.mystaticsite.3
. To use the latest version of a container image, specifylatest
instead of a version number (for example,:container-service-1.mystaticsite.latest
). Lightsail will automatically use the highest numbered version of the registered container image.Container images sourced from a public registry like Docker Hub don’t start with a colon. For example,
nginx:latest
ornginx
.command (list) –
The launch command for the container.
(string) –
environment (dict) –
The environment variables of the container.
(string) –
(string) –
ports (dict) –
The open firewall ports of the container.
(string) –
(string) –
publicEndpoint (dict) –
An object that describes the endpoint of the deployment.
containerName (string) –
The name of the container entry of the deployment that the endpoint configuration applies to.
containerPort (integer) –
The port of the specified container to which traffic is forwarded to.
healthCheck (dict) –
An object that describes the health check configuration of the container.
healthyThreshold (integer) –
The number of consecutive health checks successes required before moving the container to the
Healthy
state. The default value is2
.unhealthyThreshold (integer) –
The number of consecutive health check failures required before moving the container to the
Unhealthy
state. The default value is2
.timeoutSeconds (integer) –
The amount of time, in seconds, during which no response means a failed health check. You can specify between 2 and 60 seconds. The default value is
2
.intervalSeconds (integer) –
The approximate interval, in seconds, between health checks of an individual container. You can specify between 5 and 300 seconds. The default value is
5
.path (string) –
The path on the container on which to perform the health check. The default value is
/
.successCodes (string) –
The HTTP codes to use when checking for a successful response from a container. You can specify values between
200
and499
. You can specify multiple values (for example,200,202
) or a range of values (for example,200-299
).
createdAt (datetime) –
The timestamp when the deployment was created.
Exceptions
Lightsail.Client.exceptions.ServiceException
Lightsail.Client.exceptions.InvalidInputException
Lightsail.Client.exceptions.NotFoundException
Lightsail.Client.exceptions.AccessDeniedException
Lightsail.Client.exceptions.UnauthenticatedException