AWS ECS
The Things Stack can be deployed to AWS as a set of highly available services on AWS ECS using AWS CloudFormation.
This guide gives an overview of the architecture and shows how to deploy your own highly available The Things Stack cluster.
Who is it for?
The AWS ECS deployment option is for professional, large-scale and multi-tenant deployments.
This deployment option is significantly more complicated than other deployment options. In order to deploy and operate The Things Stack in this configuration, you will need to be comfortable working with and operating the following concepts:
- AWS VPC
- AWS RDS
- AWS ElastiCache
- AWS EC2
- AWS ECS
- AWS CloudFormation
- Shell and command line usage
- AWS command line interface
Architecture
This page describes the architecture of a The Things Stack deployment on AWS ECS.
Prerequisites
This page describes what you need for deploying The Things Stack on AWS ECS.
Deployment
This page describes the steps for deploying The Things Stack on AWS ECS.
Database Operations
This page describes the steps for performing database operations on an AWS ECS deployment.
Monitoring
This page describes how you can monitor a The Things Stack deployment on AWS ECS.
Updating
This page describes the steps for updating The Things Stack on AWS ECS.
Best Practices
This page describes best practices of a The Things Stack deployment on AWS ECS.
Stack Naming Templates are numbered in suggested order of deployment. This doesn’t mean that numbering won’t change in the future. Our suggested naming scheme is $PREFIX-$NAME, where $PREFIX is some prefix specific to your deployment.
Staging Performing maintenance operations requires in-depth knowledge of AWS and The Things Stack. It is likely that certain action might have unexpected results. For this reason, we strongly advise to maintain a staging environment, and test all updates on staging before deploying to production.
Interoperability
The Things Stack exposes a subset of the Join Server API defined by LoRaWAN® Backend Interfaces 1.0 and 1.1. This is used for interoperability between LoRaWAN networks.
Mutual TLS
The Things Stack supports mutual TLS authentication via a supported proxy (Envoy and Traefik).
Troubleshooting AWS ECS Deployment
This section contains information to troubleshoot The Things Stack deployment.
ECS pulled wrong image version The image tags starting with 3.x contain the latest patch version. For this reason, you should use images starting with 3.x.y, where you specify the desired patch version yourself. Otherwise, when for some reason an ECS task restarts, it can pull the 3.x image again, which could be in the meantime updated to a new patch version.
Template Changelog
Upgrading All meaningful changes to templates are documented in this file.