LainyZine: 프로그래머 가이드 🐣

[Windows 10] Vagrant 설치하는 방법

베이그런트(Vagrant)는 인프라 관련 자동화 도구들을 만드는Hashicorp의 가상 머신 및 개발 환경 관리를 도와주는 도구입니다. 가상 머신 정의를 위한 DSL 코드(Ruby)를 기반으로 가상 머신을 생성, 프로비저닝, 종료할 수 있습니다. 단순히 가상 머신을 관리할 뿐만 아니라, 이 위에서 개발 환경을 셋업하고 Box(가상 머신 이미지)로 만들어 다른 개발자와 같은 개발 환경을 공유하는 것도 가능합니다. 지금은 Docker를 많이 사용합니다만, 이전에는 동일한 개발 환경을 공유하는 용도로도 많이 사용되었습니다.

이 글에서는 윈도우에서 Vagrant를 설치하는 방법을 소개합니다. 윈도우에서 Vagrant는 크게 인스톨러와 패키지 매니저 Chocolatey로 설치할 수 있습니다. 커맨드라인에 익숙하다면 명령어 하나로 간편하게 설치할 수 있는 Chocolatey 방식을 추천합니다.

Vagrant 다운로드하고 설치하기

Vagrant를 사용하려면 먼저 공식 웹사이트에서 인스톨러를 다운로드하고 설치를 진행해야합니다. 다음 페이지에서 최신 버전 Vagrant를 다운로드 받을 수 있습니다.

Windows 탭을 선택하고 자신에게 맞는 비트를 선택해줍니다. 현재 운영체제의 비트수는 윈도우의 PC 정보 설정에서 확인할 수 있습니다.

공식 웹사이트에서 Vagrant를 다운로드 받습니다

다운로드 받은 vagarnt_xxx.msi 파일을 실행합니다.

인스톨러가 실행됩니다. 안내에 따라 설치를 진행합니다

Next 버튼을 클릭해 설치를 진행합니다. 차례대로 라이센스 동의 및 설치 경로 지정을 진행합니다. 여기서는 기본 경로를 그대로 사용합니다.

Install 버튼을 클릭합니다

Install 버튼을 클릭하면 설치가 시작됩니다. 설치 과정에서 관리자 권한이 필요해서 사용자 권한 컨트롤 팝업이 나타납니다. 설치는 자동으로 진행되며 몇 분 정도면 완료됩니다. 설치가 완료되면 Finish 버튼을 클릭해 인스톨러를 종료합니다.

인스톨러가 종료되면 재부팅이 필요하다는 메시지가 나타납니다. 지금 바로 재부팅하려면 Yes 버튼을 클릭하고, 나중에 재부팅 하려면 No를 선택합니다. Vagarnt를 정상적으로 사용하려면 사용 전에 한 번은 재부팅해야합니다.

Vagrant를 사용하려면 재부팅을 해야합니다

Windows Terminal을 열어 Vagrant가 정상적으로 설치되었는지 확인해봅니다. vagrant -v 명령어를 실행해봅니다. 설치한 버전이 나온다면 정상입니다. 버전은 설치한 시점에 따라 다를 수 있습니다.

Vagrant가 정상적으로 설치되었는지 실행해봅니다

Vagrant 특정 버전을 설치하는 방법

HashiCorp Releases 페이지에서 과거 버전의 인스톨러들을 다운로드 받을 수 있습니다. 아래 페이지로 이동하고 원하는 버전의 디렉터리를 선택해줍니다.

여러가지 파일들이 있습니다만, 이 중에서 msi 확장자를 가진 파일들이 윈도우용 Vagrant 인스톨러입니다. 2.2.0 버전의 경우를 예로 들억보겠습니다.

자신의 환경에 맞는 인스톨러를 다운로드 받아 설치를 진행하면 특정 버전을 설치할 수 있습니다.

패키지 매니저 Chocolatey로 설치하는 방법

윈도우 용 패키지 매니저 Chocolatey를 사용하면 명령어 하나로 Vagrant를 설치할 수 있습니다. 단, 미리 패키지 매니저 Chocolatey가 설치되어있어야 합니다.

관리자 모드로 윈도우 터미널이나 파워셸을 실행하고 다음 명령어를 실행하면 Vagrant가 설치됩니다. 자동으로 현재 시스템에 맞는 Vagrant 최신 버전을 설치해줍니다.

$ choco install -y vagrant
Chocolatey v0.10.15
Installing the following packages:
vagrant
By installing you accept licenses for the packages.
Progress: Downloading vagrant 2.2.18.20210807... 100%
...
Packages requiring reboot:
 - vagrant (exit code 3010)

The recent package changes indicate a reboot is necessary.
 Please reboot at your earliest convenience.

마지막 메시지에서 확인할 수 있듯이 Vagrant 설치 후에는 재부팅이 필요합니다.

choco로 Vagrant를 설치한 경우, 다음 명령어로 삭제할 수 있습니다.

$ choco uninstall vagrant

Chocolatey로 설치하는 패키지에 대한 상세한 정보는 다음 페이지에서 확인할 수 있습니다.

부록: VirtualBox 설치하는 방법

Vagrant는 단독으로 사용할 수 없습니다. VirtualBox, VMWare, Docker, Hyper-V 등 프로바이더를 통해서 가상 머신을 실행하고 관리합니다. 가장 무난하게 사용해볼 수 있는 프로바이더는 VirtualBox입니다.

물론 필요에 따라서 다른 프로바이더를 사용해도 무방합니다. 자세한 정보는 Vagrant의 공식 문서를 참고해주세요.

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