Wiki source code of DevOps Portal for Users

Version 7.2 by DOaaS Operator on 2025/11/13 14:03

Hide last authors
DOaaS Operator 1.1 1 Welcome to the DevOps Portal. This guide will walk you through the initial steps to begin your first DevOps project seamlessly.
2
3 Below, you will find a series of actions required to get your project up and running:
4
5 {{toc/}}
6
7
giuseppecapaldot-systemscom 3.1 8 = Invitation and activation{{id name="Invitation and activation"/}} =
DOaaS Operator 1.1 9
10 To begin using our software solution, you must first receive an invitation email from an administrator who has created your account.
11
12 This email will enable you to activate your account.
13
14 Please see the example below:
15
DOaaS Operator 7.2 16 [[image:1763042544636-589.png||data-xwiki-image-style-border="true"]]
DOaaS Operator 1.1 17
18 Upon receiving an email containing an invitation link, you can activate your account by either clicking the link directly or copying and pasting it into a new browser window.
19
20 Once completed, you will be directed to a page on our platform confirming the successful activation of your account.
21
22 Please see the example below:
23
DOaaS Operator 7.2 24 [[image:1763042597764-495.png||data-xwiki-image-style-border="true"]]
DOaaS Operator 1.1 25
DOaaS Operator 7.2 26
DOaaS Operator 1.1 27 With your account now created and successfully activated, the next step is to set up your password.
28
29 Upon completing the activation process, the system will automatically send you an email containing a link to create your password.
30
31 Please see the example below:
32
giuseppecapaldot-systemscom 1.2 33 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" %)//[[image:Screenshot 2024-11-14 153928.png||alt="Image of the password creation email" data-xwiki-image-style-border="true" class="img-thumbnail"]]//
DOaaS Operator 1.1 34
35 Similar to the account activation process, you can create your password by either clicking the link provided in the email or by copying and pasting it into a new browser window.
36
37 Upon completion, you will be directed to a page on our platform prompting you to take further action.
38
39 Please click on the "**Click here to proceed**" link.
40
41 An example is provided below:
42
giuseppecapaldot-systemscom 1.3 43 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" %)//[[image:Screenshot 2024-11-14 155143.png||alt="Page of password creation" data-xwiki-image-style-border="true" class="img-thumbnail"]]//
DOaaS Operator 1.1 44
45
46 (% class="box infomessage" %)
47 (((
48 == Optional Two-Factor Authentication(2FA) configuration ==
49
50 At this stage of your account setup, it is possible that, based on your specific environment configuration, an additional level of authentication may be required.
51
52 If this is the case, the system will automatically prompt you to integrate this requirement into your setup.
53
54 To enable two-factor authentication, you will need a **smartphone **with an authenticator app installed such as **Google Authenticator** or **Microsoft Authenticator**.
55
56 After clicking "**Click here to proceed**" on the previous page, you will be directed to a screen resembling the one shown below:
57
giuseppecapaldot-systemscom 1.2 58 [[image:Screenshot 2024-11-19 091818.png||alt="Second Factor Authentication setup" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 59
60 After scanning the QR code, enter the code generated by your authenticator application and create a custom identifier to easily remember which smartphone or account can generate the correct one-time code.
61
62 If you are unable to scan the QR code, click on the "**Unable to scan**" link for alternative instructions to obtain the one-time code from your authenticator application.
63
64 Once you follow the instructions provided and click the "**Submit**" button or press **Enter **on your keyboard, you will be directed to the password update page
65 )))
66
67
68 Whether or not you need to configure the second authentication factor, you will now be redirected to the password update page.
69
70 Here, you can select a new password that meets the required strength criteria.
71
72 Please enter your chosen password twice for confirmation.
73
74 After completing this step, click "**Submit**."
75
76 Below is an example screenshot for your reference:
77
giuseppecapaldot-systemscom 1.2 78 [[image:Screenshot 2024-11-14 155231.png||alt="Password creation" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 79
80 Once your password update is **successful**, you will be taken to a confirmation page indicating the update's success and providing a link to the application's login page.
81
82 Below is an example screenshot for your reference:
83
giuseppecapaldot-systemscom 1.3 84 [[image:Screenshot 2024-11-14 155401.png||alt="Page of password created" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 85
86 With this last step, your account **setup is complete**, and you can now use it to access the application. **Well done**.
87
88
giuseppecapaldot-systemscom 4.1 89 = Log in to DevOps Portal{{id name="Log in to DevOps Portal"/}} =
DOaaS Operator 1.1 90
91 To access the application, begin by entering its URL into the address bar.
92
93 The application will then automatically direct you to the login screen.
94
95 Please refer to the example screenshot below:
96
giuseppecapaldot-systemscom 1.3 97 [[image:Screenshot 2024-11-14 155426.png||alt="Page of Log-in" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 98
99 You can now access the application by entering your email and password and clicking the "**Log in"** button, or by pressing the Enter key on your keyboard.
100
101 Below is an example of how to complete the fields:
102
giuseppecapaldot-systemscom 1.3 103 (% class="confluence-embedded-file-wrapper confluence-embedded-manual-size" %)[[image:Screenshot 2024-11-19 090916.png||alt="Login page filled" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 104
105
106 (% class="box infomessage" %)
107 (((
108 == Optional Two-Factor Authentication(2FA) Request ==
109
110 If you had to set up two-factor authentication (2FA) for each new login, you'll be asked to enter the one-time code generated by your authenticator application.
111
112 Once you've entered the code, click "**Submit**."
113
114 Below is an example screenshot:
115
giuseppecapaldot-systemscom 1.3 116 [[image:Screenshot 2024-11-19 091946.png||alt="Second Factor Authentication requested" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 117 )))
118
119 With this last step, you have successfully **logged in** and you can now use the application. **Well done**.
120
121
giuseppecapaldot-systemscom 4.1 122 = Forgotten Password{{id name="Forgotten Password"/}} =
DOaaS Operator 1.1 123
124 To access the application, in case you have forgotten your password, start by loading the login screen in your browser.
125
126 On this page there is a link with the text "**Forgot Password?**" click on it to be redirected to the login recovery procedure.
127
128 Here is an example screenshot below:
129
giuseppecapaldot-systemscom 1.3 130 [[image:Screenshot 2024-11-14 155426.png||alt="Page of Log-in" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 131
132 Once you click on the "**Forgot Password?**" link, you will be shown a new page where you just need to enter your email address and then click "**Submit**" or press enter on your keyboard.
133
134 This action will send your email a link with which you can change your password.
135
136 Here is an example screenshot below:
137
giuseppecapaldot-systemscom 1.3 138 [[image:Screenshot 2024-11-19 092035.png||alt="Page of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 139
140
141 (% class="box infomessage" %)
142 (((
143 == Optional Two-Factor Authentication(2FA) Request ==
144
145 If you had to set up two-factor authentication (2FA) for each password change, you'll be asked to enter the one-time code generated by your authenticator application.
146
147 Once you've entered the code, click "**Submit**."
148
149 Below is an example screenshot:
150
giuseppecapaldot-systemscom 1.3 151 [[image:Screenshot 2024-11-19 091946.png||alt="Second Factor Authentication requested" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 152 )))
153
154 You will then have to wait for the **password reset email** to arrive in your **inbox**.
155
156 Of course, it's always a good idea to check the **Spam **section of your inbox or **repeat the steps** if the email doesn't seem to be arriving, before contacting the support.
157
158 Here is a sample screenshot of the email below:
159
giuseppecapaldot-systemscom 1.3 160 [[image:Screenshot 2024-11-19 092201.png||alt="Email of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 161
162 Once you click on the password reset link, your browser will open to a web page. On this webpage, you will be asked to choose a new password that meets the required security criteria.
163
164 Enter your chosen password twice to confirm.
165
166 After completing this step, click "**Submit**."
167
168 Here's a sample screenshot of the page below:
169
giuseppecapaldot-systemscom 1.4 170 [[image:Screenshot 2024-11-19 092226.png||alt="Page of password change" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 171
172 With this last step, you have successfully **reset your password**, and you can now use the application. **Well done**.
173
174
giuseppecapaldot-systemscom 4.1 175 = Change password{{id name="Change password"/}} =
DOaaS Operator 1.1 176
177 If you wish to change your password, the first step is to log in to the portal using your credentials.
178
179 Once you are logged in, locate and click on the "**Account"** drop-down menu in the main menu.
180
181 Within the drop-down menu, you will find an option labeled "**Password**" click on this option to proceed with changing your password.
182
183 Below is an example screenshot:
184
giuseppecapaldot-systemscom 1.4 185 [[image:Screenshot 2024-11-19 144030.png||alt="Triggering Change Password" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 186
187 Once you click on the "**Password**" link, you will be shown a new page.
188
189 On this page, your email address is placed in square brackets.
190
191 You just have to press the "**Request e-mail for new password**" button to send you the email to change your password.
192
193 Here is an example screenshot below:
194
giuseppecapaldot-systemscom 1.4 195 [[image:Screenshot 2024-11-19 144045.png||alt="Password Reset image" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 196
197 You will then have to wait for the **password change email** to arrive in your **inbox**.
198
199 Of course, it's always a good idea to check the **Spam **section of your inbox or **repeat the steps** if the email doesn't seem to be arriving, before contacting the support.
200
201 Here is a sample screenshot of the email below:
202
giuseppecapaldot-systemscom 1.4 203 [[image:Screenshot 2024-11-19 092201.png||alt="Email of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 204
205 Once you click on the password change link, your browser will open to a web page. On this webpage, you will be asked to choose a new password that meets the required security criteria.
206
207 Enter your chosen password twice to confirm.
208
209 After completing this step, click "**Submit**."
210
211 Here's a sample screenshot of the page below:
212
giuseppecapaldot-systemscom 1.4 213 [[image:Screenshot 2024-11-19 092226.png||alt="Page of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 214
215 With this last step, you have successfully **changed your password**, and you can now use the application. **Well done**.
216
217
giuseppecapaldot-systemscom 5.1 218 = Select Languages - Sprachen auswählen{{id name="Select Languages"/}} =
DOaaS Operator 1.1 219
220 The DevOps portal is set to **English **by default, which applies to all web pages and sent emails within the system.
221
222 However, there is an option available on each page we created to change the settings and switch to **German (Deutsch)**.
223
224 Here is a sample screenshot below:
225
giuseppecapaldot-systemscom 1.4 226 [[image:Screenshot 2024-11-21 152351.png||alt="change language" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 227
228 Within the DevOps portal, users have the option to change the language.
229
230 This can be done via the drop-down "**Language**" menu located in the top left corner.
231
232 Any changes made will be applied to the system's web and email pages.
233
giuseppecapaldot-systemscom 1.4 234 [[image:Screenshot 2024-11-21 152713.png||alt="change language in the portal" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 235
236 With this **last step**, you are now aware of all the possibilities for the selected language. **Well done**.
237
238
239 Wenn das DevOps-Portal auf **Deutsch **eingestellt ist, gilt dies für alle Websites und E-Mails, die innerhalb des Systems versendet werden.
240
241 Auf jeder Seite, die wir erstellt haben, steht jedoch eine Option zur Verfügung, um die Einstellungen zu ändern und auf **Englisch(English)** zu wechseln.
242
243 Hier ist ein Beispiel-Screenshot unten:
244
giuseppecapaldot-systemscom 1.4 245 [[image:Screenshot 2024-11-21 152426.png||alt="change language german" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 246
247 Innerhalb des DevOps-Portals haben Benutzer die Möglichkeit, die Sprache zu ändern.
248
249 Dies kann über das Dropdown-Menü "**Sprache**" in der oberen linken Ecke erfolgen.
250
251 Alle vorgenommenen Änderungen werden auf die Web- und E-Mail-Seiten des Systems angewendet.
252
giuseppecapaldot-systemscom 1.4 253 [[image:Screenshot 2024-11-21 154936.png||alt="change language in the portal german" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 254
255 Mit diesem **letzten Schritt** sind Sie sich nun über alle Möglichkeiten für die ausgewählte Sprache im Klaren. **Gut gemacht**.
256
257
258 = The First Access =
259
260 After completing the logging in for the first time, you might find yourself facing a **completely blank page**, as shown in the example screenshot provided below:
261
giuseppecapaldot-systemscom 2.1 262 [[image:Screenshot 2024-11-21 152652.png||alt="no projects" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 263
264 Please do not be **alarmed**. This situation typically indicates that you have not yet been assigned any projects, or there might be a configuration issue.
265
266 The application itself is **functioning correctly**. To address this matter, there are a few steps you can take.
267
268 If you have **contact **information for the **system administrator**, please reach out to them directly for assistance.
269
270 The administrator will be **able to assign** the necessary project or projects or rectify any configuration **problems**.
271
272 If you do not have direct contact with the administrator, you can easily identify them by navigating to the users page located in the main menu.
273
274 This will provide you with the information needed to reach out to the appropriate person **for support**.
275
276 Once everything has been configured correctly and any necessary project assignments have been made, the page **will no longer be empty**.
277
278 Instead, you will see **links to all the tools **and resources you have access to, enabling you to fully utilize the application.
279
280 Here is a sample screenshot below:
281
giuseppecapaldot-systemscom 2.1 282 [[image:Screenshot 2024-11-22 135917.png||alt="nomal login" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 283
284 With this last step, you have successfully **made your first access**. **Well done**.
285
286
287 = The Projects Page =
288
289 In the main menu, one of the most important pages you will encounter is the **Projects page**.
290
291 This page provides a comprehensive overview of all the projects that have been assigned to you, along with a detailed view of their various features and attributes.
292
293 Key informantion available on this page include **Project key**, **Type**, **Status**, and **Project Role**.
294
295 To help you better understand, we have provided an example screenshot below:
296
giuseppecapaldot-systemscom 2.1 297 [[image:Screenshot 2024-11-22 140014.png||alt="projects page" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 298
299 This page also allows you to **search **for projects that you have access to with the search bar under the **Projects **heading.
300
301 While with the **drop-down** menu on the left you can select a **portal user** to see if they have access to the projects you have access to.
302
303 It is important to note that the appearance of this screen may vary depending on your permission level.
304
305 If you have been granted a **higher level of permissions**, your view might look different from the example provided.
306
307 In such cases, you can simply **follow **this link: [[DevOps Portal for Admins>>doc:DevOps Portal for Admins.WebHome]] to access the relevant information.
308
309 For those who need more detailed information about the **individual tools**, we recommend referring to the **specialized pages** dedicated to it.
310
311 These pages offer **in-depth explanations** and **guidance **on how to effectively utilize each tool.
312
313 Here is a list of useful links that you may find helpful for further details:
314
315 * [[Jira>>doc:Jira.WebHome]]
316 * [[Confluence>>doc:Confluence.WebHome]]
317 * [[Bitbucket>>Bitbucket]]
318 * [[Jenkins>>doc:Jenkins.WebHome]]
319 * [[Sonarqube>>doc:SonarQube.WebHome]]
320 * [[Gitea>>doc:Gitea.WebHome]]
321 * [[Harbor>>doc:Harbor.WebHome]]
322 * [[Rancher 2>>doc:Rancher 2.WebHome]]
323
324 With this last step, you have successfully **analized your project page**. **Well done**.
325
326
327 = The Users Page =
328
329 In the main menu, another crucial page you will come across is the **Users **page.
330
331 This page is designed to provide you with a comprehensive overview of all the users who have been **created within the portal**.
332
333 Below, you will find an example screenshot:
334
giuseppecapaldot-systemscom 2.1 335 [[image:Screenshot 2024-11-22 140413.png||alt="User page" data-xwiki-image-style-border="true" class="img-thumbnail"]]
DOaaS Operator 1.1 336
337 The is a **search bar** located under the Users heading enables you to quickly find the **user you are looking** for by entering relevant keywords.
338
339 Additionally, on the **left side** of the page, you will find a **drop-down **menu that allows you to filter the projects to which you have access.
340
341 This feature helps you to streamline your search and view only the users associated with specific projects.
342
343 You can sort the table in both **ascending **and **descending **order by **simply clicking on the headers** of the columns you wish to sort.
344
345 Moreover, the Users page is equipped with easily accessible **contact **information for the **administrators**.
346
347 The information is presented in a clear and straightforward manner, **minimizing **any potential confusion or **delays in communication**.
348
349 With this last step, you have successfully **analized your user page**. **Well done**.