Skip to Content
Version 1.1 by eMagiz on 2022/05/10 11:22
Show last authors
1 {{html wiki="true"}}
2 <div class="ez-academy">
3 <div class="ez-academy_body">
4
5 <div class="doc">
6
7
8
9 = Creating a new Release =
10
11 In this microlearning, we will focus on the various options to create and edit releases as part of Release Management with eMagiz.
12
13 Should you have any questions, please contact academy@emagiz.com.
14
15 * Last update: February 7th, 2021
16 * Required reading time: 4 minutes
17
18 == 1. Prerequisites ==
19
20 * Basic knowledge of the eMagiz platform
21 * Completed all microlearnings from Deploy till this specific microlearning
22 * Have an environment where you can add releases and that is operational to try out the deployment plan
23
24 == 2. Key concepts ==
25
26 eMagiz provides the capability to manage your deployments effectively so that all your updated flow components as created in the previous ILM phases of eMagiz. In the previous microlearning, you have seen how the flows are deployed across the different eMagiz runtime * this microlearning defines what exactly needs to be deployed.
27
28 When you create a release you create a set/view of all flows that should run on your environment on a specific date and time.
29
30 This microlearning centers around creating (and managing) an eMagiz Release.
31
32
33
34 == 3. Creating a new Release ==
35
36 Below the steps to create a new release and the options available.
37
38 === 3.1 Creating a Release in TEST ===
39
40 The first step is to create a new release using the New Release button. This allows providing a name for the Release and the type of the revision (Major, Minor, or Patch). Depending on the purpose of the release, the right versioning can be selected. Provide sufficient comments to recognize the objective of the release.
41
42 <p align="center">[[image:crashcourse-platform-deploy-create-new-release-pic1.png||]]</p>
43
44 Once the name is provided, please note the three small circles under the name. These denote in what environment this release is active (black or green color) and quickly looking for the green circle you will find the active release of a specific environment.
45
46 === 3.2 Adding flows to Release ===
47
48 Based on the version selected, and the committed flows from the Create phase, the release content is determined. You have various compare options between releases to understand what exactly has changed between releases to verify if the list of flows created is the good one. You can compare Releases (and to the Create phase) by holding the CRTL button and selecting two releases. The canvas will then highlight the differences in the following manner:
49
50 * Blue: the flow is changed functionally (new version created) or the flow is connected to the latest build number of emagiz
51 * Red: a flow in the first Release selected is no longer present compared to the second release selected
52 * Green/white: this flow is added compared to the second release selected
53
54 <p align="center">[[image:crashcourse-platform-deploy-create-new-release-pic4.png||]]</p>
55
56 A release may contain flow components from different patterns. In the bottom right, the different patterns are displayed and the steps above can be repeated for every pattern. There are small circles right above the patterns to understand the changes made in these views. They are following the same color indication pattern as above
57
58 <p align="center">[[image:crashcourse-platform-deploy-create-new-release-pic4.png||]]</p>
59
60 === 3.3 Set Release as active ===
61
62 Once the release is created, there is an asterisk before the name. This means that the release is not active yet. With the three-dots-option button right next to the name of the release, you have various options for that release. Select the option set as active to make this the release that the deployment plan will use to deploy the updated, new, and changed flows.
63
64 <p align="center">[[image:crashcourse-platform-deploy-create-new-release-pic2.png||]]</p>
65
66 ===== Practice =====
67
68 == 4. Assignment ==
69
70 Go to your environment, and try to add a new release for your environment. Explore all the available options, and ensure to select, deselect flows from your environment.
71
72 == 5. Key takeaways ==
73
74 * The Release defined what is to be deployed on a specific environment, as compared to the Deployment plan that determines what is to be deployed
75 * Use proper naming and clean your old releases regularly. Non-active releases only can be deleted
76 * When you create a release you create a set/view of all flows that should run on your environment on a specific date and time
77
78
79
80 == 6. Suggested Additional Readings ==
81
82 If you are interested in this topic and want more information on it please read the help text provided by eMagiz when executing these actions.
83
84 == 7. Silent demonstration video ==
85
86 This video demonstrates how you could have handled the assignment and gives you some context on what you have just learned.
87
88 <iframe width="1280" height="720" src="../../vid/microlearning/crashcourse-platform-deploy-create-new-release.mp4" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
89
90 </div>
91
92 </div>
93 </div>
94
95 {{/html}}