Wiki source code of Install Docker for Windows
Version 98.1 by etorken on 2024/02/26 09:21
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
1.1 | 1 | {{container}}{{container layoutStyle="columns"}}((( |
| |
70.1 | 2 | In this microlearning, we will focus on how an on-premises server can be prepared for a eMagiz Deploy agent installation. |
| |
15.1 | 3 | |
| |
1.1 | 4 | Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]]. |
| 5 | |||
| 6 | == 1. Prerequisites == | ||
| 7 | |||
| 8 | * Advanced knowledge of the eMagiz platform | ||
| |
3.1 | 9 | * Good understanding of eMagiz runtimes in general |
| |
1.1 | 10 | |
| 11 | == 2. Key concepts == | ||
| |
25.1 | 12 | In the new runtime architecture of eMagiz, Docker technology is used to deploy runtimes. eMagiz creates specific runtime images that contain the eMagiz runtime, and can be deployed in dockerized environments. |
| |
95.1 | 13 | |
| 14 | In the below section the Windows variant is described in terms of how to prepare the server to allow the [[eMagiz Deploy Agent>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-runtime-management-deploy-agent.WebHome||target="blank"]] to be installed. That agent allows to download images from the eMagiz infrastructure. | ||
| 15 | |||
| |
3.1 | 16 | == 3. On-premises deployments == |
| |
25.1 | 17 | |
| 18 | ===3.1 General requirements=== | ||
| 19 | These are the general requirements to allow the installation of the eMagiz Docker agent: | ||
| |
17.1 | 20 | * Ensure access to the following URLs is enabled |
| |
93.1 | 21 | ** registry.emagiz.com:443 |
| |
98.1 | 22 | ** 3.126.123.28 |
| 23 | ** 18.194.225.123 | ||
| 24 | ** 54.93.164.84 | ||
| |
34.1 | 25 | ** controlplane.emagiz.com:8000 |
| |
98.1 | 26 | ** controlplane.emagiz.com:443 |
| 27 | ** 3.122.22.89:443 | ||
| 28 | ** 3.122.22.89:8000 | ||
| 29 | ** controltower.emagiz.com:443 | ||
| 30 | ** controlbus.emagiz.com:443 | ||
| 31 | ** 35.158.46.28:443 | ||
| 32 | ** 3.74.190.88:443 | ||
| 33 | ** 35.158.46.28:8443 | ||
| 34 | ** 3.74.190.88:8443 | ||
| 35 | ** 35.158.46.28:8444 | ||
| 36 | ** 3.74.190.88:8444 | ||
| 37 | ** 52.28.59.137 | ||
| 38 | ** 3.71.221.73 | ||
| 39 | ** 52.58.23.77 | ||
| |
17.1 | 40 | ** Preferably the entry should be *.emagiz.com |
| |
31.1 | 41 | |
| |
95.1 | 42 | ===3.2 Installation Windows=== |
| 43 | Whenever Windows is selected as operating system, you need to have a Windows Server 2022 version or a 2019 version (> 1806). Older Windows servers are **not** supported. | ||
| |
1.1 | 44 | |
| |
57.1 | 45 | |
| |
95.1 | 46 | ==== 3.2.1 Docker Installation ==== |
| 47 | In powershell with administrative rights, execute the following commands | ||
| |
18.1 | 48 | |
| |
42.1 | 49 | {{code language="cmd"}} |
| |
95.1 | 50 | Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/Windows-Containers/Main/helpful_tools/Install-DockerCE/install-docker-ce.ps1" -o install-docker-ce.ps1 |
| 51 | .\install-docker-ce.ps1 | ||
| |
43.1 | 52 | {{/code}} |
| |
44.1 | 53 | |
| |
95.1 | 54 | ==== 3.2.2 Check installation ==== |
| |
91.1 | 55 | |
| |
95.1 | 56 | After executing the commands above, the server will restart if required. After the restart, execute the following command |
| |
44.1 | 57 | |
| |
45.1 | 58 | {{code language="cmd"}} |
| |
95.1 | 59 | docker ps |
| |
62.1 | 60 | {{/code}} |
| 61 | |||
| |
95.1 | 62 | If the command returns that the command cannot be found, please run the following command again. |
| |
72.1 | 63 | |
| 64 | {{code language="cmd"}} | ||
| |
95.1 | 65 | .\install-docker-ce.ps1 |
| |
47.1 | 66 | {{/code}} |
| |
24.1 | 67 | |
| |
95.1 | 68 | ==== 3.2.3 Verify docker functionality ==== |
| |
45.1 | 69 | |
| |
95.1 | 70 | Execute the following command |
| |
50.1 | 71 | |
| |
49.1 | 72 | {{code language="cmd"}} |
| |
95.1 | 73 | docker ps |
| |
49.1 | 74 | {{/code}} |
| |
32.1 | 75 | |
| |
95.1 | 76 | The result of this call should show the following: |
| |
51.1 | 77 | |
| |
97.1 | 78 | [[image:Main.Images.Microlearning.WebHome@expert-solution-architecture-onpremises-server-windows-installguide--correct-result.png]] |
| |
52.1 | 79 | |
| |
95.1 | 80 | ==== 3.2.4 Install eMagiz Deploy Agent ==== |
| |
52.1 | 81 | |
| |
97.1 | 82 | Install the eMagiz Deploy agent as can be found in this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Runtime Management.intermediate-runtime-management-deploy-agent.WebHome||target="blank"]] |
| |
52.1 | 83 | |
| |
91.1 | 84 | == 4. Key takeaways == |
| |
1.1 | 85 | |
| |
5.1 | 86 | * eMagiz uses runtime images to deploy emagiz runtime on dockerized environments. The runtime image holds all the information and components required to run the runtime |
| 87 | * eMagiz has a specific agent that manages the download of that image to the on-premises server | ||
| |
40.1 | 88 | * The firewall of the on-premises environment should allow outgoing traffic without any restriction. In case that is not desirable, eMagiz can provide the addresses and ports needed to setup the right firewall rules. |
| |
1.1 | 89 | |
| |
91.1 | 90 | == 5. Suggested Additional Readings == |
| |
1.1 | 91 | |
| |
91.1 | 92 | * Docker command line cheatsheet: [[image:Main.Images.Microlearning.WebHome@docker-cheatsheet.png]] |
| |
1.1 | 93 | |
| 94 | )))((({{toc/}}))){{/container}}{{/container}} |