mirror of https://github.com/hashicorp/terraform
Consolidate install pages (#36798)
Brian McClain
1 year ago
committed by
GitHub
parent
c0a7ff235b
commit
568a6f9a1e
@ -1,89 +0,0 @@
|
||||
---
|
||||
page_title: Install Terraform using APT packages for Debian and Ubuntu
|
||||
description: >-
|
||||
Learn how to install Terraform using HashiCorp APT packages for Debian and Ubuntu systems.
|
||||
---
|
||||
|
||||
# Install Terraform Using APT Packages for Debian and Ubuntu
|
||||
|
||||
The primary distribution packages for Terraform are `.zip` archives containing
|
||||
single executable files that you can extract anywhere on your system. However,
|
||||
for easier integration with configuration management tools and other systematic
|
||||
system configuration strategies, we also offer package repositories for
|
||||
Debian and Ubuntu systems, which allow you to install Terraform using the
|
||||
`apt install` command or any other APT frontend.
|
||||
|
||||
If you are instead using Red Hat Enterprise Linux, CentOS, or Fedora, you
|
||||
might prefer to [install Terraform from our Yum repositories](/terraform/cli/install/yum).
|
||||
|
||||
-> **Note:** The APT repositories discussed on this page are generic HashiCorp
|
||||
repositories that contain packages for a variety of different HashiCorp
|
||||
products, rather than just Terraform. Adding these repositories to your
|
||||
system will, by default, therefore make several other non-Terraform
|
||||
packages available for installation. That might then mask some packages that
|
||||
are available for some HashiCorp products in the main Debian and Ubuntu
|
||||
package repositories.
|
||||
|
||||
## Repository Configuration
|
||||
|
||||
Please follow the instructions in the [Official Packaging Guide](https://www.hashicorp.com/official-packaging-guide).
|
||||
|
||||
## Supported Architectures
|
||||
|
||||
The HashiCorp APT server has packages only for the `amd64`
|
||||
architecture, which is also sometimes known as `x86_64`.
|
||||
|
||||
There are no official packages available for other architectures, such as
|
||||
`arm64`. If you wish to use Terraform on a non-`amd64` system,
|
||||
[download a normal release `.zip` file](/terraform/downloads) instead.
|
||||
|
||||
## Supported Debian and Ubuntu Releases
|
||||
|
||||
The HashiCorp APT server contains release repositories for a variety of
|
||||
supported distributions, which are outlined in the [Official Packaging Guide](https://www.hashicorp.com/official-packaging-guide).
|
||||
|
||||
## Installing a Specific Version of Terraform
|
||||
|
||||
The HashiCorp APT repositories contain multiple versions of Terraform, but
|
||||
because the packages are all named `terraform` it is impossible to install
|
||||
more than one version at a time, and `apt install` will default to selecting
|
||||
the latest version.
|
||||
|
||||
It's often necessary to match your Terraform version with what a particular
|
||||
configuration is currently expecting. You can use the following command to
|
||||
see which versions are currently available in the repository index:
|
||||
|
||||
```bash
|
||||
apt policy terraform
|
||||
```
|
||||
|
||||
If your workflow requires using multiple versions of Terraform at the same
|
||||
time, for example when working through a gradual upgrade where not all
|
||||
of your configurations are upgraded yet, we recommend that you use the
|
||||
official release `.zip` files instead of the APT packages, so you can install
|
||||
multiple versions at once and then select which to use for each command you
|
||||
run.
|
||||
|
||||
### Terraform 1.4.3 and Later
|
||||
|
||||
As of Terraform 1.4.3, all published packages include a revision number by
|
||||
default, starting with `-1`. This change means that in the case that we need
|
||||
to publish an updated package for any reason, installers can automatically
|
||||
retrieve the latest revision. You can learn more about this packaging change
|
||||
in [the announcement](https://discuss.hashicorp.com/t/linux-packaging-debian-revision-change/42403).
|
||||
|
||||
You can install the latest revision for a particular version by including the
|
||||
version in the `apt install` command, as follows:
|
||||
|
||||
```bash
|
||||
sudo apt install terraform=1.4.4-*
|
||||
```
|
||||
|
||||
### Terraform 1.4.2 and Earlier
|
||||
|
||||
Terraform 1.4.2 and earlier did not include a revision number for the first
|
||||
revision, so you can use the following pattern to install a specific version:
|
||||
|
||||
```bash
|
||||
sudo apt install terraform=1.4.0
|
||||
```
|
||||
@ -1,120 +0,0 @@
|
||||
---
|
||||
page_title: Install Terraform using yum packages for Linux distributions
|
||||
description: >-
|
||||
Learn how to install Terraform using HashiCorp yum packages for Red Hat Enterprise Linux (RHEL), Fedora, CentOS, and Amazon Linux systems.
|
||||
---
|
||||
|
||||
# Install Terraform Using Yum Packages for Linux Distributions
|
||||
|
||||
The primary distribution packages for Terraform are `.zip` archives containing
|
||||
single executable files that you can extract anywhere on your system. However,
|
||||
for easier integration with configuration management tools and other systematic
|
||||
system configuration strategies, we also offer package repositories for
|
||||
RedHat Enterprise Linux, Fedora, and Amazon Linux systems, which allow you to
|
||||
install Terraform using the `yum install` or `dnf install` commands.
|
||||
|
||||
If you are instead using Debian or Ubuntu, you
|
||||
might prefer to [install Terraform from our APT repositories](/terraform/cli/install/apt).
|
||||
|
||||
-> **Note:** The Yum repositories discussed on this page are generic HashiCorp
|
||||
repositories that contain packages for a variety of different HashiCorp
|
||||
products, rather than just Terraform. Adding these repositories to your
|
||||
system will, by default, therefore make a number of other non-Terraform
|
||||
packages available for installation. That might then mask the packages that are
|
||||
available for some HashiCorp products in the main distribution repositories.
|
||||
|
||||
## Repository Configuration
|
||||
|
||||
Before adding a repository you must determine which distribution you are using.
|
||||
The following command lines refer to a placeholder variable `$release` which
|
||||
you must replace with the appropriate value from the following list:
|
||||
|
||||
* Red Hat Enterprise Linux: `RHEL`
|
||||
* Fedora: `fedora`
|
||||
* Amazon Linux: `AmazonLinux`
|
||||
|
||||
If you are using a Yum-based distribution, add the repository using
|
||||
`yum-config-manager` as follows:
|
||||
|
||||
```bash
|
||||
sudo yum install -y yum-utils
|
||||
sudo yum-config-manager --add-repo https://rpm.releases.hashicorp.com/$release/hashicorp.repo
|
||||
```
|
||||
|
||||
If you are using a DNF-based distribution, add the repository using
|
||||
`dnf config-manager` as follows:
|
||||
|
||||
```bash
|
||||
sudo dnf install -y dnf-plugins-core
|
||||
sudo dnf config-manager addrepo --from-repofile=https://rpm.releases.hashicorp.com/$release/hashicorp.repo
|
||||
```
|
||||
|
||||
In both cases, the Terraform package name is `terraform`. For example:
|
||||
|
||||
```bash
|
||||
yum install terraform
|
||||
```
|
||||
|
||||
## Supported Architectures
|
||||
|
||||
The HashiCorp Yum/DNF server has packages only for the `x86_64`
|
||||
architecture, which is also sometimes known as `amd64`.
|
||||
|
||||
There are no official packages available for other architectures, such as
|
||||
`aarch64`. If you wish to use Terraform on a non-`x86_64` system,
|
||||
[download a normal release `.zip` file](/terraform/downloads) instead.
|
||||
|
||||
## Supported Distribution Releases
|
||||
|
||||
The HashiCorp Yum server contains release repositories for the
|
||||
following distribution releases:
|
||||
|
||||
* AmazonLinux 2 and "latest"
|
||||
* Fedora 33
|
||||
* Fedora 34
|
||||
* Fedora 35
|
||||
* Fedora 36
|
||||
* Fedora 37
|
||||
* RHEL 7 (and CentOS 7)
|
||||
* RHEL 8 (and CentOS 8)
|
||||
* RHEL 9 (and CentOS 9)
|
||||
|
||||
No repositories are available for other versions of these distributions or for
|
||||
any other RPM-based Linux distributions. If you add the repository using
|
||||
the above commands on other systems then you will see a 404 Not Found error.
|
||||
|
||||
Over time we will change the set of supported distributions, including both
|
||||
adding support for new releases and ceasing to publish new Terraform versions
|
||||
under older releases.
|
||||
|
||||
## Choosing Terraform Versions
|
||||
|
||||
The HashiCorp Yum repositories contain multiple versions of Terraform, but
|
||||
because the packages are all named `terraform` it is impossible to install
|
||||
more than one version at a time, and `yum install` or `dnf install` will
|
||||
default to selecting the latest version.
|
||||
|
||||
It's often necessary to match your Terraform version with what a particular
|
||||
configuration is currently expecting. Use the following command to
|
||||
retrieve the available versions in the repository index:
|
||||
|
||||
```bash
|
||||
yum --showduplicate list terraform
|
||||
```
|
||||
|
||||
You can select a specific version to install by including it in the
|
||||
`yum install` command line, as follows:
|
||||
|
||||
```bash
|
||||
yum install terraform-0.14.0-2.x86_64
|
||||
```
|
||||
|
||||
If you are using a DNF-based distribution, similar use `dnf` instead of `yum`
|
||||
when following the above steps.
|
||||
|
||||
If your workflow requires using multiple versions of Terraform at the same
|
||||
time, for example when working through a gradual upgrade where not all
|
||||
of your configurations are upgraded yet, we recommend that you use the
|
||||
official release `.zip` files instead of the Yum packages, so you can install
|
||||
multiple versions at once and then select which to use for each command you
|
||||
run.
|
||||
Loading…
Reference in new issue