/endjin-workstation-setup

Primary LanguageBicep

endjin-workstation-setup

This repository helps you setup your development workstation and provides an ongoing mechanism for managing the software you need.

It targets two core scenarios:

  1. Using an Azure virtual machine - go here to get started
  2. Using an existing Windows system you already have access to (e.g. a new laptop) - go here to get started

The intention is that you fork this repo into your own GitHub account and customise the configuration as required - this repo will then provide you with a mechanism to rapidly get yourself up-and-running in the event of using a new machine or after fresh install of Windows on your existing machine.

Using an Existing Windows Machine

If you already have a suitable Windows machine, then check whether you have the following pre-requisites already available:

PowerShell Core

Chocolatey

  • Chocolatey is a tool for installing software onto Windows. It takes care of a lot of the pain in installing software.

  • To install, follow the instructions at Installing Chocolatey .

Use Chocolatey to install Git:

`choco install -y git`

Installing Windows Subsystem for Linux (aka WSL)

For the moment the most reliable way to install Windows Subsystem for Linux is to follow the manual process documented here

Managing your installed software

  1. If you haven't already done so, fork this repository into your own GitHub account via the 'Fork' option in the top right of this page you are reading
  2. Create a directory where you will store all the git repositories you work with (e.g. md C:\code)
  3. Open a new elevated 'Windows PowerShell' terminal from the Start Menu (Run as Administrator)
  4. cd into the folder you created above (e.g. cd C:\code)
  5. Clone this repository to your machine: git clone https://github.com/<your-github-username>/endjin-workstation-setup.git
  6. Move into the directory created by the above command (e.g. cd endjin-workstation-setup)
  7. The list of packages that will be installed can be found in the setup-chocolatey-packages.config file, adding any further packages you require - use the Chocolatey web site to search the available packages
  8. Allow local powershell scripts to executed by running Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Force
  9. Run ./setup.ps1 to begin the software install process
  10. If you made any changes to the setup-chocolatey-packages.config file, you can commit them and push them up to GitHub so they are safely stored