Set up your computer
Display the file extensions
In Windows 10
- Open Windows explorer
- On the View tab select
- File name extensions
- Hidden items
In Windows 7
- Open Windows Explorer and select Organize
- Select Folder and search options
- On the View tab
- Select Show hidden files, folders, and drives
- Uncheck Hide extensions for known file types
Install a good text editor. If you do not have a favorite, I recommend Notepad ++
- Download it from https://notepad-plus-plus.org/
Configure Notepad ++
- In the Settings menu select Preferences
- In the Language section set the Tab size to 2 and select Replace by space
If you use two-factor authentication see Create a Personal Access Token to use it as password in the command line tools at Switching to 2-factor authentication in GitHub
- Navigate to https://git-scm.com/download/win to download Git for Windows. The page automatically downloads the installer for the operating system you use.
- Install the application
- Accept the default values, including these:
- Make sure the Windows Explorer integration for Git Bash is checked.
- Enable the Git tools in the command prompt too
- Line endings for Windows computers
- Terminal emulator
- Finish the installation
- Make sure the Windows Explorer integration for Git Bash is checked.
Configure Git for Windows
Enable Page Up and Page Down
- In Windows Explorer right click in the white area and select Git Bash Here,
- Stretch the Bash window to the full width of the page to have more room to work later,
- Right click the Bash window and select Options…,
- On the Window tab,
- Click the Current size button to save the size,
- Select PgUp and PgDn scroll without modifier to be able to scroll quickly up and down in the window with the Page up and Page down buttons.
Set up Git Bash to always run as Administrator
Certain commands need elevated rights to run, so we will set up the Bash window to run as administrator.
- In Windows 7 click the Windows Start button and type bash
- Right click the found link and select Properties
- On the Compatibility tab select Run this program as administrator
Configure the Git command line tool
To configure Git see Git configuration.
Download Virtual Box from https://www.virtualbox.org/wiki/Downloads and follow the instructions to install it.
At the time of writing this was the section where the installer files were referenced
Run the downloaded installer file and accept all default values.
The installer starts the Virtual Box application.You can close it, we will use other tools to start it in the future.
To be able to launch 64 bit guest operating systems turn off Hyper-V in Windows Features
- In the Windows search box enter Windows Features and select Turn Windows Features on or off,
- Uncheck Hyper-V and click OK,
- Reboot the computer for the setting to take effect.
To share the connectivity of the host computer with the virtual machine, mainly if you use VPN
- In Virtual box click Settings
- Select Network
- Attach the network adapter to NAT
Copy and paste
To enable copy and paste between the virtual machine and the host ( your workstation )
- On the General tab of the Settings page select the Bidirectional shared clipboard
Specify the shared folder on your workstation
- In the VirtualBox menu select Preferences
- On the Shared Folders tab click the + icon
- To share the entire system drive, select the C: drive of your workstation
Enable shared folders on the virtual machines
To enable the shared folders on the virtual machine and other configurations see Virtual machine configuration at VirtualBox
For Vagrant installation see Vagrant.
- Download Ruby from http://rubyinstaller.org/downloads
- Install the 32 bit version, as the 64 bit version is fairly new and has compatibility issues. Download the latest Ruby installer. Pick the file that does not have the (x64) at the end.
- Accept the default values but check Add Ruby executables to your PATH
Ruby Development Kit
The Ruby Development Kit is need for certain Ruby gems, so install it.
- Download the Ruby Development Kit from the DEVELOPMENT KIT section of http://rubyinstaller.org/downloads
- If you have installed the 32 bit version of Ruby make sure you install the 32 bit version of the DevKit. Select the Development kit that matches the Ruby version you installed. At the time of writing the latest development kit is under “For use with Ruby 2.0 and above (32bits version only)”
- Run the installer to extract it to a permanent location (C:\RubyDevKit)
- Open a command window in the C:\RubyDevKit folder
- Run these commands in the command prompt to install it.
ruby dk.rb init
ruby dk.rb install
- For more information see http://github.com/oneclick/rubyinstaller/wiki/Development-Kit
Chef Development Kit
- Download the Chef Development Kit from https://downloads.chef.io/chef-dk/
Follow the instructions to install it.
Terraform by Hashicorp
- Download Terraform from https://www.terraform.io/downloads.html
- Unzip the downloaded package to C:\HashiCorp\Terraform
- Add the Terraform directory to the path of the computer. It is not added automatically on 64 bit Windows.
- In Windows Explorer right click Computer and select Properties,
- On the left side select Advanced System Settings,
- At the bottom click the Environment Variables… button,
- In the System Variables box select Path and click the Edit… button,
- Add the following to the end of the Variable value. (Don’t forget to start with the semicolon as the separator).
- To create RDS (Relational Database Service) instances in AWS, install the Amazon Web Services Command Line Interface (See instructions below)
- Configure the GitBash window to run as administrator to be able to execute the “terraform get” command to get local modules during development
- Right click the shortcut of the Bash window you use and select Properties
- On the Compatibility tab check Run this program as an administrator
For more details see https://www.terraform.io/intro/getting-started/install.html
Graphviz is a Dependency Graph Visualization Software. We will use this utility to display the Terraform graphs.
- Download from http://www.graphviz.org/Download..php
There are really two dots in the address :-)
- Execute the installer
- You may need to add the location to the Path environment variable. Make sure you use the actual folder name, as it contains the version of the application.
;C:\Program Files (x86)\GraphvizX.XX\bin
The Amazon Web Services command line interface installation will set up your workstation to launch instances in AWS from Test Kitchen. If you know you will work with AWS, see DevOps Engineering part 3. – Working with AWS for the AWS CLI installation.
We use Packer to create custom AWS AMIs that contain the fundamental configuration and applications that are common in every instance we launch.
- Download and install packer from https://www.packer.io/docs/installation.html
- Add Packer executable or installation directory to system path
If you want to host Chocolatey packages internally install Chocolatey.
The Chocolatey home page is at https://chocolatey.org/
- Open a command prompt as Administrator
- Install Chocolatey
@powershell -NoProfile -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
Apply the Chocolatey license
- Place the Chocolatey license file, chocolatey.license.xml into C:\ProgramData\chocolatey\license
- Install the Chocolatey extensions
choco upgrade chocolatey.extension -y
Ignore the error:
Error when attempting to load chocolatey licensed assembly. Ensure
that chocolatey.licensed.dll exists at
Install with `choco install chocolatey.extension`.
The error message itself may be helpful as well:
The system cannot find the file specified. (Exception from HRESULT: 0x80070002)
to the Tutorials page