Changes for page Exercise - Apply to environment

Last modified by Erik Bakker on 2023/08/04 13:41

From 1.2 to 2.1

From version 2.1

edited by eMagiz
on 2022/06/09 11:56

Change comment: There is no comment for this version

To version 10.1

edited by Erik Bakker
on 2023/08/04 13:41

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (5 modified, 0 added, 0 removed)

Details

Page properties

Title

@@ -1,1 +1,1 @@
--Apply to environment
++Exercise - Apply to environment

Parent

@@ -1,1 +1,1 @@
--WebHome
++Main.eMagiz Academy.Microlearnings.Intermediate Level.eMagiz Cloud Management.WebHome

Author

@@ -1,1 +1,1 @@
--XWiki.eMagiz
++XWiki.ebakker

Default language

...	...	@@ -1,0 +1,1 @@
	1	+en

Content

@@ -1,86 +1,40 @@
--{{container}}
--{{container layoutStyle="columns"}}
--(((
++{{container}}{{container layoutStyle="columns"}}(((
++With this exercise, we learn how to use the "apply to environment" functionality in Deploy -> Architecture. This functionality is a key component in sending changes to our eMagiz cloud to actualize these changes. Most notably among these changes are the configuration of routes and certificates.
--
--In this microlearning, we will focus on the "apply to environment" action. As we saw in previous microlearnings and will see in microlearnings to come with regards to cloud management is that some actions in Deploy Architecture have a direct effect (i.e. Slot Wakeup, Restart Runtime, Reset Runtime, etc.) and others have an indirect effect (i.e. Add Route, Add Certificate, Remove Runtime, etc.). For the actions that have an indirect effect on the eMagiz Cloud, you need the "apply to environment" functionality to actualize the changes on the eMagiz Cloud level.
--
  Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
--* Last update: July 21th, 2021
--* Required reading time: 5 minutes
--
  == 1. Prerequisites ==
--* Basic knowledge of the eMagiz platform
--* Basic knowledge of cloud management
++* Completed all previous microlearnings on the subject.
++* Access to my.emagiz.com with your own account and MFA configured.
++* A model in which you can create this exercise.
--== 2. Key concepts ==
++== 2. Exercise ==
--This microlearning centers around the apply to environment action
--With "apply to environment", we mean: Actualizing all changes, with an indirect effect, within the eMagiz Cloud that were made by users on the Deploy Architecture canvas after the last press on this button
++In this exercise we will add a certificate and a route. Once done we press the "Apply to environment" functionality to understand that those kinds of changes are only applied once you press this button.
--* Apply to environment actualizes all changes with an indirect effect
--* It gives you the option to change multiple things at once before applying the bulk change. This is to reduce downtime
--* It ensures that the eMagiz Cloud is only affected when a user want to affect it
++To complete this exercise you need to execute the following steps:
++* Navigate to Deploy -> Architecture
++* Enter "Start Editing" mode and open the context menu (by clicking on the white area of the canvas)
++* Select the certificate option and fill in the following things:
++** CN Name
++** Client Name
++* Save your changes on certificate level
++* Open the context menu again and select the route option.
++* Fill in the following things:
++** DNS Left most label
++** Port
++** Runtime(s)
++** Certificate to use
++* Save your changes
++== 3. Solution ==
--== 3. Apply to environment ==
++* Understand that indirect changes will only be applied to your cloud once you press "Apply to environment" and confirm "Apply changes".
--In this microlearning, we will focus on the "apply to environment" action. As we saw in previous microlearnings and will see in microlearnings to come with regards to cloud management is that some actions in Deploy Architecture have a direct effect (i.e. Slot Wakeup, Restart Runtime, Reset Runtime, etc.) and others have an indirect effect (i.e. Add Route, Add Certificate, Remove Runtime, etc.). For the actions that have an indirect effect on the eMagiz Cloud you need the "apply to environment" functionality to actualize the changes on the eMagiz Cloud level.
++In this short movie, you will find the workout of this exercise. Take a moment to review this one and compare it to your solution.
--The Apply to environment functionality gives you:
++{{video attachment="exercise-intermediate-emagiz-cloud-management-apply-to-environment.mp4" reference="Main.Videos.Microlearning.WebHome"/}}
--* Apply to environment actualizes all changes with an indirect effect
--* It gives you the option to change multiple things at once before applying the bulk change. This is to reduce downtime
--* It ensures that the eMagiz Cloud is only affected when a user want to affect it
--
--Below we have categorized each action to see whether they have a direct effect on the eMagiz Cloud or an Indirect effect. This is to give context per action what is the consequence of your action.
--
--| <p align="center">**Direct Effect**</p> | <p align="center">**Indirect Effect**</p> |
--| --------------------------------------* | ----------------------------------------- |
--| Restart Runtime (Not JMS)               | Add Route                                 |
--| Restart Runtime (JMS)                   | Update Route                              |
--| Reset Runtime (Not JMS)                 | Delete Route                              |
--| Reset Runtime (JMS)                     | Add Certificate                           |
--| Restart Runtime (Not JMS)               | Update Certificate                        |
--| Restart Connector Machine               | Delete Certificate                        |
--| Restart Core Machine                    | Add runtime to connector machine          |
--| Stop Connector Machine                  | Add runtime to core machine               |
--| Stop Core Machine                       | Remove runtime from connector machine     |
--| Start Connector Machine                 | Remove runtime from core machine          |
--| Start Core Machine                      | Update memory settings runtime (not JMS)  |
--| Wake up Cloud Slot                      | Update memory settings runtime (JMS)      |
--| Put Cloud Slot to sleep                 | Change Cloud Template                     |
--| Clean Store                             |
--| Upgrade Cloud Slot\*                    |
--
--\*Note that the upgrade of the cloud slot can be planned for a later moment in time.
--
--So, in short, when you execute one (or more) actions on Deploy Architecture that have an indirect effect, you need to press Apply to Environment to actualize the changes within the eMagiz Cloud. Note that each move, whether it is direct or indirect, will cause a reaction and subsequent change within the eMagiz Cloud. So be cautious about changing things too many times over. Make sure you are especially careful when using custom folders on runtime level, as they could be deleted and recreated in cases where the machine is recreated. To safeguard yourself against this, place the folder either inside the data folder or directly on efs. Furthermore, we advise stopping the processes that have such custom folders before executing the change. This is especially relevant in the Production environment.
--
--
--== 4. Assignment ==
--
--There is no assignment for this microlearning.
--
--== 5. Key takeaways ==
--
--* By restarting the runtime, you restart all flows (including infra) of the runtime you have selected
--  * Flows return in original state
--
--
--
--== 6. Suggested Additional Readings ==
--
--There are no suggested additional readings on this topic
--
--== 7. Silent demonstration video ==
--
--There is no demonstration video of this functionality.
--
--)))
--
--((({{toc/}}))){{/container}}
--{{/container}}
++)))((({{toc/}}))){{/container}}{{/container}}

Changes for page Exercise - Apply to environment

Summary

Details

Navigation