Troubleshooting: Fargate Task Storage Errors
After deploying a fargate
or fargate-worker
service, you may see the following error:
[
{
"type": "FARGATE_DEPLOY_ERROR",
"message": "Cannotpullcontainererror: ref pull has been retried 1 time(s): failed to extract layer: <layer_id> no space left on device: unknown"
}
]
Solution
You may need to increase the storage for the ECS Fargate task. By default, AWS assigns 20GB for each task, but can increase this value up to 200GB. For more details about Fargate task storage, see the AWS Fargate task storage page (opens in a new tab).
In order to change the task storage for the service:
- If you are using
flightcontrol.json
for configuration, addstorage: 100
property to the configuration file. This will configure the Fargate task with 100GB of storage. You can adjust the number as needed. - If you are using the Flightcontrol dashboard (GUI), you can increase the storage under the service's Instance configuration settings.