Wiki source code of DevOps Portal for Users
Version 7.2 by DOaaS Operator on 2025/11/13 14:03
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
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 | |||
| |
3.1 | 8 | = Invitation and activation{{id name="Invitation and activation"/}} = |
| |
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 | |||
| |
7.2 | 16 | [[image:1763042544636-589.png||data-xwiki-image-style-border="true"]] |
| |
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 | |||
| |
7.2 | 24 | [[image:1763042597764-495.png||data-xwiki-image-style-border="true"]] |
| |
1.1 | 25 | |
| |
7.2 | 26 | |
| |
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 | |||
| |
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"]]// |
| |
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 | |||
| |
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"]]// |
| |
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 | |||
| |
1.2 | 58 | [[image:Screenshot 2024-11-19 091818.png||alt="Second Factor Authentication setup" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.2 | 78 | [[image:Screenshot 2024-11-14 155231.png||alt="Password creation" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.3 | 84 | [[image:Screenshot 2024-11-14 155401.png||alt="Page of password created" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
4.1 | 89 | = Log in to DevOps Portal{{id name="Log in to DevOps Portal"/}} = |
| |
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 | |||
| |
1.3 | 97 | [[image:Screenshot 2024-11-14 155426.png||alt="Page of Log-in" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
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"]] |
| |
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 | |||
| |
1.3 | 116 | [[image:Screenshot 2024-11-19 091946.png||alt="Second Factor Authentication requested" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
4.1 | 122 | = Forgotten Password{{id name="Forgotten Password"/}} = |
| |
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 | |||
| |
1.3 | 130 | [[image:Screenshot 2024-11-14 155426.png||alt="Page of Log-in" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.3 | 138 | [[image:Screenshot 2024-11-19 092035.png||alt="Page of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.3 | 151 | [[image:Screenshot 2024-11-19 091946.png||alt="Second Factor Authentication requested" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.3 | 160 | [[image:Screenshot 2024-11-19 092201.png||alt="Email of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.4 | 170 | [[image:Screenshot 2024-11-19 092226.png||alt="Page of password change" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
4.1 | 175 | = Change password{{id name="Change password"/}} = |
| |
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 | |||
| |
1.4 | 185 | [[image:Screenshot 2024-11-19 144030.png||alt="Triggering Change Password" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.4 | 195 | [[image:Screenshot 2024-11-19 144045.png||alt="Password Reset image" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.4 | 203 | [[image:Screenshot 2024-11-19 092201.png||alt="Email of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
1.4 | 213 | [[image:Screenshot 2024-11-19 092226.png||alt="Page of password reset" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
5.1 | 218 | = Select Languages - Sprachen auswählen{{id name="Select Languages"/}} = |
| |
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 | |||
| |
1.4 | 226 | [[image:Screenshot 2024-11-21 152351.png||alt="change language" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
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"]] |
| |
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 | |||
| |
1.4 | 245 | [[image:Screenshot 2024-11-21 152426.png||alt="change language german" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
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"]] |
| |
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 | |||
| |
2.1 | 262 | [[image:Screenshot 2024-11-21 152652.png||alt="no projects" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
2.1 | 282 | [[image:Screenshot 2024-11-22 135917.png||alt="nomal login" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
2.1 | 297 | [[image:Screenshot 2024-11-22 140014.png||alt="projects page" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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 | |||
| |
2.1 | 335 | [[image:Screenshot 2024-11-22 140413.png||alt="User page" data-xwiki-image-style-border="true" class="img-thumbnail"]] |
| |
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**. |