|
1 | 1 | # Using Docker |
2 | 2 |
|
| 3 | +In this guide, you'll learn how to set up a local working environment using Docker and Visual Studio Code. Either if have previous experience using Docker or not, we will guide you step by step from installing the software you need, through testing your working environment. |
| 4 | + |
| 5 | +## Installing Docker |
| 6 | + |
3 | 7 | [Docker](https://www.docker.com/) is a platform designed to help developers build, share, and run applications into an isolated environment on any operating system. |
4 | 8 |
|
5 | 9 | To ease setting up a local working environment for this course, the IOG Education Team created a Docker container that packages all the dependencies required to follow up the lessons of this program |
6 | 10 |
|
7 | 11 | {% hint style="info" %} |
8 | | -A **Docker container** is a standard unit of software that packages up code and all its dependencies so and application runs quickly and reliably from one computing environment to another. You can learn more about Docker containers in [this page](https://www.docker.com/resources/what-container/). |
| 12 | +A **Docker container** is a standard unit of software that packages up code and all its dependencies so and application runs quickly and reliably from one computing environment to another. You can learn more about Docker containers in [this page](https://www.docker.com/resources/what-container/) from the Docekr documentation. |
9 | 13 | {% endhint %} |
10 | 14 |
|
| 15 | +Follow the next steps to install Docker in your computer. |
| 16 | + |
| 17 | +1. Open your browser and navigate to <https://www.docker.com/>. From the Docker's homepage, click on the "Download Docker Desktop" button. By default, you'll download a version compatible with you operating system. Docker is available for Linux, Microsoft Windows, and Apple macOS. |
| 18 | + |
| 19 | + {% hint style="warning" %} |
| 20 | + **Important note for macOS users.** Be sure that you download the correct version according to the chip of your computer, for M1 or M2 chips, [download the "Apple Chip" version](https://desktop.docker.com/mac/main/arm64/Docker.dmg). For Intel chips, [download the "Intel Chip" version](https://desktop.docker.com/mac/main/amd64/Docker.dmg). |
| 21 | + {% endhint %} |
| 22 | + |
| 23 | + In the image below, you can see how the download button looks on a computer using Microsoft Windows. We'll this operating system for the purposes of this guide. |
| 24 | + |
| 25 | +  |
| 26 | + |
| 27 | +2. After downloading the Docker Desktop installer, execute it and follow the instructions by choosing the default options. Installation options may vary depending on your chip and operating system. If you need detailed instructions, please visit the [Get Docker section](https://docs.docker.com/get-docker/) in the docker docs website. |
| 28 | + |
| 29 | + {% hint style="info" %} |
| 30 | + After installing Docker Desktop, it'll automatically start after login into your computer. You can change this behavior by turning off the "Start Docker Desktop when you log in" in the Docker Settings configuration. The following image shows the general settings in Docker Desktop running in Windows. |
| 31 | + |
| 32 | +  |
| 33 | + |
| 34 | + To learn more about changing the settings in Docker Desktop, please visit the ["Change Settings" section](https://docs.docker.com/desktop/settings/mac/) of the Docker Desktop manual. |
| 35 | + {% endhint %} |
| 36 | + |
| 37 | +Now that you have Docker Desktop up and running, let's download and install Visual Studio Code. |
| 38 | + |
| 39 | +## Installing Visual Studio Code |
| 40 | + |
| 41 | +[Visual Studio Code](https://code.visualstudio.com/), also known as VS Code, is a source code editor freely distributed by Microsoft that runs on Windows, Linux and macOS. Additionally to allow code editing, VS Code allows developers to create and install extensions that eases their daily work. |
| 42 | + |
| 43 | +Follow the next steps to install VS Code and a handy extension that you will use in this course. |
| 44 | + |
| 45 | +1. Open your browser and navigate to <https://code.visualstudio.com/> to open Visual Studio Code website. As the image below shows, there is a button where you |
| 46 | +can download this software. Depending on your operating system, the button's name will change. Be sure to download the latest version. |
| 47 | + |
| 48 | + {% hint style="info" %} |
| 49 | + To download VS Code for any operating system, please visit the [Download Visual Studio Code page](https://code.visualstudio.com/Download) and choose the operating system of your preference. |
| 50 | + {% endhint %} |
| 51 | + |
| 52 | + For this demo, the button to download VS Code for Windows is highlighted. |
| 53 | + |
| 54 | +  |
| 55 | + |
| 56 | +2. After downloading the VS Code installer, execute it and follow the instructions by choosing the default options. Installation options may vary depending on your chip and operating system. If you need detailed instructions, please visit the [Setting up Visual Studio Code section](https://code.visualstudio.com/docs/setup/setup-overview) in the VS Code docs website. |
| 57 | + |
| 58 | +3. Once you installed VS Code, open it to install a extension. Extensions are additional add-ons that extends the VS Code's functionality; some extensions are provided by Microsoft, but also, there are plenty of extensions created by other companies and developers. To install a extension, click on the "Manage" icon in the bottom left corner and choose the "Extensions" options at the image below shows. |
| 59 | + |
| 60 | +  |
| 61 | + |
| 62 | +4. Next, a window showing the "Extensions Marketplace" will appear on the left side of the VS Code UI. In the search box type `remote development` to look for the [Remote Development extension provided by Microsoft](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.vscode-remote-extensionpack). Once the extension appears, click on it. As the image below shows, to install a extension you should click on the "Install" button. |
| 63 | + |
| 64 | +  |
| 65 | + |
| 66 | +5. After successfully installing the Remove Development extension, you'll note that a "Uninstall" button appears in the extension description tab, and the "Open a Remote Window" icon will appear on the bottom left corner of the VS Code UI as you can see in the following image. |
| 67 | + |
| 68 | +  |
| 69 | + |
| 70 | +Awesome, you have installed all the required software to use the Docker container! Now, we'll guide you through the steps you need to follow to load the Docker container and execute it for the first time. |
| 71 | + |
| 72 | +## Running the PPP Docker Container |
| 73 | + |
| 74 | +Before moving forward into using the Docker container provided for this cohort of the PPP, you need to close VS Code. Next, please follow the next steps. |
| 75 | + |
| 76 | +### Cloning the PPP Repository |
0 commit comments