Wiki source code of Install Docker for Linux
Version 108.1 by Erik Bakker on 2024/03/01 16:19
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. |
![]() |
3.1 | 13 | |
![]() |
94.1 | 14 | In the below section the Linux 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. |
![]() |
21.1 | 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: | ||
![]() |
100.1 | 20 | |
21 | {{info}} | ||
22 | * Standard configuration to ensure that communication between your server and eMagiz to ensure communication. | ||
23 | ** registry.emagiz.com:443 | ||
24 | ** controlplane.emagiz.com:8000 | ||
![]() |
101.1 | 25 | ** Preferably the entry should be *.emagiz.com{{/info}} |
![]() |
100.1 | 26 | |
![]() |
103.1 | 27 | {{warning}} |
![]() |
107.1 | 28 | * In case of a very strict firewall configuration, additional configuration is needed to communicate to the eMagiz infrastructure. |
![]() |
104.1 | 29 | ** controltower.emagiz.com:443 |
30 | ** controlbus.emagiz.com:443 | ||
31 | ** controlplane.emagiz.com:443 | ||
![]() |
103.1 | 32 | |
![]() |
108.1 | 33 | * When using cloudslot number **equal to or below** 125, the following configuration is needed to communicate to your JMS. |
![]() |
104.1 | 34 | ** 35.158.46.28:443 |
35 | ** 3.74.190.88:443 | ||
36 | ** 35.158.46.28:8443 | ||
37 | ** 3.74.190.88:8443 | ||
38 | ** 35.158.46.28:8444 | ||
![]() |
107.1 | 39 | ** 3.74.190.88:8444 |
![]() |
104.1 | 40 | |
![]() |
108.1 | 41 | * When using a cloudslot number **above** 125, the following configuration is needed to communicate to your JMS. |
![]() |
107.1 | 42 | ** 3.74.209.20:443 |
43 | ** 3.76.127.155:443 | ||
44 | ** 3.74.209.20:8443 | ||
45 | ** 3.76.127.155:8443 | ||
46 | ** 3.74.209.20:8444 | ||
47 | ** 3.76.127.155:8444{{/warning}} | ||
48 | |||
![]() |
96.1 | 49 | ===3.2 Installation Linux=== |
50 | Whenever Linux is selected as operating system, the latest version of Ubuntu will work. Other Linux distributions will also work such as Debian or Red Hat. | ||
![]() |
95.1 | 51 | |
![]() |
96.1 | 52 | ==== 3.2.1 Set up Docker's apt repository ==== |
53 | |||
![]() |
42.1 | 54 | {{code language="cmd"}} |
![]() |
96.1 | 55 | # Add Docker's official GPG key: |
56 | sudo apt-get update | ||
57 | sudo apt-get install ca-certificates curl | ||
58 | sudo install -m 0755 -d /etc/apt/keyrings | ||
59 | sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc | ||
60 | sudo chmod a+r /etc/apt/keyrings/docker.asc | ||
61 | |||
62 | # Add the repository to Apt sources: | ||
63 | echo \ | ||
64 | "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \ | ||
65 | $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ | ||
66 | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null | ||
67 | sudo apt-get update | ||
![]() |
47.1 | 68 | {{/code}} |
![]() |
24.1 | 69 | |
![]() |
96.1 | 70 | ==== 3.2.2 Install Docker ==== |
71 | |||
72 | {{code language="cmd"}} | ||
73 | sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin | ||
74 | {{/code}} | ||
75 | |||
76 | ==== 3.2.3 Verify succesfull installation of the Docker Engine ==== | ||
77 | |||
78 | {{code language="cmd"}} | ||
79 | sudo docker run hello-world | ||
80 | {{/code}} | ||
81 | |||
![]() |
48.1 | 82 | {{info}} |
![]() |
47.1 | 83 | Requires ~335 Mb space to install |
![]() |
48.1 | 84 | {{/info}} |
![]() |
45.1 | 85 | |
![]() |
97.1 | 86 | ==== 3.2.4 Install eMagiz Deploy Agent ==== |
87 | |||
![]() |
94.1 | 88 | 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"]] |
![]() |
50.1 | 89 | |
![]() |
91.1 | 90 | == 4. Key takeaways == |
![]() |
1.1 | 91 | |
![]() |
5.1 | 92 | * 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 |
93 | * eMagiz has a specific agent that manages the download of that image to the on-premises server | ||
![]() |
40.1 | 94 | * 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 | 95 | |
![]() |
91.1 | 96 | == 5. Suggested Additional Readings == |
![]() |
1.1 | 97 | |
![]() |
98.1 | 98 | * [[Docker official installation guide>>https://docs.docker.com/engine/install/ubuntu/||target="blank"]] |
![]() |
91.1 | 99 | * Docker command line cheatsheet: [[image:Main.Images.Microlearning.WebHome@docker-cheatsheet.png]] |
![]() |
1.1 | 100 | |
101 | )))((({{toc/}}))){{/container}}{{/container}} |