LainyZine: 프로그래머 가이드 🐣

맥에서 Vagrant 설치 및 삭제하는 방법

베이그런트(Vagrant)는 Hashicorp에서 개발한 가상 머신과 개발 환경 관리를 자동화할 수 있도록 도와주는 도구입니다. 가상 머신 정의를 루비(Ruby) 기반의 DSL로 작성할 수 있으며, 가상 머신 정의는 물론 생성 및 관리, 환경 구축을 위한 프로비저닝까지 관리할 수 있습니다. 또한 이 가상 머신을 Box로 만들어 다른 협업자와 같은 환경을 공유하는 것도 가능합니다.

이 글에서는 맥(macOS)에서 Vagarnt를 설치하는 방법과 삭제하는 방법을 소개합니다. 윈도우에서 Vagrant를 설치하는 방법은 다음 글에서 소개합니다.

맥에서 Vagrant를 설치하는 방법은 크게 Homebrew를 사용하는 방법과 공식 홈페이지에서 다운로드 받는 방법이 있습니다. 하나씩 살펴보도록 하겠습니다.

Homebrew로 Vagrant 설치하는 방법

먼저 Homebrew를 사용해 Vagrant를 설치해보겠습니다. Homebrew를 사용하면 설치 및 삭제를 명령어 하나로 손쉽게 할 수 있기 때문에, 최신 버전을 사용하고 싶다면 이 방법을 추천합니다. 먼저 Homebrew 설치에 대해서는 자신의 환경에 따라서 다음 글들을 참고해주세요.

Homebrew만 설치되어있으면 한 방에 Vagrant를 설치할 수 있습니다. 다음 명령어를 실행합니다. 설치 과정에서 현재 사용자의 암호를 물어봅니다.

$ brew install vagrant
...
==> Homebrew was updated to version 3.3.3
The changelog can be found at:
  https://github.com/Homebrew/brew/releases/tag/3.3.3
==> Downloading https://releases.hashicorp.com/vagrant/2.2.19/vagrant_2.2.19_x86_64.dmg
######################################################################## 100.0%
==> Installing Cask vagrant
==> Running installer for vagrant; your password may be necessary.
Package installers may write to any location; options such as `--appdir` are ignored.
Password:
installer: Package name is Vagrant
installer: Installing at base path /
installer: The install was successful.
🍺  vagrant was successfully installed!

정상적으로 설치가 완료되었습니다. 설치가 된 것을 확인하기 위해 --version 옵션을 붙여서 실행해봅니다. which로 실행 파일의 위치도 함께 확인해봅니다.

$ vagrant --version
Vagrant 2.2.19
$ which vagrant
/usr/local/bin/vagrant

Vagrant 2.2.19 버전이 설치되었으며, /usr/local/bin 디렉터리에 설치된 것을 확인할 수 있습니다.

Homebrew로 설치한 Vagrant 삭제하는 방법

Homebrew로 Vagrant를 설치했다면, 삭제도 명령어 하나로 가능합니다. 다음 명령어를 실행하면 Vagrant가 삭제됩니다.

$ brew uninstall vagrant

Hashicorp Vagrant 공식 사이트에서 다운로드 하는 방법

Vagrant를 설치하는 두 번째 방법은 공식 사이트에서 다운로드 받는 방법입니다. Hashicorp Vagrant 공식 웹 사이트에서는 Vagrant 최신 버전을 제공하고 있습니다. 아래 사이트로 이동해서 macOS 탭을 선택하고 오른쪽 링크로 최신 버전을 다운로드 받아주세요.

Vagrant 공식 다운로드 페이지

다운로드 받은 파일은 dmg 이미지입니다. 이 파일을 실행하면 pkg 파일이 포함된 파인더 창이 열립니다.

dmg 파일을 열면 pkg 파일이 있습니다

pkg 파일은 맥OS에서 실행 가능한 소프트웨어 인스톨러입니다. 이 파일을 실행합니다. 안내에 따라 설치를 진행합니다.

인스톨러 안내에 따라 Vagrant를 설치합니다

설치가 완료되면 Terminal 앱이나 iTerm2 앱을 열어 Vagrant가 잘 설치되었는지 확인해봅니다.

$ vagrant --version
Vagrant 2.2.19
$ which vagrant
/usr/local/bin/vagrant

2021년 11월 현재 최신 버전인 2.2.19 버전이 설치된 것을 확인할 수 있습니다.

패키지로 설치한 Vagrant 삭제하는 방법

패키지로 설치한 Vagrant를 삭제하려면 설치할 때 사용한 해당 버전의 dmg 파일이 필요합니다. 구 버전을 삭제하려는 경우, 구 버전의 dmg 파일이 필요합니다. 이 파일을 별도로 보관하거나 뒤에서 소개하는 구 버전 다운로드 방법을 참고해주세요.

dmg 파일을 열어서 자세히 살펴보면 pkg 파일 아래에 uninstall.tool라는 파일이 보입니다.

Vagrant를 삭제하려면 dmg 파일에 포함된 uninstall.tool을 실행합니다

이 파일을 실행해봅니다. 하지만 이 파일이 스크립트라서 보안 상 바로 실행되지 않습니다.

보안 문제로 uninstall.tool이 바로 실행되지 않습니다

위와 같은 경고 창이 나타나는 경우, 먼저 ‘시스템 환경설정’의 ’보안 및 개인 정보 보호’ 설정 창을 엽니다. 실행한 직후에 이 창을 열면 창 아래 쪽에 uninstall.tool이 차단되었다는 내용을 확인할 수 있습니다. 오른쪽의 ‘확인 없이 열기’ 버튼을 클릭합니다.

보안 및 개인 정보 보호 설정에서 uninstall.tool을 실행합니다

한 번 더 경고가 나타납니다. 경고 내용을 숙지하고, Vagrant 삭제 스크립트를 실행하려면 열기를 선택합니다.

uninstall.tool 스크립트를 실행하기 전에 보안 경고가 나타납니다

터미널 창이 열리고 스크립트가 실행됩니다. 삭제할 파일 목록이 출력되고 정말 삭제할지 물어봅니다. Yes를 입력하면 Vagrant가 삭제됩니다.

자동으로 터미널이 열리고 삭제 스크립트가 실행 됩니다.

이제 vagrant 명령어를 실행하면, 명령어가 없다는 에러가 출력되면서 실행되지 않습니다.

$ vagrant
zsh: command not found: vagrant

Vagrant 과거 버전 설치하는 방법

Homebrew나 Vagrant 공식 다운로드 페이지에서 최신 버전을 손쉽게 설치할 수 있습니다. 과거의 특정 버전을 설치하고자 하는 경우 Hashicorp에서 공식적으로 제공하는 릴리스 페이지에서 찾을 수 있습니다. 아래 주소로 접속하면 Vagrant 버전별로 공식 릴리스를 다운로드 받을 수 있습니다.

이전 Vagrant 릴리스를 다운로드 받을 수 있습니다

목록에 보이는 링크는 버전 별 디렉터리입니다. 예를 들어 macOS에서 2.2.6 버전을 설치하고자 하면, vagrant_2.2.6 디렉터리로 이동해서 vagrant_2.2.6_x86_64.dmg 파일을 다운로드 받아 설치를 진행합니다.

여기까지 Vagrant를 설치하고 삭제하는 방법에 대해서 알아보았습니다.

LainyZine은 쿠팡 파트너스 활동에 따른 수수료를 제공받습니다.