Skip to content

Commit 8311b4c

Browse files
committed
Updates Using Docker install guide
1 parent c73d546 commit 8311b4c

File tree

7 files changed

+67
-1
lines changed

7 files changed

+67
-1
lines changed

docs/prework/setup/docker.md

Lines changed: 67 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,76 @@
11
# Using Docker
22

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+
37
[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.
48

59
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
610

711
{% 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.
913
{% endhint %}
1014

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+
![Docker homepage where the Download Docker Desktop button is highlighted.](images/docker-guide-01.png)
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+
![Docker Desktop general settings in a Windows computer.](images/docker-guide-02.png)
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+
![Visual Studio homepage where the button to download this software for Windows is highlighted.](images/docker-guide-03.png)
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+
![Visual Studio UI where the Extensions option is highlighted in the Manage menu.](images/docker-guide-04.png)
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+
![Visual Studio Extensions Marketplace where the Remote Development extension is highlighted.](images/docker-guide-05.png)
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+
![Visual Studio UI after a successful installation of the Remote Development extension.](images/docker-guide-06.png)
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
123 KB
Loading
73.4 KB
Loading
262 KB
Loading
65.6 KB
Loading
123 KB
Loading
123 KB
Loading

0 commit comments

Comments
 (0)