Skip to content

Latest commit

 

History

History
107 lines (60 loc) · 4.38 KB

1. setup.md

File metadata and controls

107 lines (60 loc) · 4.38 KB
Raw

Environment setup

To complete the exercises, you will need an environment with GitHub Copilot, and a supported IDE such as VS Code. You can use your local computer and install these tools, or you may choose to use Codespaces.

OPTION A - I want to setup my local machine for the exercises

1. Ensuring you have access to GitHub Copilot

Accessing GitHub Copilot

If you DO NOT have one of the following:

  • an active Copilot for Individuals trial
  • an active Copilot for Individuals subscription
  • an active Copilot for Business licence

you can sign up for a trial here.

2. Installing a supported IDE on your local machine

Installing a supported IDE on your machine

If you DO NOT have one of the following:

  • VSCode
  • Visual Studio
  • NeoVIM
  • JetBrains IDE

on your local machine, you will need to install one of these IDEs to use GitHub Copilot and complete the exercises.

If you have no preference, we suggest you install VSCode. You can download it here.

3. Installing the GitHub Copilot extension

Installing the GitHub Copilot extension

GitHub Copilot is a client-side extension you install into your supported developer IDE. The extension is available for VSCode, Visual Studio, NeoVIM and JetBrains IDEs.

Click the appropriate IDE link below for instructions to install the extension. As part of this you will need to log in using your GitHub account to ensure you are a licensed user of GitHub Copilot.

You should now have the GitHub Copilot extension installed in your IDE of choice.

4. (OPTIONAL) Installing the CodeTour extension (VSCode ONLY)

Installing the CodeTour extension

OPTIONAL: CodeTour is a Visual Studio Code extension, which allows you to play back guided walkthroughs of your code. Our GitHub Copilot workshop includes CodeTour files to help you get started. This is not a requirement for the exercise.

  1. Navigate to the CodeTour page on the Visual Studio Marketplace and click Install.
5. Cloning the exercise repo

Cloning the exercise repo

  1. Navigate to the Copilot-rock-paper-scissors repo
  2. Clone this repo to your local machine using your preferred method. You can find options by clicking the Code drop down and clicking on the local tab.
URL for cloning is https://github.com/copilot-workshops/copilot-rock-paper-scissors.git

What's next?

You're now ready to start the core exercises

or

OPTION B - I want to use GitHub Codespaces

NOTE: GitHub Codespaces provides a cloud hosted development environment. This is not a free service but all GitHub accounts are entitled to up to 60 hours (2-core machine) per month of free usage. You can find out more about GitHub Codespaces here. You can also check your remaining balance here. Choosing this option means you won't need to install anything on your local machine.

1. Launching Codespaces for the exercises

Launching Codespaces for the exercises

  1. For our exercises, you'll get started by navigating to the appropriate repo and choosing 'Use this template', and 'Open in a codespace'
Open in a Codespace

What's next?

You're now ready to start the core exercises