Wiki source code of Install Docker for Windows
Version 105.1 by Erik Bakker on 2024/03/12 10:24
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{container}}{{container layoutStyle="columns"}}((( | ||
| 2 | In this microlearning, we will focus on how an on-premises server can be prepared for a eMagiz Deploy agent installation. | ||
| 3 | |||
| 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 | ||
| 9 | * Good understanding of eMagiz runtimes in general | ||
| 10 | |||
| 11 | == 2. Key concepts == | ||
| 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. | ||
| 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 | |||
| 16 | == 3. On-premises deployments == | ||
| 17 | |||
| 18 | ===3.1 General requirements=== | ||
| 19 | |||
| 20 | {{info}} | ||
| 21 | * Standard configuration to ensure that communication between your server and eMagiz to ensure communication. | ||
| 22 | ** registry.emagiz.com:443 | ||
| 23 | ** controlplane.emagiz.com:8000 | ||
| 24 | ** controltower.kpn-dsh.com:443 | ||
| 25 | ** Preferably the entry should be *.emagiz.com | ||
| 26 | ** ** Preferably the entry should be *.kpn-dsh.com{{/info}} | ||
| 27 | |||
| 28 | {{warning}} | ||
| 29 | * In case of a very strict firewall configuration, additional configuration is needed to communicate to the eMagiz infrastructure. | ||
| 30 | ** controltower.emagiz.com:443 | ||
| 31 | ** controltower.kpn-dsh.com:443 | ||
| 32 | ** controlbus.emagiz.com:443 | ||
| 33 | ** controlplane.emagiz.com:443 | ||
| 34 | |||
| 35 | * When using cloudslot number **equal to or below** 125, the following configuration is needed to communicate to your JMS. | ||
| 36 | ** 35.158.46.28:443 | ||
| 37 | ** 3.74.190.88:443 | ||
| 38 | ** 35.158.46.28:8443 | ||
| 39 | ** 3.74.190.88:8443 | ||
| 40 | ** 35.158.46.28:8444 | ||
| 41 | ** 3.74.190.88:8444 | ||
| 42 | |||
| 43 | * When using a cloudslot number **above** 125, the following configuration is needed to communicate to your JMS. | ||
| 44 | ** 3.74.209.20:443 | ||
| 45 | ** 3.76.127.155:443 | ||
| 46 | ** 3.74.209.20:8443 | ||
| 47 | ** 3.76.127.155:8443 | ||
| 48 | ** 3.74.209.20:8444 | ||
| 49 | ** 3.76.127.155:8444{{/warning}} | ||
| 50 | |||
| 51 | ===3.2 Installation Windows=== | ||
| 52 | Whenever Windows is selected as operating system, you need to have a Windows Server 2022 version. Older Windows servers are **not** supported. | ||
| 53 | |||
| 54 | |||
| 55 | ==== 3.2.1 Docker Installation ==== | ||
| 56 | In powershell with administrative rights, execute the following commands | ||
| 57 | |||
| 58 | {{code language="cmd"}} | ||
| 59 | Invoke-WebRequest -UseBasicParsing "https://raw.githubusercontent.com/microsoft/Windows-Containers/Main/helpful_tools/Install-DockerCE/install-docker-ce.ps1" -o install-docker-ce.ps1 | ||
| 60 | .\install-docker-ce.ps1 | ||
| 61 | {{/code}} | ||
| 62 | |||
| 63 | ==== 3.2.2 Check installation ==== | ||
| 64 | |||
| 65 | After executing the commands above, the server will restart if required. After the restart, execute the following command | ||
| 66 | |||
| 67 | {{code language="cmd"}} | ||
| 68 | docker ps | ||
| 69 | {{/code}} | ||
| 70 | |||
| 71 | If the command returns that the command cannot be found, please run the following command again. | ||
| 72 | |||
| 73 | {{code language="cmd"}} | ||
| 74 | .\install-docker-ce.ps1 | ||
| 75 | {{/code}} | ||
| 76 | |||
| 77 | ==== 3.2.3 Verify docker functionality ==== | ||
| 78 | |||
| 79 | Execute the following command | ||
| 80 | |||
| 81 | {{code language="cmd"}} | ||
| 82 | docker ps | ||
| 83 | {{/code}} | ||
| 84 | |||
| 85 | The result of this call should show the following: | ||
| 86 | |||
| 87 | [[image:Main.Images.Microlearning.WebHome@expert-solution-architecture-onpremises-server-windows-installguide--correct-result.png]] | ||
| 88 | |||
| 89 | ==== 3.2.4 Install eMagiz Deploy Agent ==== | ||
| 90 | |||
| 91 | 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"]] | ||
| 92 | |||
| 93 | == 4. Key takeaways == | ||
| 94 | |||
| 95 | * 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 | ||
| 96 | * eMagiz has a specific agent that manages the download of that image to the on-premises server | ||
| 97 | * 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. | ||
| 98 | |||
| 99 | == 5. Suggested Additional Readings == | ||
| 100 | |||
| 101 | * Docker command line cheatsheet: [[image:Main.Images.Microlearning.WebHome@docker-cheatsheet.png]] | ||
| 102 | |||
| 103 | )))((({{toc/}}))){{/container}}{{/container}} |