Problem
An outdated version of the Replicated container is unable to pull updated container images during a Terraform Enterprise upgrade. This issue may present as the following error message.
API error (404): No such image: registry.replicated.com/...
Cause
This issue can occur when upgrading from Terraform Enterprise v202004-1 or when using versions of Replicated 2.44.0 and older.
This is related to a change made by Replicated in version 2.45.0, where public Docker images were moved from Quay.io to Docker Hub. This includes the replicated/replicated, replicated/replicated-ui, and replicated/replicated-operator images.
Solutions
There are two methods to resolve this issue, depending on your Terraform Enterprise installation type.
Solution 1: Manually Upgrade Replicated
This non-destructive method is recommended, especially if you are unsure of your installation type. Manually upgrading Replicated to the latest version resolves the image pull issue without requiring a full reinstallation of Terraform Enterprise.
Follow the official instructions in the Replicated Installation documentation to perform the upgrade.
Solution 2: Reinstall Terraform Enterprise
Reinstalling Terraform Enterprise will also resolve this issue, as the installation process automatically pulls the latest version of Replicated.
Refer to the Installing Terraform Enterprise guide for detailed instructions.
Outcome
After successfully applying one of the solutions, you should be able to upgrade Terraform Enterprise without encountering errors related to quay.io.