Intro
This KB is dedicated to resolve Terraform Enterprise failure after upgrade to version v202111-1 or later.
Problem description
As of Terraform Enterprise v202111-1, certain application container images were updated to use Alpine 3.14 which has specific Docker, runc, and libseccomp version requirements. If the minimum docker engine requirements are not met after Terraform Enterprise upgrade to v202111-1, Terraform Enterprise fails to start with various errors (please note that after Terraform Enterprise v202205-1, this container is called `tfe-atlas` rather than `ptfe_atlas`).
For example:
ptfe_atlas: ExecJS::RuntimeUnavailable: Could not find a JavaScript runtime. See https://github.com/rails/execjs for a list of available runtimes.
ptfe_atlas/ptfe_sidekiq/ptfe_migrations are throwing this error `/root` is not writable
Solution
See Docker Engine Requirements for the specific Docker, runc, and libseccomp version requirements.
The Docker Engine configurations are ordered by preference and include installation instructions. Prior to selecting one of the 3 options and walking through the installation instructions, you will need to stop Terraform Enterprise.
Stop Terraform Enterprise and Replicated
sudo replicatedctl app stop
sudo systemctl stop replicated replicated-ui replicated-operator
Select one of the options shown below. Update the docker version as required and other packages as applicable to meet the minimum docker engine requirements.
Option 1: Docker Engine With a Compatible runc Version
Option 2: Docker Engine With a Compatible libseccomp Version
Option 3: Docker Engine Using a Modified libseccomp Profile
If the docker version was updated you may need to unmask the docker service
sudo systemctl unmask dockersudo systemctl start docker
Start Replicated and Terraform Enterprise
sudo systemctl start replicated replicated-operator replicated-uireplicatedctl app start