본문 바로가기
IaC/Terraform

[Terraform] MacOS에 Terraform 설치 하기

by chan10 2025. 7. 20.

Infrastructure as Code(IaC)를 위한 대표적인 도구인 Terraform은 클라우드 인프라를 코드로 선언하고 관리할 수 있게 해주는 매우 강력한 툴입니다. 특히 여러 클라우드 제공자(AWS, Azure, GCP 등)를 동시에 다룰 수 있어, 멀티 클라우드 환경에서도 높은 유연성을 제공합니다.

이 글에서는 macOS 환경에서 Homebrew를 이용해 Terraform을 설치하는 방법과, 설치 이후 생산성을 높여주는 명령어 자동 완성 기능까지 설정하는 전체 과정을 정리했습니다.

 

Homebrew 이용한 설치

macOS에서는 Homebrew를 이용해 간편하게 설치할 수 있습니다. 다음 명령어를 터미널에 입력합니다.

brew tap hashicorp/tap
brew install hashicorp/tap/terraform

`hashicorp/tap`을 등록하고 Terraform 패키지를 설치하는 과정입니다. 설치가 완료되면 `terraform` 명령어를 사용할 수 있습니다.

 

설치 확인

Terraform이 정상적으로 설치되었는지 확인하려면 다음 명령어를 사용합니다.

terraform -help

정상적으로 설치되었다면 다음과 같은 주요 커맨드 목록이 출력됩니다.

➜  ~ terraform -help
Main commands:
  init          Prepare your working directory for other commands
  validate      Check whether the configuration is valid
...

설치된 Terraform의 버전을 확인하고 싶다면 다음 명령어를 사용합니다.

terraform --version

버전 정보가 제대로 출력되면 설치가 완료된 것입니다.

➜  ~ terraform --version
Terraform v1.12.1
on darwin_arm64

 

자동 완성 기능 활성화

Terraform은 명령어 자동 완성 기능을 제공합니다. 이 기능을 활성화하면 커맨드라인에서 `terraform <tab>` 입력 시 관련 명령어를 자동으로 추천해주기 때문에 생산성을 높일 수 있습니다.

터미널 셸이 `bash`인지 `zsh`인지에 따라 설정 방식이 달라지므로, zsh 쉘 환경에서는 다음과 같은 설정이 필요합니다.

 

먼저 아래 명령어를 실행하여 자동 완성 스크립트를 설치합니다.

terraform -install-autocomplete

이 명령어는 사용 중인 쉘 설정 파일(`~/.zshrc` 또는 `~/.bashrc`)에 필요한 자동 완성 설정을 자동으로 추가해줍니다.

 

설정이 잘 반영되었는지 확인하려면 다음 명령어로 `.zshrc` 파일을 확인합니다

cat ~/.zshrc

출력 내용 중 아래와 같은 설정이 포함되어 있다면 자동 완성 기능이 제대로 설정된 것입니다.

autoload -U +X bashcompinit && bashcompinit
complete -o nospace -C /opt/homebrew/bin/terraform terraform

만약 위 설정이 없다면 직접 추가해도 됩니다.

 

설정 반영을 위해 `.zshrc`를 다시 로드하거나 터미널을 재시작합니다.

zsh

이제 `terraform` 명령어를 입력할 때 Tab 키로 자동 완성 기능을 사용할 수 있습니다.

 

 

[참고사이트]

https://chinkl.tistory.com/entry/IaC-Terraform-설치-Mac-OS