Introduction
Terraform Enterprise installations in Europe are taking several times longer to download the Terraform Enterprise containers from the Replicated Registry. This impacts both new installations as well as Terraform Enterprise version upgrades.
Problem
Starting around February 15th, 2022, the Replicated Registry hosting the Terraform Enterprise containers started facing significant download slowdowns from the European region. Replicated has acknowledged the issue and is currently investigating.
Solutions
Using airgap bundles will allow pre-loading the container images required for Replicated and Terraform Enterprise on the instance, avoiding the use of the Replicated Registry altogether. There is a link to download these airgap bundles and an auto-generated password for authentication to it. A CSM or account manager can assist in accessing the airgap bundles.
On a new installation
The installation process is nearly identical to a standard installation. The major difference is that in the /etc/replicated.conf JSON, a LicenseBootstrapAirgapPackagePath key should be added pointing to the airgap bundle on the instance; and for the install.sh invocation, the parameter airgap will need to be added. For additional details and context, see the following items
- Airgap installation document for Interactive installations: https://www.terraform.io/enterprise/install/interactive/installer#run-the-installer-airgapped
- Airgap installation document for Automated installations: https://www.terraform.io/enterprise/install/automated/automating-the-installer#airgapped
During an upgrade
For an existing Terraform Enterprise installation that is having difficulty updating versions, please refer to this Knowledgebase Article for converting from online to airgapped installation modes: https://support.hashicorp.com/hc/en-us/articles/4415209944339-How-to-convert-from-Online-Install-to-Airgap-and-back-
As always, if additional help is required, please reach out to HashiCorp Support.