Introduction
An airgapped installation of Terraform Enterprise runs in an environment with no internet access. Organizations use this deployment pattern to enhance security and maintain tight control over the instance. This article outlines key considerations for administrators when planning and performing an upgrade for an airgapped Terraform Enterprise instance.
Scenario
You are an administrator for an airgapped Terraform Enterprise instance and need to perform a version upgrade. Due to the lack of internet connectivity, the standard online upgrade process is not applicable.
Recommendation
Upgrading an airgapped Terraform Enterprise instance requires a different process than an online instance. Keep the following considerations in mind to ensure a successful upgrade.
- Manual Package Transfer: You must download the upgrade package from an internet-connected machine and then securely transfer it to the airgapped Terraform Enterprise instance. The upgrade package is comprehensive and contains all necessary versions to upgrade from your current version to the latest release.
- Upgrade Frequency: HashiCorp recommends upgrading airgapped installations frequently. Significant gaps between upgrades can result in a more complex and time-consuming upgrade process, as the upgrade package will be larger and may involve more intermediate steps.
- Follow Official Guidance: Always refer to the official documentation for the specific steps required for an airgapped upgrade, as the process may vary between versions.
Additional Information
- For detailed instructions, please refer to the official Terraform Enterprise documentation on performing airgapped upgrades.