Skip to Content

Changes for page API Gateway Architecture

Last modified by Erik Bakker on 2024/09/02 16:04
From version 13.1
edited by Erik Bakker
on 2023/01/23 10:54
Change comment: There is no comment for this version
To version 9.1
edited by Erik Bakker
on 2022/06/13 08:23
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,8 +1,11 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 -This microlearning will focus on describing the general architecture of the API Gateway. After this microlearning, the background of the API GW architecture should be clear
2 +This micro-learning will focus on describing the general architecture of the API Gateway. After this microlearning, the background of the API GW architecture should be clear
3 3  
4 -Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
4 +Should you have any questions, please contact academy@emagiz.com.
5 5  
6 +* Last update: October 20th, 2021
7 +* Required reading time: 10 minutes
8 +
6 6  == 1. Prerequisites ==
7 7  * Intermediate knowledge of the eMagiz platform
8 8  * Good working experience in the Design phase Architecture and Deploy Architecture
... ... @@ -13,6 +13,9 @@
13 13  * Single lane -> Single runtime per types
14 14  * Double lane -> Two or more runtime per type to handle failover setups
15 15  
19 +
20 +
21 +
16 16  == 3. Architecture considerations ==
17 17  
18 18  === 3.1 Architecture components API Gateway ===
... ... @@ -22,11 +22,11 @@
22 22  [[image:Main.Images.Microlearning.WebHome@advanced-solution-architecture-apigw-architecture-1.png]]
23 23  
24 24  Key notes
25 -* Gateway runtime
31 +1. Gateway runtime
26 26  The Gateway has a separate runtime where the associated gateway flows are deployed in. The exit gates and all entry flow are the typical flow types present in this runtime, next to the usual infrastructure flow
27 -* Location runtime
33 +2. Location runtime
28 28  The Gateway runtime is located in a Cloud machine, and is specifically put on the Connector machine. The Connector machine has the ability to allow incoming data (secured) traffic from outside the Virtual Private Cloud that each client has. The Core machine does not have this option due to security reasons. The eMagiz Cloud handles the proper and secure routing to the API gateway.
29 -* Gateway only runtime
35 +3. Gateway only runtime
30 30  These are system that act as application user of 1 or more operations made available in the API Gateway. In case the system is only connected in the Design phase as such an application user, than that system only acts as input for User Management. The system doesn't need to be deployed as a runtime on the Connector machine, and should therefore be placed on an excluded machine. In the picture above, Exact online is such a system.
31 31  
32 32  === 3.2 Single lane Cloud setup ===
... ... @@ -33,8 +33,8 @@
33 33  
34 34  Single lane setup in eMagiz means that all runtimes are provided once in the architecture diagram * there is no failover or clustered approach for the runtimes. For the API Gateway, this means that you have the following machines available. In this example, you have the messaging patterns components as well with the objective to see such cases as well.
35 35  
36 -* Core 01 -> holds the JMS Server and the messaging process container
37 -* Connnector 01 -> holds the API Gateway container and the messaging runtimes
42 +* Core 01 --> holds the JMS Server and the messaging process container
43 +* Connnector 01 --> holds the API Gateway container and the messaging runtimes
38 38  
39 39  [[image:Main.Images.Microlearning.WebHome@advanced-solution-architecture-apigw-architecture-2.png]]
40 40  
... ... @@ -42,10 +42,10 @@
42 42  
43 43  Double lane setup in eMagiz means that all runtimes are provided at least twice in the architecture diagram * there is a failover for the JMS runtimes and gateway containers. For the API Gateway, this means that you have the following machines available. In this case you need to make sure that the flows are duplicated properly across the containers in Deploy * Containers. By default eMagiz will spread all flows over both gateway containers.
44 44  
45 -* Core 01 -> holds the JMS Server and the 1st messaging process container
46 -* Core 02 -> holds the backup JMS Server and the 2nd messaging process container
47 -* Connnector 01 -> holds the 1st API Gateway container
48 -* Connnector 02 -> holds the 2nd API Gateway container
51 +* Core 01 --> holds the JMS Server and the 1st messaging process container
52 +* Core 02 --> holds the backup JMS Server and the 2nd messaging process container
53 +* Connnector 01 --> holds the 1st API Gateway container
54 +* Connnector 02 --> holds the 2nd API Gateway container
49 49  
50 50  The choice to create a double lane API gateway is to be done where there is a requirement for very high performance around response times and throughput. Please contact eMagiz to discuss such options.
51 51  
... ... @@ -53,17 +53,20 @@
53 53  
54 54  === 3.4 Hybrid Cloud setup ===
55 55  
56 -In the [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Advanced Level.API Management.advanced-api-management-running-part-of-your-api-gateway-solution-on-premise.WebHome||target="blank"]] you can find the reasons and configuration for running the exit gates in on-premises runtimes. A view of such a architecture is displayed here:
62 +In the [microlearning](advanced-api-management-running-part-of-your-api-gateway-solution-on-premise.md) you can find the reasons and configuration for running the exit gates in on-premises runtimes. A view of such a architecture is displayed here:
57 57  
58 58  [[image:Main.Images.Microlearning.WebHome@advanced-solution-architecture-apigw-architecture-4.png]]
59 59  
60 60  === 3.5 Memory ===
61 61  
62 -For now the memory requirements for API Gateway are the same as for Messaging flows. Please refer to the [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Expert Level.Solution Architecture.expert-solution-architecture-determining-needed-memory.WebHome||target="blank"]].
68 +For now the memory requirements for API Gateway are the same as for Messaging flows. Please refer to the [microlearning](expert-solution-architecture-determining-needed-memory.md).
63 63  
70 +
71 +
72 +
64 64  == 4. Assignment ==
65 65  
66 -There is no specific assignment for now. The correct use of the Design architecture is explained in this [[microlearning>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course Platform.crashcourse-platform-design-understanding-design-architecture-basic.WebHome||target="blank"]].
75 +There is no specific assignment for now. The correct use of the Design architecture is explained in this [microlearning](crashcourse-platform-design-understanding-design-architecture-basic.md).
67 67  
68 68  == 5. Key takeaways ==
69 69  
... ... @@ -71,6 +71,8 @@
71 71  2. A single lane setup is usually sufficient for most cases
72 72  3. Hybrid setups are possbible but please be sure the ask the right questions before implementing such
73 73  
83 +
84 +
74 74  == 6. Suggested Additional Readings ==
75 75  
76 76  There are no suggested additional readings on this topic