---
id: gh-huawei-cloud-terraform-installer
name: "huawei-cloud-terraform-installer"
url: https://skills.yangsir.net/skill/gh-huawei-cloud-terraform-installer
author: huaweicloud
domain: cloud-infra
tags: ["terraform", "huawei-cloud", "installer", "cli", "devops"]
install_count: 17000
rating: 4.60 (120 reviews)
github: https://github.com/huaweicloud/huaweicloud-skills/tree/master/skills/devtools/terraform/huawei-cloud-terraform-installer
---

# huawei-cloud-terraform-installer

> 此技能可跨平台自动安装 Terraform CLI，默认使用华为云镜像以避免 GitHub 网络问题，支持版本指定、初始化、测试、卸载等操作。适用于需要快速搭建 Terraform 环境的开发者和运维团队，简化安装流程并提高可靠性。

**Stats**: 17,000 installs · 4.6/5 (120 reviews)

## Before / After 对比

### 安装耗时对比

**Before**:

在没有此技能之前，用户需要手动下载 Terraform 二进制文件、配置环境变量，并可能因 GitHub 网络问题反复重试。整个过程耗时且容易出错，尤其对于不熟悉命令行操作的用户。

**After**:

使用此技能后，只需运行一条命令即可自动完成 Terraform 的安装和初始化，默认采用华为云镜像，有效避免网络延迟和超时问题，几分钟内即可开始使用。

| Metric | Before | After | Change |
|---|---|---|---|
| 安装耗时 | 60分钟 | 10分钟 | -83% |

## Readme

# Huawei Cloud Terraform Installer

Cross-platform Terraform CLI installation with **Huawei Cloud mirror** by default
(avoids GitHub network issues).

## Prerequisites

- **Python 3.6+** (required for installation script)
- Network access to:
  - `releases.hashicorp.com` (Terraform binary)
  - `mirrors.huaweicloud.com` (HuaweiCloud Provider)

## Platform Support

| Platform | Method | Notes |
|----------|--------|-------|
| **Linux** | Binary | Direct binary download |
| **Windows** | Binary | Direct download |

**Why use binary download only?**

- Simpler and more reliable across all platforms
- No dependency on package manager availability
- Consistent behavior for troubleshooting

**Note:** macOS is not currently supported.

### Windows Special Notes

**Provider installation method:**

- Use `filesystem_mirror` (local file mirror)
- Download zip from Huawei Cloud mirror, extract to local
- Configure `terraform.rc` to point to local directory

**Unsupported methods:**

- ❌ `direct` (Registry → GitHub): GitHub timeout
- ❌ `network_mirror`: Huawei Cloud mirror directory structure incompatible

## Quick Start

### Basic Installation

```bash
# Auto-install (default to Huawei Cloud mirror)
python scripts/install_terraform.py

# Install + Initialize
python scripts/install_terraform.py --init

# Install + Test
python scripts/install_terraform.py --test
```

### Specify Version

```bash
# Install specific version
python scripts/install_terraform.py --version 1.15.4
```

### Other Operations

```bash
# Check status only
python scripts/install_terraform.py --check

# Uninstall
python scripts/install_terraform.py --uninstall
```

## Mirror Strategy

| Resource | Source | Notes |
|----------|--------|-------|
| Terraform binary | HashiCorp Releases | Official source |
| Provider | Huawei Cloud Mirror (default) | Avoid GitHub network issues |

**Huawei Cloud Mirror:** `https://mirrors.huaweicloud.com/terraform/`

## Troubleshooting

### Issue 1: Windows PATH Not Effective

**Solution:** Reopen terminal (PowerShell/CMD)

### Issue 2: Permission Denied

```text
[ERROR] Permission denied, please run with administrator privileges
```

**Solution:**

- Windows: Right-click → Run as administrator
- Linux: `sudo python3 install_terraform.py`

### Issue 3: Network Timeout

**Solution:** Default uses Huawei Cloud mirror, should not encounter this issue


---
*Source: https://skills.yangsir.net/skill/gh-huawei-cloud-terraform-installer*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-huawei-cloud-terraform-installer/markdown*