You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/vi/vagranttutorial.md
+15-9Lines changed: 15 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -7,22 +7,22 @@
7
7
8
8
## Introduction
9
9
10
-
**[Vagrant](https://www.vagrantup.com/)is an open-source software product for building and maintaining portable virtual software development environments.** Below, you will find some basic instructions on interacting with Vagrant through the command-line interface (CLI). You should be familiar with this since you will need to use it to control virtual machines during your internship.
10
+
**First, we will set up our PC for virtualization. Virtualization is when your PC uses some of its hardware as if it is running another system (e.g. running Linux on a Windows PC, or vice versa). Then, we will install Vagrant. Vagrant is an open-source software product for building and maintaining portable virtual software development environments, which requires our PC to be able to virtualize.** Below, you will find some basic instructions on setting up your PC to interact with Vagrant through the command-line interface (CLI). You should be familiar with this since you will need to use it to control virtual machines during your internship.
11
11
12
12
## Preparation
13
13
14
-
Before installing Vagrant we must setup the cli repository, enable virtualization on our computer, and install VirtualBox.
14
+
Before installing Vagrant, we must set up the cli repository, enable virtualization on our computer, and install VirtualBox.
15
15
16
-
`NOTE: You should have at least 7 GB of free storage space this step.`
16
+
`NOTE: You should have at least 7 GB of free storage space for this step.`
17
17
18
18
19
19
#### Windows – Pick your command-line program
20
20
21
-
There are three command-line programs you could use to interact with Vagrant CLI:
21
+
There are three command-line programs you could use for the rest of this tutorial:
22
22
23
23
1.**Git Bash**: This is our recommended command line program. **Git Bash** is already installed along with planet installation script. After you open **Git Bash**, you will find its default directory at `C:\Users\YOUR_USERNAME`.
24
24
25
-
2.**Command Prompt**: There are two Command Prompt options on Windows: **Command Prompt** and **Command Prompt(Admin)**. You could use either of them to access directories and interact with Vagrant CLI. The only difference is their default directory: **Command Prompt(Admin)** has `C:\Windows\system32` as default directory and **Command Prompt** has `C:\Users\YOUR_USERNAME` as the default directory.
25
+
2.**Command Prompt**: There are two Command Prompt options on Windows: **Command Prompt** and **Command Prompt(Admin)**. You could use either of them to access directories. The only difference is their default directory: **Command Prompt(Admin)** has `C:\Windows\system32` as default directory and **Command Prompt** has `C:\Users\YOUR_USERNAME` as the default directory.
26
26
27
27
3.**Windows PowerShell**: Windows PowerShell is a default shell interface installed on your machine, its default directory is `C:\Users\YOUR_USERNAME`.
28
28
@@ -31,11 +31,11 @@ Example: If you see an instruction saying `cd desktop/treehouses/cli` instead us
31
31
32
32
#### macOS or GNU\Linux - Terminal
33
33
34
-
Normally we use a terminal emulator to interact with Vagrant CLI
34
+
Normally we use a terminal emulator.
35
35
36
-
## Stay in the Right Directory
36
+
## Clone (Copy) the Treehouses Repository Files to Your PC
37
37
38
-
A lot of Vagrant commands require us to specify a target machine. We can also run those commands from a directory with the target machine’s Vagrant File. Otherwise, you may encounter an error like "A Vagrant environment or target machine is required." Please go to the directory that contains our Vagrant file:
38
+
`git clone` is a command to download a git project from an online repository (collection of files) to your computer. You will need a local copy of these files throughout your internship.
39
39
40
40
Windows users should do the following:
41
41
- Go into git bash and clone using `git clone https://github.com/treehouses/cli`
@@ -60,7 +60,7 @@ Windows users should do the following:
60
60
macOS or Linux users should do the following:
61
61
- In your command line interface type the following: `brew cask install virtualbox` or `sudo apt-get install virtualbox`
62
62
63
-
Last, we must install Vagrant so we can move onto the next steps
63
+
Last, we must install [Vagrant](https://www.vagrantup.com/) so we can move onto the next steps
64
64
65
65
Windows users should do the following:
66
66
- Go to https://www.vagrantup.com/downloads.html and select windows hosts to install Vagrant
@@ -70,6 +70,12 @@ macOS or Linux users should do the following:
70
70
- In your command line interface type the following: `brew cask install vagrant` or `sudo apt-get install vagrant`
71
71
72
72
73
+
## Go to Vagrant's Directory
74
+
75
+
A lot of Vagrant commands require us to specify a target machine. We can also run those commands from a directory with the target machine’s Vagrant File. Otherwise, you may encounter an error like "A Vagrant environment or target machine is required." Please go to the directory that contains our Vagrant file:
76
+
Windows users should do the following: `cd C:\Users\%USERNAME%\cli`
77
+
macOS or Linux users should do the following: `cd Desktop`
78
+
73
79
## Global Status
74
80
75
81
[`vagrant global-status`](https://www.vagrantup.com/docs/cli/global-status.html) will tell us the state of all active Vagrant environments on the system for the currently logged in user. You will see something similar to this:
0 commit comments