From e1cb9ab602387e30d88b88596e16a4ac84fce126 Mon Sep 17 00:00:00 2001
From: edp-bot <SupportEPMD-EDP@epam.com>
Date: Fri, 20 Oct 2023 15:22:14 +0000
Subject: [PATCH] Update documentation

---
 assets/operator-guide/security-tools.png     | Bin 0 -> 3120045 bytes
 operator-guide/overview-devsecops/index.html |   2 +-
 robots.txt                                   |   1 +
 search/search_index.json                     |   2 +-
 sitemap.xml.gz                               | Bin 1457 -> 1457 bytes
 5 files changed, 3 insertions(+), 2 deletions(-)
 create mode 100644 assets/operator-guide/security-tools.png
 create mode 100644 robots.txt

diff --git a/assets/operator-guide/security-tools.png b/assets/operator-guide/security-tools.png
new file mode 100644
index 0000000000000000000000000000000000000000..fbb25e699c38efbbf087b7e5321716813712d160
GIT binary patch
literal 3120045
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%0AX}lp9~_Y+{}m8L_ulzboJLr3!BQ0A#s9V*2@7!
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%0DU%2qi?v!DTKF}WgJ0)xs5=xA
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%0DchL=F
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%0DZ1~QG@c7EX{*wQ!;b-AAC?|2
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%0AH?+2RExXdDj?cLrS`~&6Bs7IX|<w$@4DX(
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%0Aa=Y{~h>p_q4pl2j7kh7#dr1Ftyw@{4)
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%0AwV0a
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

literal 0
HcmV?d00001

diff --git a/operator-guide/overview-devsecops/index.html b/operator-guide/overview-devsecops/index.html
index d03848132..b39df2361 100644
--- a/operator-guide/overview-devsecops/index.html
+++ b/operator-guide/overview-devsecops/index.html
@@ -1 +1 @@
-<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="The EPAM Delivery Platform emphasizes the importance of incorporating security practices into the software development lifecycle through the DevSecOps approach. By integrating a diverse range of open-source and enterprise security tools tailored to specific functionalities, organizations can ensure efficient and secure software development. These tools, combined with fundamental DevSecOps principles such as collaboration, continuous security, and automation, contribute to the identification and remediation of vulnerabilities early in the process, minimizes risks, and fosters a security-first culture across the organization."><link href=https://epam.github.io/edp-install/operator-guide/overview-devsecops/ rel=canonical><link href=../external-secrets-operator-integration/ rel=prev><link href=../install-velero/ rel=next><link rel=icon href=../../assets/favicon.png><meta name=generator content="mkdocs-1.4.3, mkdocs-material-9.1.19"><title>Secure Delivery - EPAM Delivery Platform</title><link rel=stylesheet href=../../assets/stylesheets/main.eebd395e.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ecc896b0.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=https://cdn.jsdelivr.net/gh/fancyapps/fancybox@3.5.7/dist/jquery.fancybox.min.css><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function n(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],n("js",new Date),n("config","G-7ZV6PJ2LSP"),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){this.value&&n("event","search",{search_term:this.value})}),document$.subscribe(function(){var a=document.forms.feedback;if(void 0!==a)for(var e of a.querySelectorAll("[type=submit]"))e.addEventListener("click",function(e){e.preventDefault();var t=document.location.pathname,e=this.getAttribute("data-md-value");n("event","feedback",{page:t,data:e}),a.firstElementChild.disabled=!0;e=a.querySelector(".md-feedback__note [data-md-value='"+e+"']");e&&(e.hidden=!1)}),a.hidden=!1}),location$.subscribe(function(e){n("config","G-7ZV6PJ2LSP",{page_path:e.pathname})})});var e=document.createElement("script");e.async=!0,e.src="https://www.googletagmanager.com/gtag/js?id=G-7ZV6PJ2LSP",document.getElementById("__analytics").insertAdjacentElement("afterEnd",e)}</script><script>var consent;"undefined"==typeof __md_analytics||(consent=__md_get("__consent"))&&consent.analytics&&__md_analytics()</script><meta name=msvalidate.01 content=0A0BD75C41E23DEE0C6F5DB33E1BECBC></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=cyan data-md-color-accent=blue> <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#secure-delivery-on-the-platform class=md-skip> Skip to content </a> </div> <div data-md-component=announce> <aside class=md-banner> <div class="md-banner__inner md-grid md-typeset"> <button class="md-banner__button md-icon" aria-label="Don't show this again"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg> </button> EDP Team Supports Ukraine 🇺🇦<br> In solidarity, we ask that you consider financially supporting the organizations below:<br> <a href=https://epamuafund.pinkaloo.com/causes/159bdd2f71854adf8ed5251fe26d2fe0 target=_blank>EPAM’s Global Partners for the Ukraine Humanitarian Crisis</a> </div> <script>var content,el=document.querySelector("[data-md-component=announce]");el&&(content=el.querySelector(".md-typeset"),__md_hash(content.innerHTML)===__md_get("__announce")&&(el.hidden=!0))</script> </aside> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="EPAM Delivery Platform" class="md-header__button md-logo" aria-label="EPAM Delivery Platform" data-md-component=logo> <img src=../../assets/logo.png alt=logo> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> EPAM Delivery Platform </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Secure Delivery </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media data-md-color-scheme=default data-md-color-primary=cyan data-md-color-accent=blue aria-label="Switch to dark mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_2 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg> </label> <input class=md-option data-md-color-media data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_2> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg> </label> </form> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7 0-.24-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91 1.61 0 2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08Z"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/epam/edp-install title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> </div> <div class=md-source__repository> GitHub </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../overview/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../ class="md-tabs__link md-tabs__link--active"> Operator Guide </a> </li> <li class=md-tabs__item> <a href=../../user-guide/ class=md-tabs__link> User Guide </a> </li> <li class=md-tabs__item> <a href=../../developer-guide/ class=md-tabs__link> Developer Guide </a> </li> <li class=md-tabs__item> <a href=../../use-cases/ class=md-tabs__link> Use Cases </a> </li> <li class=md-tabs__item> <a href=../../faq/ class=md-tabs__link> FAQ </a> </li> <li class=md-tabs__item> <a href=../../roadmap/ class=md-tabs__link> RoadMap </a> </li> <li class=md-tabs__item> <a href=https://github.com/epam/edp-install/blob/master/RELEASES.md class=md-tabs__link> Releases ⧉ </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="EPAM Delivery Platform" class="md-nav__button md-logo" aria-label="EPAM Delivery Platform" data-md-component=logo> <img src=../../assets/logo.png alt=logo> </a> EPAM Delivery Platform </label> <div class=md-nav__source> <a href=https://github.com/epam/edp-install title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> </div> <div class=md-source__repository> GitHub </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> Home </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_2> <label class=md-nav__link for=__nav_2 id=__nav_2_label tabindex=0> Getting Started <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../overview/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../../features/ class=md-nav__link> Basic Concepts </a> </li> <li class=md-nav__item> <a href=../../getting-started/ class=md-nav__link> Quick Start </a> </li> <li class=md-nav__item> <a href=../../glossary/ class=md-nav__link> Glossary </a> </li> <li class=md-nav__item> <a href=../../supported-versions/ class=md-nav__link> Supported Versions and Compatibility </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3 checked> <label class=md-nav__link for=__nav_3 id=__nav_3_label tabindex=0> Operator Guide <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=true> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Operator Guide </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> Overview </a> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2> <label class=md-nav__link for=__nav_3_2 id=__nav_3_2_label tabindex=0> Installation <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2> <span class="md-nav__icon md-icon"></span> Installation </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2_1> <label class=md-nav__link for=__nav_3_2_1 id=__nav_3_2_1_label tabindex=0> Prerequisites <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2_1> <span class="md-nav__icon md-icon"></span> Prerequisites </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../prerequisites/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../kubernetes-cluster-settings/ class=md-nav__link> Set Up Kubernetes </a> </li> <li class=md-nav__item> <a href=../openshift-cluster-settings/ class=md-nav__link> Set Up OpenShift </a> </li> <li class=md-nav__item> <a href=../install-ingress-nginx/ class=md-nav__link> Install NGINX Ingress Controller </a> </li> <li class=md-nav__item> <a href=../install-keycloak/ class=md-nav__link> Install Keycloak </a> </li> <li class=md-nav__item> <a href=../install-defectdojo/ class=md-nav__link> Install DefectDojo </a> </li> <li class=md-nav__item> <a href=../install-reportportal/ class=md-nav__link> Install ReportPortal </a> </li> <li class=md-nav__item> <a href=../install-argocd/ class=md-nav__link> Install Argo CD </a> </li> <li class=md-nav__item> <a href=../install-tekton/ class=md-nav__link> Install Tekton </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2_1_10> <label class=md-nav__link for=__nav_3_2_1_10 id=__nav_3_2_1_10_label tabindex=0> Multi-Tenancy <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_2_1_10_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2_1_10> <span class="md-nav__icon md-icon"></span> Multi-Tenancy </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../capsule/ class=md-nav__link> Capsule </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2_1_10_2> <label class=md-nav__link for=__nav_3_2_1_10_2 id=__nav_3_2_1_10_2_label tabindex=0> Kiosk <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_3_2_1_10_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2_1_10_2> <span class="md-nav__icon md-icon"></span> Kiosk </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../edp-kiosk-usage/ class=md-nav__link> EDP Kiosk Usage </a> </li> <li class=md-nav__item> <a href=../install-kiosk/ class=md-nav__link> Set Up Kiosk </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../install-harbor/ class=md-nav__link> Install Harbor </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../install-edp/ class=md-nav__link> Install EDP </a> </li> <li class=md-nav__item> <a href=../install-via-helmfile/ class=md-nav__link> Install via Helmfile </a> </li> <li class=md-nav__item> <a href=../aws-marketplace-install/ class=md-nav__link> Install via AWS Marketplace </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3> <label class=md-nav__link for=__nav_3_3 id=__nav_3_3_label tabindex=0> Configuration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3> <span class="md-nav__icon md-icon"></span> Configuration </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../edp-access-model/ class=md-nav__link> EDP Access Model </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2> <label class=md-nav__link for=__nav_3_3_2 id=__nav_3_3_2_label tabindex=0> Version Control Systems <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_3_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2> <span class="md-nav__icon md-icon"></span> Version Control Systems </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../vcs/ class=md-nav__link> Overview </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_2> <label class=md-nav__link for=__nav_3_3_2_2 id=__nav_3_3_2_2_label tabindex=0> Jenkins Scenario <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_3_2_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_2> <span class="md-nav__icon md-icon"></span> Jenkins Scenario </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../import-strategy-jenkins/ class=md-nav__link> Integrate GitHub/GitLab in Jenkins </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_2_2> <label class=md-nav__link for=__nav_3_3_2_2_2 id=__nav_3_3_2_2_2_label tabindex=0> GitHub <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_3_3_2_2_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_2_2> <span class="md-nav__icon md-icon"></span> GitHub </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../github-integration/ class=md-nav__link> GitHub Webhook Configuration </a> </li> <li class=md-nav__item> <a href=../github-debug-webhooks/ class=md-nav__link> Debug GitHub Webhooks in Jenkins </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_2_3> <label class=md-nav__link for=__nav_3_3_2_2_3 id=__nav_3_3_2_2_3_label tabindex=0> GitLab <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_3_3_2_2_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_2_3> <span class="md-nav__icon md-icon"></span> GitLab </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../gitlab-integration/ class=md-nav__link> GitLab Webhook Configuration </a> </li> <li class=md-nav__item> <a href=../gitlab-debug-webhooks/ class=md-nav__link> Debug GitLab Webhooks in Jenkins </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_3> <label class=md-nav__link for=__nav_3_3_2_3 id=__nav_3_3_2_3_label tabindex=0> Tekton Scenario <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_3_2_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_3> <span class="md-nav__icon md-icon"></span> Tekton Scenario </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../import-strategy-tekton/ class=md-nav__link> Integrate GitHub/GitLab in Tekton </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_3> <label class=md-nav__link for=__nav_3_3_3 id=__nav_3_3_3_label tabindex=0> Manage Jenkins Pipelines <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_3_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_3> <span class="md-nav__icon md-icon"></span> Manage Jenkins Pipelines </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../overview-manage-jenkins-pipelines/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../manage-jenkins-ci-job-provision/ class=md-nav__link> Manage Jenkins CI Pipeline Job Provisioner </a> </li> <li class=md-nav__item> <a href=../manage-jenkins-cd-job-provision/ class=md-nav__link> Manage Jenkins CD Pipeline Job Provisioner </a> </li> <li class=md-nav__item> <a href=../delete-jenkins-job-provision/ class=md-nav__link> Delete Jenkins Job Provision </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../headlamp-oidc/ class=md-nav__link> Headlamp OIDC </a> </li> <li class=md-nav__item> <a href=../namespace-management/ class=md-nav__link> Manage Namespace </a> </li> <li class=md-nav__item> <a href=../eks-oidc-integration/ class=md-nav__link> EKS OIDC Integration </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_7> <label class=md-nav__link for=__nav_3_3_7 id=__nav_3_3_7_label tabindex=0> Jira <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_3_7_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_7> <span class="md-nav__icon md-icon"></span> Jira </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jira-integration/ class=md-nav__link> Adjust Jira Integration </a> </li> <li class=md-nav__item> <a href=../jira-gerrit-integration/ class=md-nav__link> Adjust VCS Integration With Jira </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4> <label class=md-nav__link for=__nav_3_4 id=__nav_3_4_label tabindex=0> Integration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_4_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4> <span class="md-nav__icon md-icon"></span> Integration </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add-ons-overview/ class=md-nav__link> Cluster Add-Ons </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_2> <label class=md-nav__link for=__nav_3_4_2 id=__nav_3_4_2_label tabindex=0> Tekton <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_2> <span class="md-nav__icon md-icon"></span> Tekton </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tekton-overview/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../tekton-monitoring/ class=md-nav__link> Monitoring </a> </li> <li class=md-nav__item> <a href=../notification-msteams/ class=md-nav__link> MS Teams Notification </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_3> <label class=md-nav__link for=__nav_3_4_3 id=__nav_3_4_3_label tabindex=0> Container Registry <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_3> <span class="md-nav__icon md-icon"></span> Container Registry </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_3_1> <label class=md-nav__link for=__nav_3_4_3_1 id=__nav_3_4_3_1_label tabindex=0> Harbor <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_4_3_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_3_1> <span class="md-nav__icon md-icon"></span> Harbor </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../container-registry-harbor-integration-tekton-ci/ class=md-nav__link> Harbor Integration </a> </li> <li class=md-nav__item> <a href=../harbor-oidc/ class=md-nav__link> OIDC in Harbor </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_4> <label class=md-nav__link for=__nav_3_4_4 id=__nav_3_4_4_label tabindex=0> AWS Integration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_4_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_4> <span class="md-nav__icon md-icon"></span> AWS Integration </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../waf-tf-configuration/ class=md-nav__link> Configure AWS WAF With Terraform </a> </li> <li class=md-nav__item> <a href=../ebs-csi-driver/ class=md-nav__link> Install Amazon EBS CSI Driver </a> </li> <li class=md-nav__item> <a href=../enable-irsa/ class=md-nav__link> Associate IAM Roles With Service Accounts </a> </li> <li class=md-nav__item> <a href=../kaniko-irsa/ class=md-nav__link> IAM Roles for Kaniko Service Accounts </a> </li> <li class=md-nav__item> <a href=../velero-irsa/ class=md-nav__link> IAM Roles for Velero Service Accounts </a> </li> <li class=md-nav__item> <a href=../loki-irsa/ class=md-nav__link> IAM Roles for Loki Service Accounts </a> </li> <li class=md-nav__item> <a href=../configure-keycloak-oidc-eks/ class=md-nav__link> EKS OIDC With Keycloak </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../perf-integration/ class=md-nav__link> Perf Server Integration </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_6> <label class=md-nav__link for=__nav_3_4_6 id=__nav_3_4_6_label tabindex=0> ReportPortal <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_6_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_6> <span class="md-nav__icon md-icon"></span> ReportPortal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reportportal-keycloak/ class=md-nav__link> Keycloak Integration </a> </li> <li class=md-nav__item> <a href=../report-portal-integration-tekton/ class=md-nav__link> Integration With Tekton </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../logsight-integration/ class=md-nav__link> Logsight Integration </a> </li> <li class=md-nav__item> <a href=../dependency-track/ class=md-nav__link> DependencyTrack </a> </li> <li class=md-nav__item> <a href=../sonarqube/ class=md-nav__link> SonarQube </a> </li> <li class=md-nav__item> <a href=../nexus-sonatype/ class=md-nav__link> Nexus Sonatype </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5 checked> <label class=md-nav__link for=__nav_3_5 id=__nav_3_5_label tabindex=0> Platform Capabilities <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_5_label aria-expanded=true> <label class=md-nav__title for=__nav_3_5> <span class="md-nav__icon md-icon"></span> Platform Capabilities </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_1> <label class=md-nav__link for=__nav_3_5_1 id=__nav_3_5_1_label tabindex=0> GitOps <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_1> <span class="md-nav__icon md-icon"></span> GitOps </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../argocd-integration/ class=md-nav__link> Argo CD Integration </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_2> <label class=md-nav__link for=__nav_3_5_2 id=__nav_3_5_2_label tabindex=0> Secrets Management <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_2> <span class="md-nav__icon md-icon"></span> Secrets Management </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../install-external-secrets-operator/ class=md-nav__link> Install External Secrets Operator </a> </li> <li class=md-nav__item> <a href=../external-secrets-operator-integration/ class=md-nav__link> External Secrets Operator Integration </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_3 checked> <label class=md-nav__link for=__nav_3_5_3 id=__nav_3_5_3_label tabindex=0> DevSecOps <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_3_label aria-expanded=true> <label class=md-nav__title for=__nav_3_5_3> <span class="md-nav__icon md-icon"></span> DevSecOps </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> Secure Delivery <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> Secure Delivery </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#supported-solutions class=md-nav__link> Supported Solutions </a> <nav class=md-nav aria-label="Supported Solutions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#defectdojo class=md-nav__link> DefectDojo </a> </li> <li class=md-nav__item> <a href=#owasp-dependency-track class=md-nav__link> OWASP Dependency Track </a> </li> <li class=md-nav__item> <a href=#gitleaks class=md-nav__link> Gitleaks </a> </li> <li class=md-nav__item> <a href=#trivy class=md-nav__link> Trivy </a> </li> <li class=md-nav__item> <a href=#grype class=md-nav__link> Grype </a> </li> <li class=md-nav__item> <a href=#tfsec class=md-nav__link> Tfsec </a> </li> <li class=md-nav__item> <a href=#checkov class=md-nav__link> Checkov </a> </li> <li class=md-nav__item> <a href=#cdxgen class=md-nav__link> Cdxgen </a> </li> <li class=md-nav__item> <a href=#semgrep-cli class=md-nav__link> Semgrep CLI </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_4> <label class=md-nav__link for=__nav_3_5_4 id=__nav_3_5_4_label tabindex=0> Backup With Velero <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_4_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_4> <span class="md-nav__icon md-icon"></span> Backup With Velero </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../install-velero/ class=md-nav__link> Install Velero </a> </li> <li class=md-nav__item> <a href=../restore-edp-with-velero/ class=md-nav__link> Restore EDP Tenant With Velero </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_5> <label class=md-nav__link for=__nav_3_5_5 id=__nav_3_5_5_label tabindex=0> Logging <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_5_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_5> <span class="md-nav__icon md-icon"></span> Logging </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../install-loki/ class=md-nav__link> Install Grafana Loki </a> </li> <li class=md-nav__item> <a href=../multitenant-logging/ class=md-nav__link> Multitenant Logging </a> </li> <li class=md-nav__item> <a href=../schedule-pods-restart/ class=md-nav__link> Schedule Pods Restart </a> </li> <li class=md-nav__item> <a href=../kibana-ilm-rollover/ class=md-nav__link> Aggregate Application Logs Using EFK Stack </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../manage-custom-certificate/ class=md-nav__link> Manage Custom Certificates </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_7> <label class=md-nav__link for=__nav_3_5_7 id=__nav_3_5_7_label tabindex=0> Single Sign-on <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_7_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_7> <span class="md-nav__icon md-icon"></span> Single Sign-on </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../oauth2-proxy/ class=md-nav__link> Protect Endpoints </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6> <label class=md-nav__link for=__nav_3_6 id=__nav_3_6_label tabindex=0> Upgrade <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_6_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6> <span class="md-nav__icon md-icon"></span> Upgrade </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6_1> <label class=md-nav__link for=__nav_3_6_1 id=__nav_3_6_1_label tabindex=0> EDP <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_6_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6_1> <span class="md-nav__icon md-icon"></span> EDP </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../upgrade-edp-3.5/ class=md-nav__link> v3.4 to 3.5 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.4/ class=md-nav__link> v3.3 to 3.4 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.3/ class=md-nav__link> v3.2 to 3.3 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.2/ class=md-nav__link> v3.1 to 3.2 </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6_1_5> <label class=md-nav__link for=__nav_3_6_1_5 id=__nav_3_6_1_5_label tabindex=0> Older Versions <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_6_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6_1_5> <span class="md-nav__icon md-icon"></span> Older Versions </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../upgrade-edp-3.1/ class=md-nav__link> v3.0 to 3.1 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.0/ class=md-nav__link> v2.12 to 3.0 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.12/ class=md-nav__link> v2.11 to 2.12 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.11/ class=md-nav__link> v2.10 to 2.11 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.10/ class=md-nav__link> v2.9 to 2.10 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.9/ class=md-nav__link> v2.8 to 2.9 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.8/ class=md-nav__link> v2.7 to 2.8 </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6_2> <label class=md-nav__link for=__nav_3_6_2 id=__nav_3_6_2_label tabindex=0> Keycloak <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_6_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6_2> <span class="md-nav__icon md-icon"></span> Keycloak </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../upgrade-keycloak-19.0/ class=md-nav__link> v17.0 to 19.0 </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_7> <label class=md-nav__link for=__nav_3_7 id=__nav_3_7_label tabindex=0> Tutorials <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_7_label aria-expanded=false> <label class=md-nav__title for=__nav_3_7> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/terraform-stages/ class=md-nav__link> CI Pipelines for Terraform </a> </li> <li class=md-nav__item> <a href=../deploy-aws-eks/ class=md-nav__link> Deploy AWS EKS Cluster </a> </li> <li class=md-nav__item> <a href=../deploy-okd/ class=md-nav__link> Deploy OKD 4.9 Cluster </a> </li> <li class=md-nav__item> <a href=../deploy-okd-4.10/ class=md-nav__link> Deploy OKD 4.10 Cluster </a> </li> <li class=md-nav__item> <a href=../ssl-automation-okd/ class=md-nav__link> Use Cert-Manager in OpenShift </a> </li> <li class=md-nav__item> <a href=../add-jenkins-agent/ class=md-nav__link> Manage Jenkins Agent </a> </li> <li class=md-nav__item> <a href=../kibana-ilm-rollover/ class=md-nav__link> Aggregate Application Logs Using EFK Stack </a> </li> <li class=md-nav__item> <a href=../migrate-ci-pipelines-from-jenkins-to-tekton/ class=md-nav__link> Migrate CI Pipelines From Jenkins to Tekton </a> </li> <li class=md-nav__item> <a href=../delete-edp/ class=md-nav__link> Uninstall EDP </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex=0> User Guide <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> User Guide </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/ class=md-nav__link> Overview </a> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_2> <label class=md-nav__link for=__nav_4_2 id=__nav_4_2_label tabindex=0> Marketplace <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_2_label aria-expanded=false> <label class=md-nav__title for=__nav_4_2> <span class="md-nav__icon md-icon"></span> Marketplace </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/marketplace/ class=md-nav__link> Marketplace Overview </a> </li> <li class=md-nav__item> <a href=../../user-guide/add-marketplace/ class=md-nav__link> Add Component via Marketplace </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3> <label class=md-nav__link for=__nav_4_3 id=__nav_4_3_label tabindex=0> Components <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_3_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3> <span class="md-nav__icon md-icon"></span> Components </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_1> <label class=md-nav__link for=__nav_4_3_1 id=__nav_4_3_1_label tabindex=0> Application <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_1_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_1> <span class="md-nav__icon md-icon"></span> Application </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-application/ class=md-nav__link> Add Application </a> </li> <li class=md-nav__item> <a href=../../user-guide/application/ class=md-nav__link> Manage Applications </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_2> <label class=md-nav__link for=__nav_4_3_2 id=__nav_4_3_2_label tabindex=0> Autotest <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_2_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_2> <span class="md-nav__icon md-icon"></span> Autotest </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-autotest/ class=md-nav__link> Add Autotest </a> </li> <li class=md-nav__item> <a href=../../user-guide/autotest/ class=md-nav__link> Manage Autotests </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_3> <label class=md-nav__link for=__nav_4_3_3 id=__nav_4_3_3_label tabindex=0> Library <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_3_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_3> <span class="md-nav__icon md-icon"></span> Library </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-library/ class=md-nav__link> Add Library </a> </li> <li class=md-nav__item> <a href=../../user-guide/library/ class=md-nav__link> Manage Libraries </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_4> <label class=md-nav__link for=__nav_4_3_4 id=__nav_4_3_4_label tabindex=0> Infrastructure <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_4> <span class="md-nav__icon md-icon"></span> Infrastructure </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-infrastructure/ class=md-nav__link> Add Infrastructure </a> </li> <li class=md-nav__item> <a href=../../user-guide/infrastructure/ class=md-nav__link> Manage Infrastructures </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../../user-guide/manage-branches/ class=md-nav__link> Manage Branches </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_4> <label class=md-nav__link for=__nav_4_4 id=__nav_4_4_label tabindex=0> Environments <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4_4> <span class="md-nav__icon md-icon"></span> Environments </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-cd-pipeline/ class=md-nav__link> Add CD Pipeline </a> </li> <li class=md-nav__item> <a href=../../user-guide/add-quality-gate/ class=md-nav__link> Add Quality Gate </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5> <label class=md-nav__link for=__nav_4_5 id=__nav_4_5_label tabindex=0> Configuration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_5_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5> <span class="md-nav__icon md-icon"></span> Configuration </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5_1> <label class=md-nav__link for=__nav_4_5_1 id=__nav_4_5_1_label tabindex=0> Git Server <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_5_1_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5_1> <span class="md-nav__icon md-icon"></span> Git Server </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/git-server-overview/ class=md-nav__link> Manage Git Servers </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5_2> <label class=md-nav__link for=__nav_4_5_2 id=__nav_4_5_2_label tabindex=0> Cluster <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_5_2_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5_2> <span class="md-nav__icon md-icon"></span> Cluster </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-cluster/ class=md-nav__link> Add Cluster </a> </li> <li class=md-nav__item> <a href=../../user-guide/cluster/ class=md-nav__link> Manage Clusters </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5_3> <label class=md-nav__link for=__nav_4_5_3 id=__nav_4_5_3_label tabindex=0> GitOps <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_5_3_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5_3> <span class="md-nav__icon md-icon"></span> GitOps </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/gitops/ class=md-nav__link> Manage GitOps </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> Developer Guide <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Developer Guide </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../developer-guide/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../../developer-guide/local-development/ class=md-nav__link> Workspace Setup Manual </a> </li> <li class=md-nav__item> <a href=../../developer-guide/mk-docs-development/ class=md-nav__link> Documentation Flow </a> </li> <li class=md-nav__item> <a href=../../developer-guide/edp-workflow/ class=md-nav__link> EDP Project Rules. Working Process </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> Use Cases <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Use Cases </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../use-cases/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../../use-cases/application-scaffolding/ class=md-nav__link> Scaffold and Deploy FastAPI Application </a> </li> <li class=md-nav__item> <a href=../../use-cases/tekton-custom-pipelines/ class=md-nav__link> Deploy Application With Custom Build Tool/Framework </a> </li> <li class=md-nav__item> <a href=../../use-cases/external-secrets/ class=md-nav__link> Secured Secrets Management for Application Deployment </a> </li> <li class=md-nav__item> <a href=../../use-cases/autotest-as-quality-gate/ class=md-nav__link> Autotest as a Quality Gate </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../../faq/ class=md-nav__link> FAQ </a> </li> <li class=md-nav__item> <a href=../../roadmap/ class=md-nav__link> RoadMap </a> </li> <li class=md-nav__item> <a href=https://github.com/epam/edp-install/blob/master/RELEASES.md class=md-nav__link> Releases ⧉ </a> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#supported-solutions class=md-nav__link> Supported Solutions </a> <nav class=md-nav aria-label="Supported Solutions"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#defectdojo class=md-nav__link> DefectDojo </a> </li> <li class=md-nav__item> <a href=#owasp-dependency-track class=md-nav__link> OWASP Dependency Track </a> </li> <li class=md-nav__item> <a href=#gitleaks class=md-nav__link> Gitleaks </a> </li> <li class=md-nav__item> <a href=#trivy class=md-nav__link> Trivy </a> </li> <li class=md-nav__item> <a href=#grype class=md-nav__link> Grype </a> </li> <li class=md-nav__item> <a href=#tfsec class=md-nav__link> Tfsec </a> </li> <li class=md-nav__item> <a href=#checkov class=md-nav__link> Checkov </a> </li> <li class=md-nav__item> <a href=#cdxgen class=md-nav__link> Cdxgen </a> </li> <li class=md-nav__item> <a href=#semgrep-cli class=md-nav__link> Semgrep CLI </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=secure-delivery-on-the-platform>Secure Delivery on the Platform<a class=headerlink href=#secure-delivery-on-the-platform title="Permanent link">⚓︎</a></h1> <p>The EPAM Delivery Platform emphasizes the importance of incorporating security practices into the software development lifecycle through the DevSecOps approach. By integrating a diverse range of open-source and enterprise security tools tailored to specific functionalities, organizations can ensure efficient and secure software development. These tools, combined with fundamental DevSecOps principles such as collaboration, continuous security, and automation, contribute to the identification and remediation of vulnerabilities early in the process, minimizes risks, and fosters a security-first culture across the organization.</p> <p>The EPAM Delivery Platform enabling seamless integration with various security tools and vulnerability management systems, enhancing the security of source code and ensuring compliance.</p> <h2 id=supported-solutions>Supported Solutions<a class=headerlink href=#supported-solutions title="Permanent link">⚓︎</a></h2> <p>The below table categorizes various open-source and enterprise security tools based on their specific functionalities. It provides a comprehensive view of the available options for each security aspect. This classification facilitates informed decision-making when selecting and integrating security tools into a development pipeline, ensuring an efficient and robust security stance. EDP supports the integration of both open-source and enterprise security tools, providing a flexible and versatile solution for security automation. See table below for more details.</p> <table> <thead> <tr> <th align=center>Functionality</th> <th>Open-Source Tools (integrated in Pipelines)</th> <th>Enterprise Tools (available for Integration)</th> </tr> </thead> <tbody> <tr> <td align=center>Hardcoded Credentials Scanner</td> <td>TruffleHog, GitLeaks, GitSecrets</td> <td>GitGuardian, SpectralOps, Bridgecrew</td> </tr> <tr> <td align=center>Static Application Security Testing</td> <td>SonarQube, Semgrep CLI</td> <td>Veracode, Checkmarx, Coverity</td> </tr> <tr> <td align=center>Software Composition Analysis</td> <td>OWASP Dependency-Check, cdxgen, Nancy</td> <td>Black Duck Hub, Mend, Snyk</td> </tr> <tr> <td align=center>Container Security</td> <td>Trivy, Grype, Clair</td> <td>Aqua Security, Sysdig Secure, Snyk</td> </tr> <tr> <td align=center>Infrastructure as Code Security</td> <td>Checkov, Tfsec</td> <td>Bridgecrew, Prisma Cloud, Snyk</td> </tr> <tr> <td align=center>Dynamic Application Security Testing</td> <td>OWASP Zed Attack Proxy</td> <td>Fortify WebInspect, Rapid7 InsightAppSec, Checkmarx</td> </tr> <tr> <td align=center>Continuous Monitoring and Logging</td> <td>ELK Stack, OpenSearch, Loki</td> <td>Splunk, Datadog</td> </tr> <tr> <td align=center>Security Audits and Assessments</td> <td>OpenVAS</td> <td>Tenable Nessus, QualysGuard, BurpSuite Professional</td> </tr> <tr> <td align=center>Vulnerability Management and Reporting</td> <td>DefectDojo, OWASP Dependency-Track</td> <td>-</td> </tr> </tbody> </table> <p>For obtaining and managing report post scanning, deployment of various vulnerability management systems and security tools is required. These include:</p> <h3 id=defectdojo>DefectDojo<a class=headerlink href=#defectdojo title="Permanent link">⚓︎</a></h3> <p><a href=https://www.defectdojo.com/ >DefectDojo</a> is a comprehensive vulnerability management and security orchestration platform facilitating the handling of uploaded security reports. Examine the prerequisites and fundamental instructions for <a href=../install-defectdojo/ >installing DefectDojo</a> on Kubernetes or OpenShift platforms.</p> <h3 id=owasp-dependency-track>OWASP Dependency Track<a class=headerlink href=#owasp-dependency-track title="Permanent link">⚓︎</a></h3> <p><a href=https://dependencytrack.org/ >Dependency Track</a> is an intelligent Software Composition Analysis (SCA) platform that provides a comprehensive solution for managing vulnerabilities in third-party and open-source components.</p> <h3 id=gitleaks>Gitleaks<a class=headerlink href=#gitleaks title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/zricethezav/gitleaks>Gitleaks</a> is a versatile SAST tool used to scan Git repositories for hardcoded secrets, such as passwords and API keys, to prevent potential data leaks and unauthorized access.</p> <h3 id=trivy>Trivy<a class=headerlink href=#trivy title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/aquasecurity/trivy>Trivy</a> is a simple and comprehensive vulnerability scanner for containers and other artifacts, providing insight into potential security issues across multiple ecosystems.</p> <h3 id=grype>Grype<a class=headerlink href=#grype title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/anchore/grype>Grype</a> is a fast and reliable vulnerability scanner for container images and filesystems, maintaining an up-to-date vulnerability database for efficient and accurate scanning.</p> <h3 id=tfsec>Tfsec<a class=headerlink href=#tfsec title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/aquasecurity/tfsec>Tfsec</a> is an effective Infrastructure as Code (IaC) security scanner, tailored specifically for reviewing Terraform templates. It helps identify potential security issues related to misconfigurations and non-compliant practices, enabling developers to address vulnerabilities and ensure secure infrastructure deployment.</p> <h3 id=checkov>Checkov<a class=headerlink href=#checkov title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/bridgecrewio/checkov>Checkov</a> is a robust static code analysis tool designed for IaC security, supporting various IaC frameworks such as Terraform, CloudFormation, and Kubernetes. It assists in detecting and mitigating security and compliance misconfigurations, promoting best practices and adherence to industry standards across the infrastructure.</p> <h3 id=cdxgen>Cdxgen<a class=headerlink href=#cdxgen title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/AppThreat/cdxgen>Cdxgen</a> is a lightweight and efficient tool for generating Software Bill of Materials (SBOM) using CycloneDX, a standard format for managing component inventory. It helps organizations maintain an up-to-date record of all software components, their versions, and related vulnerabilities, streamlining monitoring and compliance within the software supply chain.</p> <h3 id=semgrep-cli>Semgrep CLI<a class=headerlink href=#semgrep-cli title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/returntocorp/semgrep>Semgrep CLI</a> is a versatile and user-friendly command-line interface for the Semgrep security scanner, enabling developers to perform Static Application Security Testing (SAST) for various programming languages. It focuses on detecting and preventing potential security vulnerabilities, code quality issues, and custom anti-patterns, ensuring secure and efficient code development.</p> <form class=md-feedback name=feedback hidden> <fieldset> <legend class=md-feedback__title> Was this page helpful? </legend> <div class=md-feedback__inner> <div class=md-feedback__list> <button class="md-feedback__icon md-icon" type=submit title="This page was helpful" data-md-value=1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m7 0c0 .8-.7 1.5-1.5 1.5S14 10.3 14 9.5 14.7 8 15.5 8s1.5.7 1.5 1.5m-5 7.73c-1.75 0-3.29-.73-4.19-1.81L9.23 14c.45.72 1.52 1.23 2.77 1.23s2.32-.51 2.77-1.23l1.42 1.42c-.9 1.08-2.44 1.81-4.19 1.81Z"/></svg> </button> <button class="md-feedback__icon md-icon" type=submit title="This page could be improved" data-md-value=0> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10m-6.5-4c.8 0 1.5.7 1.5 1.5s-.7 1.5-1.5 1.5-1.5-.7-1.5-1.5.7-1.5 1.5-1.5M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m2 4.5c1.75 0 3.29.72 4.19 1.81l-1.42 1.42C14.32 16.5 13.25 16 12 16s-2.32.5-2.77 1.23l-1.42-1.42C8.71 14.72 10.25 14 12 14Z"/></svg> </button> </div> <div class=md-feedback__note> <div data-md-value=1 hidden> Thanks for your feedback! </div> <div data-md-value=0 hidden> Thanks for your feedback! Help us improve this page by using our <a href=... target=_blank rel=noopener>feedback form</a>. </div> </div> </div> </fieldset> </form> </article> </div> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg> Back to top </button> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <!-- Copyright and theme information --> <div class=md-footer-copyright> <div class=md-footer-copyright__highlight> Copyright &copy; 2018 - 2023 EPAM Delivery Platform - <a href=#__consent>Change cookie settings</a> </div> powered by <a href=https://www.mkdocs.org title=MkDocs>MkDocs</a> and <a href=https://squidfunk.github.io/mkdocs-material/ title="Material for MkDocs"> Material for MkDocs</a> </div> <div class=md-social> <a href=https://www.youtube.com/@theplatformteam target=_blank rel=noopener title=www.youtube.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 576 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"/></svg> </a> <a href=https://medium.com/epam-delivery-platform target=_blank rel=noopener title=medium.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 640 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M180.5 74.262C80.813 74.262 0 155.633 0 256s80.819 181.738 180.5 181.738S361 356.373 361 256 280.191 74.262 180.5 74.262Zm288.25 10.646c-49.845 0-90.245 76.619-90.245 171.095s40.406 171.1 90.251 171.1 90.251-76.619 90.251-171.1H559c0-94.503-40.4-171.095-90.248-171.095Zm139.506 17.821c-17.526 0-31.735 68.628-31.735 153.274s14.2 153.274 31.735 153.274S640 340.631 640 256c0-84.649-14.215-153.271-31.742-153.271Z"/></svg> </a> <a href=https://hub.docker.com/u/epamedp target=_blank rel=noopener title=hub.docker.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 640 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M349.9 236.3h-66.1v-59.4h66.1v59.4zm0-204.3h-66.1v60.7h66.1V32zm78.2 144.8H362v59.4h66.1v-59.4zm-156.3-72.1h-66.1v60.1h66.1v-60.1zm78.1 0h-66.1v60.1h66.1v-60.1zm276.8 100c-14.4-9.7-47.6-13.2-73.1-8.4-3.3-24-16.7-44.9-41.1-63.7l-14-9.3-9.3 14c-18.4 27.8-23.4 73.6-3.7 103.8-8.7 4.7-25.8 11.1-48.4 10.7H2.4c-8.7 50.8 5.8 116.8 44 162.1 37.1 43.9 92.7 66.2 165.4 66.2 157.4 0 273.9-72.5 328.4-204.2 21.4.4 67.6.1 91.3-45.2 1.5-2.5 6.6-13.2 8.5-17.1l-13.3-8.9zm-511.1-27.9h-66v59.4h66.1v-59.4zm78.1 0h-66.1v59.4h66.1v-59.4zm78.1 0h-66.1v59.4h66.1v-59.4zm-78.1-72.1h-66.1v60.1h66.1v-60.1z"/></svg> </a> <a href=mailto:SupportEPMD-EDP@epam.com target=_blank rel=noopener title class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M498.1 5.6c10.1 7 15.4 19.1 13.5 31.2l-64 416c-1.5 9.7-7.4 18.2-16 23s-18.9 5.4-28 1.6L284 427.7l-68.5 74.1c-8.9 9.7-22.9 12.9-35.2 8.1S160 493.2 160 480v-83.6c0-4 1.5-7.8 4.2-10.7l167.6-182.9c5.8-6.3 5.6-16-.4-22s-15.7-6.4-22-.7L106 360.8l-88.3-44.2C7.1 311.3.3 300.7 0 288.9s5.9-22.8 16.1-28.7l448-256c10.7-6.1 23.9-5.5 34 1.4z"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings checked> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <button type=reset class="md-button md-button--primary">Reject</button> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout(function(){document.querySelector("[data-md-component=consent]").hidden=!1},250);var action,form=document.forms.consent;for(action of["submit","reset"])form.addEventListener(action,function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map(function(e){return[e,!0]}))),location.hash="",location.reload()})</script> <script id=__config type=application/json>{"base": "../..", "features": ["announce.dismiss", "content.code.copy", "navigation.sections", "navigation.tabs", "navigation.top", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.74e28a9f.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.220ee61c.min.js></script> <script src=../../js/mkdocs-charts-plugin.js></script> <script src=https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js></script> <script src=https://cdn.jsdelivr.net/gh/fancyapps/fancybox@3.5.7/dist/jquery.fancybox.min.js></script> <script src=https://cdn.jsdelivr.net/npm/vega@5></script> <script src=https://cdn.jsdelivr.net/npm/vega-lite@5></script> <script src=https://cdn.jsdelivr.net/npm/vega-embed@6></script> <script src=https://unpkg.com/mermaid@8.14.0/dist/mermaid.min.js></script> <script src=https://cdnjs.cloudflare.com/ajax/libs/bodymovin/5.6.6/lottie.min.js></script> <script src=../../overrides/animation.js></script> </body> </html>
\ No newline at end of file
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="The EPAM Delivery Platform emphasizes the importance of incorporating security practices into the software development lifecycle through the DevSecOps approach. By integrating a diverse range of open-source and enterprise security tools tailored to specific functionalities, organizations can ensure efficient and secure software development. These tools, combined with fundamental DevSecOps principles such as collaboration, continuous security, and automation, contribute to the identification and remediation of vulnerabilities early in the process, minimizes risks, and fosters a security-first culture across the organization."><link href=https://epam.github.io/edp-install/operator-guide/overview-devsecops/ rel=canonical><link href=../external-secrets-operator-integration/ rel=prev><link href=../install-velero/ rel=next><link rel=icon href=../../assets/favicon.png><meta name=generator content="mkdocs-1.4.3, mkdocs-material-9.1.19"><title>Secure Delivery - EPAM Delivery Platform</title><link rel=stylesheet href=../../assets/stylesheets/main.eebd395e.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ecc896b0.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=https://cdn.jsdelivr.net/gh/fancyapps/fancybox@3.5.7/dist/jquery.fancybox.min.css><link rel=stylesheet href=../../stylesheets/extra.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function n(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],n("js",new Date),n("config","G-7ZV6PJ2LSP"),document.addEventListener("DOMContentLoaded",function(){document.forms.search&&document.forms.search.query.addEventListener("blur",function(){this.value&&n("event","search",{search_term:this.value})}),document$.subscribe(function(){var a=document.forms.feedback;if(void 0!==a)for(var e of a.querySelectorAll("[type=submit]"))e.addEventListener("click",function(e){e.preventDefault();var t=document.location.pathname,e=this.getAttribute("data-md-value");n("event","feedback",{page:t,data:e}),a.firstElementChild.disabled=!0;e=a.querySelector(".md-feedback__note [data-md-value='"+e+"']");e&&(e.hidden=!1)}),a.hidden=!1}),location$.subscribe(function(e){n("config","G-7ZV6PJ2LSP",{page_path:e.pathname})})});var e=document.createElement("script");e.async=!0,e.src="https://www.googletagmanager.com/gtag/js?id=G-7ZV6PJ2LSP",document.getElementById("__analytics").insertAdjacentElement("afterEnd",e)}</script><script>var consent;"undefined"==typeof __md_analytics||(consent=__md_get("__consent"))&&consent.analytics&&__md_analytics()</script><meta name=msvalidate.01 content=0A0BD75C41E23DEE0C6F5DB33E1BECBC></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=cyan data-md-color-accent=blue> <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#secure-delivery-on-the-platform class=md-skip> Skip to content </a> </div> <div data-md-component=announce> <aside class=md-banner> <div class="md-banner__inner md-grid md-typeset"> <button class="md-banner__button md-icon" aria-label="Don't show this again"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg> </button> EDP Team Supports Ukraine 🇺🇦<br> In solidarity, we ask that you consider financially supporting the organizations below:<br> <a href=https://epamuafund.pinkaloo.com/causes/159bdd2f71854adf8ed5251fe26d2fe0 target=_blank>EPAM’s Global Partners for the Ukraine Humanitarian Crisis</a> </div> <script>var content,el=document.querySelector("[data-md-component=announce]");el&&(content=el.querySelector(".md-typeset"),__md_hash(content.innerHTML)===__md_get("__announce")&&(el.hidden=!0))</script> </aside> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="EPAM Delivery Platform" class="md-header__button md-logo" aria-label="EPAM Delivery Platform" data-md-component=logo> <img src=../../assets/logo.png alt=logo> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> EPAM Delivery Platform </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Secure Delivery </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media data-md-color-scheme=default data-md-color-primary=cyan data-md-color-accent=blue aria-label="Switch to dark mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_2 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg> </label> <input class=md-option data-md-color-media data-md-color-scheme=slate data-md-color-primary=indigo data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_2> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg> </label> </form> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg> </label> <nav class=md-search__options aria-label=Search> <a href=javascript:void(0) class="md-search__icon md-icon" title=Share aria-label=Share data-clipboard data-clipboard-text data-md-component=search-share tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7 0-.24-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91 1.61 0 2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08Z"/></svg> </a> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg> </button> </nav> <div class=md-search__suggest data-md-component=search-suggest></div> </form> <div class=md-search__output> <div class=md-search__scrollwrap data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/epam/edp-install title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> </div> <div class=md-source__repository> GitHub </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Home </a> </li> <li class=md-tabs__item> <a href=../../overview/ class=md-tabs__link> Getting Started </a> </li> <li class=md-tabs__item> <a href=../ class="md-tabs__link md-tabs__link--active"> Operator Guide </a> </li> <li class=md-tabs__item> <a href=../../user-guide/ class=md-tabs__link> User Guide </a> </li> <li class=md-tabs__item> <a href=../../developer-guide/ class=md-tabs__link> Developer Guide </a> </li> <li class=md-tabs__item> <a href=../../use-cases/ class=md-tabs__link> Use Cases </a> </li> <li class=md-tabs__item> <a href=../../faq/ class=md-tabs__link> FAQ </a> </li> <li class=md-tabs__item> <a href=../../roadmap/ class=md-tabs__link> RoadMap </a> </li> <li class=md-tabs__item> <a href=https://github.com/epam/edp-install/blob/master/RELEASES.md class=md-tabs__link> Releases ⧉ </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="EPAM Delivery Platform" class="md-nav__button md-logo" aria-label="EPAM Delivery Platform" data-md-component=logo> <img src=../../assets/logo.png alt=logo> </a> EPAM Delivery Platform </label> <div class=md-nav__source> <a href=https://github.com/epam/edp-install title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> </div> <div class=md-source__repository> GitHub </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> Home </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_2> <label class=md-nav__link for=__nav_2 id=__nav_2_label tabindex=0> Getting Started <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_2_label aria-expanded=false> <label class=md-nav__title for=__nav_2> <span class="md-nav__icon md-icon"></span> Getting Started </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../overview/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../../features/ class=md-nav__link> Basic Concepts </a> </li> <li class=md-nav__item> <a href=../../getting-started/ class=md-nav__link> Quick Start </a> </li> <li class=md-nav__item> <a href=../../glossary/ class=md-nav__link> Glossary </a> </li> <li class=md-nav__item> <a href=../../supported-versions/ class=md-nav__link> Supported Versions and Compatibility </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3 checked> <label class=md-nav__link for=__nav_3 id=__nav_3_label tabindex=0> Operator Guide <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=true> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> Operator Guide </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> Overview </a> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2> <label class=md-nav__link for=__nav_3_2 id=__nav_3_2_label tabindex=0> Installation <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2> <span class="md-nav__icon md-icon"></span> Installation </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2_1> <label class=md-nav__link for=__nav_3_2_1 id=__nav_3_2_1_label tabindex=0> Prerequisites <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2_1> <span class="md-nav__icon md-icon"></span> Prerequisites </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../prerequisites/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../kubernetes-cluster-settings/ class=md-nav__link> Set Up Kubernetes </a> </li> <li class=md-nav__item> <a href=../openshift-cluster-settings/ class=md-nav__link> Set Up OpenShift </a> </li> <li class=md-nav__item> <a href=../install-ingress-nginx/ class=md-nav__link> Install NGINX Ingress Controller </a> </li> <li class=md-nav__item> <a href=../install-keycloak/ class=md-nav__link> Install Keycloak </a> </li> <li class=md-nav__item> <a href=../install-defectdojo/ class=md-nav__link> Install DefectDojo </a> </li> <li class=md-nav__item> <a href=../install-reportportal/ class=md-nav__link> Install ReportPortal </a> </li> <li class=md-nav__item> <a href=../install-argocd/ class=md-nav__link> Install Argo CD </a> </li> <li class=md-nav__item> <a href=../install-tekton/ class=md-nav__link> Install Tekton </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2_1_10> <label class=md-nav__link for=__nav_3_2_1_10 id=__nav_3_2_1_10_label tabindex=0> Multi-Tenancy <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_2_1_10_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2_1_10> <span class="md-nav__icon md-icon"></span> Multi-Tenancy </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../capsule/ class=md-nav__link> Capsule </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_2_1_10_2> <label class=md-nav__link for=__nav_3_2_1_10_2 id=__nav_3_2_1_10_2_label tabindex=0> Kiosk <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_3_2_1_10_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_2_1_10_2> <span class="md-nav__icon md-icon"></span> Kiosk </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../edp-kiosk-usage/ class=md-nav__link> EDP Kiosk Usage </a> </li> <li class=md-nav__item> <a href=../install-kiosk/ class=md-nav__link> Set Up Kiosk </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../install-harbor/ class=md-nav__link> Install Harbor </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../install-edp/ class=md-nav__link> Install EDP </a> </li> <li class=md-nav__item> <a href=../install-via-helmfile/ class=md-nav__link> Install via Helmfile </a> </li> <li class=md-nav__item> <a href=../aws-marketplace-install/ class=md-nav__link> Install via AWS Marketplace </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3> <label class=md-nav__link for=__nav_3_3 id=__nav_3_3_label tabindex=0> Configuration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3> <span class="md-nav__icon md-icon"></span> Configuration </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../edp-access-model/ class=md-nav__link> EDP Access Model </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2> <label class=md-nav__link for=__nav_3_3_2 id=__nav_3_3_2_label tabindex=0> Version Control Systems <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_3_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2> <span class="md-nav__icon md-icon"></span> Version Control Systems </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../vcs/ class=md-nav__link> Overview </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_2> <label class=md-nav__link for=__nav_3_3_2_2 id=__nav_3_3_2_2_label tabindex=0> Jenkins Scenario <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_3_2_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_2> <span class="md-nav__icon md-icon"></span> Jenkins Scenario </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../import-strategy-jenkins/ class=md-nav__link> Integrate GitHub/GitLab in Jenkins </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_2_2> <label class=md-nav__link for=__nav_3_3_2_2_2 id=__nav_3_3_2_2_2_label tabindex=0> GitHub <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_3_3_2_2_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_2_2> <span class="md-nav__icon md-icon"></span> GitHub </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../github-integration/ class=md-nav__link> GitHub Webhook Configuration </a> </li> <li class=md-nav__item> <a href=../github-debug-webhooks/ class=md-nav__link> Debug GitHub Webhooks in Jenkins </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_2_3> <label class=md-nav__link for=__nav_3_3_2_2_3 id=__nav_3_3_2_2_3_label tabindex=0> GitLab <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_3_3_2_2_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_2_3> <span class="md-nav__icon md-icon"></span> GitLab </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../gitlab-integration/ class=md-nav__link> GitLab Webhook Configuration </a> </li> <li class=md-nav__item> <a href=../gitlab-debug-webhooks/ class=md-nav__link> Debug GitLab Webhooks in Jenkins </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_2_3> <label class=md-nav__link for=__nav_3_3_2_3 id=__nav_3_3_2_3_label tabindex=0> Tekton Scenario <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_3_2_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_2_3> <span class="md-nav__icon md-icon"></span> Tekton Scenario </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../import-strategy-tekton/ class=md-nav__link> Integrate GitHub/GitLab in Tekton </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_3> <label class=md-nav__link for=__nav_3_3_3 id=__nav_3_3_3_label tabindex=0> Manage Jenkins Pipelines <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_3_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_3> <span class="md-nav__icon md-icon"></span> Manage Jenkins Pipelines </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../overview-manage-jenkins-pipelines/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../manage-jenkins-ci-job-provision/ class=md-nav__link> Manage Jenkins CI Pipeline Job Provisioner </a> </li> <li class=md-nav__item> <a href=../manage-jenkins-cd-job-provision/ class=md-nav__link> Manage Jenkins CD Pipeline Job Provisioner </a> </li> <li class=md-nav__item> <a href=../delete-jenkins-job-provision/ class=md-nav__link> Delete Jenkins Job Provision </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../headlamp-oidc/ class=md-nav__link> Headlamp OIDC </a> </li> <li class=md-nav__item> <a href=../namespace-management/ class=md-nav__link> Manage Namespace </a> </li> <li class=md-nav__item> <a href=../eks-oidc-integration/ class=md-nav__link> EKS OIDC Integration </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_3_7> <label class=md-nav__link for=__nav_3_3_7 id=__nav_3_3_7_label tabindex=0> Jira <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_3_7_label aria-expanded=false> <label class=md-nav__title for=__nav_3_3_7> <span class="md-nav__icon md-icon"></span> Jira </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jira-integration/ class=md-nav__link> Adjust Jira Integration </a> </li> <li class=md-nav__item> <a href=../jira-gerrit-integration/ class=md-nav__link> Adjust VCS Integration With Jira </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4> <label class=md-nav__link for=__nav_3_4 id=__nav_3_4_label tabindex=0> Integration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_4_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4> <span class="md-nav__icon md-icon"></span> Integration </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add-ons-overview/ class=md-nav__link> Cluster Add-Ons </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_2> <label class=md-nav__link for=__nav_3_4_2 id=__nav_3_4_2_label tabindex=0> Tekton <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_2> <span class="md-nav__icon md-icon"></span> Tekton </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tekton-overview/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../tekton-monitoring/ class=md-nav__link> Monitoring </a> </li> <li class=md-nav__item> <a href=../notification-msteams/ class=md-nav__link> MS Teams Notification </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_3> <label class=md-nav__link for=__nav_3_4_3 id=__nav_3_4_3_label tabindex=0> Container Registry <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_3> <span class="md-nav__icon md-icon"></span> Container Registry </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_3_1> <label class=md-nav__link for=__nav_3_4_3_1 id=__nav_3_4_3_1_label tabindex=0> Harbor <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_4_3_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_3_1> <span class="md-nav__icon md-icon"></span> Harbor </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../container-registry-harbor-integration-tekton-ci/ class=md-nav__link> Harbor Integration </a> </li> <li class=md-nav__item> <a href=../harbor-oidc/ class=md-nav__link> OIDC in Harbor </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_4> <label class=md-nav__link for=__nav_3_4_4 id=__nav_3_4_4_label tabindex=0> AWS Integration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_4_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_4> <span class="md-nav__icon md-icon"></span> AWS Integration </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../waf-tf-configuration/ class=md-nav__link> Configure AWS WAF With Terraform </a> </li> <li class=md-nav__item> <a href=../ebs-csi-driver/ class=md-nav__link> Install Amazon EBS CSI Driver </a> </li> <li class=md-nav__item> <a href=../enable-irsa/ class=md-nav__link> Associate IAM Roles With Service Accounts </a> </li> <li class=md-nav__item> <a href=../kaniko-irsa/ class=md-nav__link> IAM Roles for Kaniko Service Accounts </a> </li> <li class=md-nav__item> <a href=../velero-irsa/ class=md-nav__link> IAM Roles for Velero Service Accounts </a> </li> <li class=md-nav__item> <a href=../loki-irsa/ class=md-nav__link> IAM Roles for Loki Service Accounts </a> </li> <li class=md-nav__item> <a href=../configure-keycloak-oidc-eks/ class=md-nav__link> EKS OIDC With Keycloak </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../perf-integration/ class=md-nav__link> Perf Server Integration </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_4_6> <label class=md-nav__link for=__nav_3_4_6 id=__nav_3_4_6_label tabindex=0> ReportPortal <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_4_6_label aria-expanded=false> <label class=md-nav__title for=__nav_3_4_6> <span class="md-nav__icon md-icon"></span> ReportPortal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reportportal-keycloak/ class=md-nav__link> Keycloak Integration </a> </li> <li class=md-nav__item> <a href=../report-portal-integration-tekton/ class=md-nav__link> Integration With Tekton </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../logsight-integration/ class=md-nav__link> Logsight Integration </a> </li> <li class=md-nav__item> <a href=../dependency-track/ class=md-nav__link> DependencyTrack </a> </li> <li class=md-nav__item> <a href=../sonarqube/ class=md-nav__link> SonarQube </a> </li> <li class=md-nav__item> <a href=../nexus-sonatype/ class=md-nav__link> Nexus Sonatype </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5 checked> <label class=md-nav__link for=__nav_3_5 id=__nav_3_5_label tabindex=0> Platform Capabilities <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_5_label aria-expanded=true> <label class=md-nav__title for=__nav_3_5> <span class="md-nav__icon md-icon"></span> Platform Capabilities </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_1> <label class=md-nav__link for=__nav_3_5_1 id=__nav_3_5_1_label tabindex=0> GitOps <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_1> <span class="md-nav__icon md-icon"></span> GitOps </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../argocd-integration/ class=md-nav__link> Argo CD Integration </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_2> <label class=md-nav__link for=__nav_3_5_2 id=__nav_3_5_2_label tabindex=0> Secrets Management <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_2> <span class="md-nav__icon md-icon"></span> Secrets Management </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../install-external-secrets-operator/ class=md-nav__link> Install External Secrets Operator </a> </li> <li class=md-nav__item> <a href=../external-secrets-operator-integration/ class=md-nav__link> External Secrets Operator Integration </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_3 checked> <label class=md-nav__link for=__nav_3_5_3 id=__nav_3_5_3_label tabindex=0> DevSecOps <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_3_label aria-expanded=true> <label class=md-nav__title for=__nav_3_5_3> <span class="md-nav__icon md-icon"></span> DevSecOps </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> Secure Delivery <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> Secure Delivery </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#supported-solutions class=md-nav__link> Supported Solutions </a> </li> <li class=md-nav__item> <a href=#integrated-tools class=md-nav__link> Integrated Tools </a> <nav class=md-nav aria-label="Integrated Tools"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#defectdojo class=md-nav__link> DefectDojo </a> </li> <li class=md-nav__item> <a href=#owasp-dependency-track class=md-nav__link> OWASP Dependency Track </a> </li> <li class=md-nav__item> <a href=#gitleaks class=md-nav__link> Gitleaks </a> </li> <li class=md-nav__item> <a href=#trivy class=md-nav__link> Trivy </a> </li> <li class=md-nav__item> <a href=#grype class=md-nav__link> Grype </a> </li> <li class=md-nav__item> <a href=#tfsec class=md-nav__link> Tfsec </a> </li> <li class=md-nav__item> <a href=#checkov class=md-nav__link> Checkov </a> </li> <li class=md-nav__item> <a href=#cdxgen class=md-nav__link> Cdxgen </a> </li> <li class=md-nav__item> <a href=#semgrep-cli class=md-nav__link> Semgrep CLI </a> </li> <li class=md-nav__item> <a href=#clair class=md-nav__link> Clair </a> </li> <li class=md-nav__item> <a href=#openvas class=md-nav__link> OpenVAS </a> </li> <li class=md-nav__item> <a href=#trufflehog class=md-nav__link> TruffleHog </a> </li> <li class=md-nav__item> <a href=#git-secrets class=md-nav__link> Git-secrets </a> </li> <li class=md-nav__item> <a href=#elk-stack class=md-nav__link> ELK Stack </a> </li> <li class=md-nav__item> <a href=#loki class=md-nav__link> Loki </a> </li> <li class=md-nav__item> <a href=#opensearch class=md-nav__link> OpenSearch </a> </li> <li class=md-nav__item> <a href=#owasp-dependency-check class=md-nav__link> OWASP Dependency-Check </a> </li> <li class=md-nav__item> <a href=#owasp-zed-attack-proxy-zap class=md-nav__link> OWASP Zed Attack Proxy (ZAP) </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_4> <label class=md-nav__link for=__nav_3_5_4 id=__nav_3_5_4_label tabindex=0> Backup With Velero <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_4_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_4> <span class="md-nav__icon md-icon"></span> Backup With Velero </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../install-velero/ class=md-nav__link> Install Velero </a> </li> <li class=md-nav__item> <a href=../restore-edp-with-velero/ class=md-nav__link> Restore EDP Tenant With Velero </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_5> <label class=md-nav__link for=__nav_3_5_5 id=__nav_3_5_5_label tabindex=0> Logging <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_5_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_5> <span class="md-nav__icon md-icon"></span> Logging </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../install-loki/ class=md-nav__link> Install Grafana Loki </a> </li> <li class=md-nav__item> <a href=../multitenant-logging/ class=md-nav__link> Multitenant Logging </a> </li> <li class=md-nav__item> <a href=../schedule-pods-restart/ class=md-nav__link> Schedule Pods Restart </a> </li> <li class=md-nav__item> <a href=../kibana-ilm-rollover/ class=md-nav__link> Aggregate Application Logs Using EFK Stack </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../manage-custom-certificate/ class=md-nav__link> Manage Custom Certificates </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_5_7> <label class=md-nav__link for=__nav_3_5_7 id=__nav_3_5_7_label tabindex=0> Single Sign-on <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_5_7_label aria-expanded=false> <label class=md-nav__title for=__nav_3_5_7> <span class="md-nav__icon md-icon"></span> Single Sign-on </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../oauth2-proxy/ class=md-nav__link> Protect Endpoints </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6> <label class=md-nav__link for=__nav_3_6 id=__nav_3_6_label tabindex=0> Upgrade <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_6_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6> <span class="md-nav__icon md-icon"></span> Upgrade </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6_1> <label class=md-nav__link for=__nav_3_6_1 id=__nav_3_6_1_label tabindex=0> EDP <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_6_1_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6_1> <span class="md-nav__icon md-icon"></span> EDP </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../upgrade-edp-3.5/ class=md-nav__link> v3.4 to 3.5 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.4/ class=md-nav__link> v3.3 to 3.4 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.3/ class=md-nav__link> v3.2 to 3.3 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.2/ class=md-nav__link> v3.1 to 3.2 </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6_1_5> <label class=md-nav__link for=__nav_3_6_1_5 id=__nav_3_6_1_5_label tabindex=0> Older Versions <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_3_6_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6_1_5> <span class="md-nav__icon md-icon"></span> Older Versions </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../upgrade-edp-3.1/ class=md-nav__link> v3.0 to 3.1 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-3.0/ class=md-nav__link> v2.12 to 3.0 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.12/ class=md-nav__link> v2.11 to 2.12 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.11/ class=md-nav__link> v2.10 to 2.11 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.10/ class=md-nav__link> v2.9 to 2.10 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.9/ class=md-nav__link> v2.8 to 2.9 </a> </li> <li class=md-nav__item> <a href=../upgrade-edp-2.8/ class=md-nav__link> v2.7 to 2.8 </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_6_2> <label class=md-nav__link for=__nav_3_6_2 id=__nav_3_6_2_label tabindex=0> Keycloak <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_3_6_2_label aria-expanded=false> <label class=md-nav__title for=__nav_3_6_2> <span class="md-nav__icon md-icon"></span> Keycloak </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../upgrade-keycloak-19.0/ class=md-nav__link> v17.0 to 19.0 </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3_7> <label class=md-nav__link for=__nav_3_7 id=__nav_3_7_label tabindex=0> Tutorials <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_3_7_label aria-expanded=false> <label class=md-nav__title for=__nav_3_7> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/terraform-stages/ class=md-nav__link> CI Pipelines for Terraform </a> </li> <li class=md-nav__item> <a href=../deploy-aws-eks/ class=md-nav__link> Deploy AWS EKS Cluster </a> </li> <li class=md-nav__item> <a href=../deploy-okd/ class=md-nav__link> Deploy OKD 4.9 Cluster </a> </li> <li class=md-nav__item> <a href=../deploy-okd-4.10/ class=md-nav__link> Deploy OKD 4.10 Cluster </a> </li> <li class=md-nav__item> <a href=../ssl-automation-okd/ class=md-nav__link> Use Cert-Manager in OpenShift </a> </li> <li class=md-nav__item> <a href=../add-jenkins-agent/ class=md-nav__link> Manage Jenkins Agent </a> </li> <li class=md-nav__item> <a href=../kibana-ilm-rollover/ class=md-nav__link> Aggregate Application Logs Using EFK Stack </a> </li> <li class=md-nav__item> <a href=../migrate-ci-pipelines-from-jenkins-to-tekton/ class=md-nav__link> Migrate CI Pipelines From Jenkins to Tekton </a> </li> <li class=md-nav__item> <a href=../delete-edp/ class=md-nav__link> Uninstall EDP </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex=0> User Guide <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> User Guide </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/ class=md-nav__link> Overview </a> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_2> <label class=md-nav__link for=__nav_4_2 id=__nav_4_2_label tabindex=0> Marketplace <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_2_label aria-expanded=false> <label class=md-nav__title for=__nav_4_2> <span class="md-nav__icon md-icon"></span> Marketplace </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/marketplace/ class=md-nav__link> Marketplace Overview </a> </li> <li class=md-nav__item> <a href=../../user-guide/add-marketplace/ class=md-nav__link> Add Component via Marketplace </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3> <label class=md-nav__link for=__nav_4_3 id=__nav_4_3_label tabindex=0> Components <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_3_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3> <span class="md-nav__icon md-icon"></span> Components </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_1> <label class=md-nav__link for=__nav_4_3_1 id=__nav_4_3_1_label tabindex=0> Application <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_1_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_1> <span class="md-nav__icon md-icon"></span> Application </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-application/ class=md-nav__link> Add Application </a> </li> <li class=md-nav__item> <a href=../../user-guide/application/ class=md-nav__link> Manage Applications </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_2> <label class=md-nav__link for=__nav_4_3_2 id=__nav_4_3_2_label tabindex=0> Autotest <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_2_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_2> <span class="md-nav__icon md-icon"></span> Autotest </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-autotest/ class=md-nav__link> Add Autotest </a> </li> <li class=md-nav__item> <a href=../../user-guide/autotest/ class=md-nav__link> Manage Autotests </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_3> <label class=md-nav__link for=__nav_4_3_3 id=__nav_4_3_3_label tabindex=0> Library <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_3_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_3> <span class="md-nav__icon md-icon"></span> Library </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-library/ class=md-nav__link> Add Library </a> </li> <li class=md-nav__item> <a href=../../user-guide/library/ class=md-nav__link> Manage Libraries </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_3_4> <label class=md-nav__link for=__nav_4_3_4 id=__nav_4_3_4_label tabindex=0> Infrastructure <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_3_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4_3_4> <span class="md-nav__icon md-icon"></span> Infrastructure </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-infrastructure/ class=md-nav__link> Add Infrastructure </a> </li> <li class=md-nav__item> <a href=../../user-guide/infrastructure/ class=md-nav__link> Manage Infrastructures </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../../user-guide/manage-branches/ class=md-nav__link> Manage Branches </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_4> <label class=md-nav__link for=__nav_4_4 id=__nav_4_4_label tabindex=0> Environments <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_4_label aria-expanded=false> <label class=md-nav__title for=__nav_4_4> <span class="md-nav__icon md-icon"></span> Environments </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-cd-pipeline/ class=md-nav__link> Add CD Pipeline </a> </li> <li class=md-nav__item> <a href=../../user-guide/add-quality-gate/ class=md-nav__link> Add Quality Gate </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5> <label class=md-nav__link for=__nav_4_5 id=__nav_4_5_label tabindex=0> Configuration <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_4_5_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5> <span class="md-nav__icon md-icon"></span> Configuration </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5_1> <label class=md-nav__link for=__nav_4_5_1 id=__nav_4_5_1_label tabindex=0> Git Server <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_5_1_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5_1> <span class="md-nav__icon md-icon"></span> Git Server </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/git-server-overview/ class=md-nav__link> Manage Git Servers </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5_2> <label class=md-nav__link for=__nav_4_5_2 id=__nav_4_5_2_label tabindex=0> Cluster <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_5_2_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5_2> <span class="md-nav__icon md-icon"></span> Cluster </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/add-cluster/ class=md-nav__link> Add Cluster </a> </li> <li class=md-nav__item> <a href=../../user-guide/cluster/ class=md-nav__link> Manage Clusters </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4_5_3> <label class=md-nav__link for=__nav_4_5_3 id=__nav_4_5_3_label tabindex=0> GitOps <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_4_5_3_label aria-expanded=false> <label class=md-nav__title for=__nav_4_5_3> <span class="md-nav__icon md-icon"></span> GitOps </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../user-guide/gitops/ class=md-nav__link> Manage GitOps </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> Developer Guide <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Developer Guide </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../developer-guide/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../../developer-guide/local-development/ class=md-nav__link> Workspace Setup Manual </a> </li> <li class=md-nav__item> <a href=../../developer-guide/mk-docs-development/ class=md-nav__link> Documentation Flow </a> </li> <li class=md-nav__item> <a href=../../developer-guide/edp-workflow/ class=md-nav__link> EDP Project Rules. Working Process </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> Use Cases <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Use Cases </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../use-cases/ class=md-nav__link> Overview </a> </li> <li class=md-nav__item> <a href=../../use-cases/application-scaffolding/ class=md-nav__link> Scaffold and Deploy FastAPI Application </a> </li> <li class=md-nav__item> <a href=../../use-cases/tekton-custom-pipelines/ class=md-nav__link> Deploy Application With Custom Build Tool/Framework </a> </li> <li class=md-nav__item> <a href=../../use-cases/external-secrets/ class=md-nav__link> Secured Secrets Management for Application Deployment </a> </li> <li class=md-nav__item> <a href=../../use-cases/autotest-as-quality-gate/ class=md-nav__link> Autotest as a Quality Gate </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../../faq/ class=md-nav__link> FAQ </a> </li> <li class=md-nav__item> <a href=../../roadmap/ class=md-nav__link> RoadMap </a> </li> <li class=md-nav__item> <a href=https://github.com/epam/edp-install/blob/master/RELEASES.md class=md-nav__link> Releases ⧉ </a> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#supported-solutions class=md-nav__link> Supported Solutions </a> </li> <li class=md-nav__item> <a href=#integrated-tools class=md-nav__link> Integrated Tools </a> <nav class=md-nav aria-label="Integrated Tools"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#defectdojo class=md-nav__link> DefectDojo </a> </li> <li class=md-nav__item> <a href=#owasp-dependency-track class=md-nav__link> OWASP Dependency Track </a> </li> <li class=md-nav__item> <a href=#gitleaks class=md-nav__link> Gitleaks </a> </li> <li class=md-nav__item> <a href=#trivy class=md-nav__link> Trivy </a> </li> <li class=md-nav__item> <a href=#grype class=md-nav__link> Grype </a> </li> <li class=md-nav__item> <a href=#tfsec class=md-nav__link> Tfsec </a> </li> <li class=md-nav__item> <a href=#checkov class=md-nav__link> Checkov </a> </li> <li class=md-nav__item> <a href=#cdxgen class=md-nav__link> Cdxgen </a> </li> <li class=md-nav__item> <a href=#semgrep-cli class=md-nav__link> Semgrep CLI </a> </li> <li class=md-nav__item> <a href=#clair class=md-nav__link> Clair </a> </li> <li class=md-nav__item> <a href=#openvas class=md-nav__link> OpenVAS </a> </li> <li class=md-nav__item> <a href=#trufflehog class=md-nav__link> TruffleHog </a> </li> <li class=md-nav__item> <a href=#git-secrets class=md-nav__link> Git-secrets </a> </li> <li class=md-nav__item> <a href=#elk-stack class=md-nav__link> ELK Stack </a> </li> <li class=md-nav__item> <a href=#loki class=md-nav__link> Loki </a> </li> <li class=md-nav__item> <a href=#opensearch class=md-nav__link> OpenSearch </a> </li> <li class=md-nav__item> <a href=#owasp-dependency-check class=md-nav__link> OWASP Dependency-Check </a> </li> <li class=md-nav__item> <a href=#owasp-zed-attack-proxy-zap class=md-nav__link> OWASP Zed Attack Proxy (ZAP) </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=secure-delivery-on-the-platform>Secure Delivery on the Platform<a class=headerlink href=#secure-delivery-on-the-platform title="Permanent link">⚓︎</a></h1> <p>The EPAM Delivery Platform emphasizes the importance of incorporating security practices into the software development lifecycle through the DevSecOps approach. By integrating a diverse range of open-source and enterprise security tools tailored to specific functionalities, organizations can ensure efficient and secure software development. These tools, combined with fundamental DevSecOps principles such as collaboration, continuous security, and automation, contribute to the identification and remediation of vulnerabilities early in the process, minimizes risks, and fosters a security-first culture across the organization.</p> <p>The EPAM Delivery Platform enabling seamless integration with various security tools and vulnerability management systems, enhancing the security of source code and ensuring compliance.</p> <h2 id=supported-solutions>Supported Solutions<a class=headerlink href=#supported-solutions title="Permanent link">⚓︎</a></h2> <p>The below table categorizes various open-source and enterprise security tools based on their specific functionalities. It provides a comprehensive view of the available options for each security aspect. This classification facilitates informed decision-making when selecting and integrating security tools into a development pipeline, ensuring an efficient and robust security stance. EDP supports the integration of both open-source and enterprise security tools, providing a flexible and versatile solution for security automation. See table below for more details.</p> <table> <thead> <tr> <th align=center>Functionality</th> <th>Open-Source Tools (integrated in Pipelines)</th> <th>Enterprise Tools (available for Integration)</th> </tr> </thead> <tbody> <tr> <td align=center>Hardcoded Credentials Scanner</td> <td>TruffleHog, GitLeaks, Git-secrets</td> <td>GitGuardian, SpectralOps, Bridgecrew</td> </tr> <tr> <td align=center>Static Application Security Testing</td> <td>SonarQube, Semgrep CLI</td> <td>Veracode, Checkmarx, Coverity</td> </tr> <tr> <td align=center>Software Composition Analysis</td> <td>OWASP Dependency-Check, cdxgen</td> <td>Black Duck Hub, Mend, Snyk</td> </tr> <tr> <td align=center>Container Security</td> <td>Trivy, Grype, Clair</td> <td>Aqua Security, Sysdig Secure, Snyk</td> </tr> <tr> <td align=center>Infrastructure as Code Security</td> <td>Checkov, Tfsec</td> <td>Bridgecrew, Prisma Cloud, Snyk</td> </tr> <tr> <td align=center>Dynamic Application Security Testing</td> <td>OWASP Zed Attack Proxy</td> <td>Fortify WebInspect, Rapid7 InsightAppSec, Checkmarx</td> </tr> <tr> <td align=center>Continuous Monitoring and Logging</td> <td>ELK Stack, OpenSearch, Loki</td> <td>Splunk, Datadog</td> </tr> <tr> <td align=center>Security Audits and Assessments</td> <td>OpenVAS</td> <td>Tenable Nessus, QualysGuard, BurpSuite Professional</td> </tr> <tr> <td align=center>Vulnerability Management and Reporting</td> <td>DefectDojo, OWASP Dependency-Track</td> <td>Metasploit</td> </tr> </tbody> </table> <p>For better visualization, see the scheme below:</p> <p> <figure><a data-caption="Security tools in EDP" data-fancybox=gallery href=../../assets/operator-guide/security-tools.png><img alt="Security tools in EDP" src=../../assets/operator-guide/security-tools.png title="Security tools in EDP" width=600px></a><figcaption>Security tools in EDP</figcaption> </figure> </p> <h2 id=integrated-tools>Integrated Tools<a class=headerlink href=#integrated-tools title="Permanent link">⚓︎</a></h2> <p>For obtaining and managing report post scanning, deployment of various vulnerability management systems and security tools is required. These include:</p> <h3 id=defectdojo>DefectDojo<a class=headerlink href=#defectdojo title="Permanent link">⚓︎</a></h3> <p><a href=https://www.defectdojo.com/ >DefectDojo</a> is a comprehensive vulnerability management and security orchestration platform facilitating the handling of uploaded security reports. Examine the prerequisites and fundamental instructions for <a href=../install-defectdojo/ >installing DefectDojo</a> on Kubernetes or OpenShift platforms.</p> <h3 id=owasp-dependency-track>OWASP Dependency Track<a class=headerlink href=#owasp-dependency-track title="Permanent link">⚓︎</a></h3> <p><a href=https://dependencytrack.org/ >Dependency Track</a> is an intelligent Software Composition Analysis (SCA) platform that provides a comprehensive solution for managing vulnerabilities in third-party and open-source components.</p> <h3 id=gitleaks>Gitleaks<a class=headerlink href=#gitleaks title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/zricethezav/gitleaks>Gitleaks</a> is a versatile SAST tool used to scan Git repositories for hardcoded secrets, such as passwords and API keys, to prevent potential data leaks and unauthorized access.</p> <h3 id=trivy>Trivy<a class=headerlink href=#trivy title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/aquasecurity/trivy>Trivy</a> is a simple and comprehensive vulnerability scanner for containers and other artifacts, providing insight into potential security issues across multiple ecosystems.</p> <h3 id=grype>Grype<a class=headerlink href=#grype title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/anchore/grype>Grype</a> is a fast and reliable vulnerability scanner for container images and filesystems, maintaining an up-to-date vulnerability database for efficient and accurate scanning.</p> <h3 id=tfsec>Tfsec<a class=headerlink href=#tfsec title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/aquasecurity/tfsec>Tfsec</a> is an effective Infrastructure as Code (IaC) security scanner, tailored specifically for reviewing Terraform templates. It helps identify potential security issues related to misconfigurations and non-compliant practices, enabling developers to address vulnerabilities and ensure secure infrastructure deployment.</p> <h3 id=checkov>Checkov<a class=headerlink href=#checkov title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/bridgecrewio/checkov>Checkov</a> is a robust static code analysis tool designed for IaC security, supporting various IaC frameworks such as Terraform, CloudFormation, and Kubernetes. It assists in detecting and mitigating security and compliance misconfigurations, promoting best practices and adherence to industry standards across the infrastructure.</p> <h3 id=cdxgen>Cdxgen<a class=headerlink href=#cdxgen title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/AppThreat/cdxgen>Cdxgen</a> is a lightweight and efficient tool for generating Software Bill of Materials (SBOM) using CycloneDX, a standard format for managing component inventory. It helps organizations maintain an up-to-date record of all software components, their versions, and related vulnerabilities, streamlining monitoring and compliance within the software supply chain.</p> <h3 id=semgrep-cli>Semgrep CLI<a class=headerlink href=#semgrep-cli title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/returntocorp/semgrep>Semgrep CLI</a> is a versatile and user-friendly command-line interface for the Semgrep security scanner, enabling developers to perform Static Application Security Testing (SAST) for various programming languages. It focuses on detecting and preventing potential security vulnerabilities, code quality issues, and custom anti-patterns, ensuring secure and efficient code development.</p> <h3 id=clair>Clair<a class=headerlink href=#clair title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/quay/clair>Clair</a> is an open-source container security tool that is designed to help you assess the security of container images and identify vulnerabilities within them. It is particularly useful for organizations using container orchestration platforms such as Kubernetes.</p> <h3 id=openvas>OpenVAS<a class=headerlink href=#openvas title="Permanent link">⚓︎</a></h3> <p><a href=https://openvas.org/ >OpenVAS</a> is an open-source network vulnerability scanner and security management tool. It is designed to identify and assess security vulnerabilities in computer systems, networks, and applications. OpenVAS provides a comprehensive set of features for vulnerability scanning, assessment, and management.</p> <h3 id=trufflehog>TruffleHog<a class=headerlink href=#trufflehog title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/trufflesecurity/trufflehog>TruffleHog</a> is an open-source Python tool designed for finding and identifying potentially sensitive and secret information in the source code and commit history of Git repositories. It's particularly useful for locating unintentional disclosures of confidential data, such as API keys, passwords, and other credentials, that might have been inadvertently committed to a code repository.</p> <h3 id=git-secrets>Git-secrets<a class=headerlink href=#git-secrets title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/awslabs/git-secrets>Git-secrets</a> is an open-source tool that helps prevent the accidental committing of secrets, sensitive information, and other types of confidential data into Git repositories. It is designed to enforce security best practices and reduce the risk of unintentional data exposure by scanning Git repositories for predefined secret patterns.</p> <h3 id=elk-stack>ELK Stack<a class=headerlink href=#elk-stack title="Permanent link">⚓︎</a></h3> <p><a href=../kibana-ilm-rollover/ >ELK Stack</a> (Fluent Bit, Elasticsearch, Kibana) stack is used in Kubernetes instead of ELK because this stack provides us with the support for Logsight for Stage Verification and Incident Detection. In addition to it, Fluent Bit has a smaller memory fingerprint than Logstash. Fluent Bit has the Inputs, Parsers, Filters and Outputs plugins similarly to Logstash.</p> <h3 id=loki>Loki<a class=headerlink href=#loki title="Permanent link">⚓︎</a></h3> <p><a href=https://github.com/Neo23x0/Loki>Loki</a> is a log aggregation system and log processing system designed for cloud-native environments. It is part of the CNCF (Cloud Native Computing Foundation) and is often used alongside other CNCF projects like Prometheus for monitoring and observability.</p> <h3 id=opensearch>OpenSearch<a class=headerlink href=#opensearch title="Permanent link">⚓︎</a></h3> <p><a href=https://opensearch.org/ >OpenSearch</a> is the flexible, scalable, open-source way to build solutions for data-intensive applications. Explore, enrich, and visualize your data with built-in performance, developer-friendly tools, and powerful integrations for machine learning, data processing, and more.</p> <h3 id=owasp-dependency-check>OWASP Dependency-Check<a class=headerlink href=#owasp-dependency-check title="Permanent link">⚓︎</a></h3> <p><a href=https://owasp.org/www-project-dependency-check/ >OWASP Dependency-Check</a> is a software composition analysis tool that helps identify and report known security vulnerabilities in project dependencies. It is particularly valuable for developers and organizations looking to secure their applications by identifying and addressing vulnerabilities in the libraries and components they use.</p> <h3 id=owasp-zed-attack-proxy-zap>OWASP Zed Attack Proxy (ZAP)<a class=headerlink href=#owasp-zed-attack-proxy-zap title="Permanent link">⚓︎</a></h3> <p><a href=https://www.zaproxy.org/ >OWASP Zed Attack Proxy (ZAP)</a> is an security testing tool for finding vulnerabilities in web applications during the development and testing phases. ZAP is designed to help developers and security professionals identify and address security issues and potential vulnerabilities in web applications. It provides automated and manual testing capabilities, as well as a wide range of features for security testing.</p> <form class=md-feedback name=feedback hidden> <fieldset> <legend class=md-feedback__title> Was this page helpful? </legend> <div class=md-feedback__inner> <div class=md-feedback__list> <button class="md-feedback__icon md-icon" type=submit title="This page was helpful" data-md-value=1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m7 0c0 .8-.7 1.5-1.5 1.5S14 10.3 14 9.5 14.7 8 15.5 8s1.5.7 1.5 1.5m-5 7.73c-1.75 0-3.29-.73-4.19-1.81L9.23 14c.45.72 1.52 1.23 2.77 1.23s2.32-.51 2.77-1.23l1.42 1.42c-.9 1.08-2.44 1.81-4.19 1.81Z"/></svg> </button> <button class="md-feedback__icon md-icon" type=submit title="This page could be improved" data-md-value=0> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10m-6.5-4c.8 0 1.5.7 1.5 1.5s-.7 1.5-1.5 1.5-1.5-.7-1.5-1.5.7-1.5 1.5-1.5M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m2 4.5c1.75 0 3.29.72 4.19 1.81l-1.42 1.42C14.32 16.5 13.25 16 12 16s-2.32.5-2.77 1.23l-1.42-1.42C8.71 14.72 10.25 14 12 14Z"/></svg> </button> </div> <div class=md-feedback__note> <div data-md-value=1 hidden> Thanks for your feedback! </div> <div data-md-value=0 hidden> Thanks for your feedback! Help us improve this page by using our <a href=... target=_blank rel=noopener>feedback form</a>. </div> </div> </div> </fieldset> </form> </article> </div> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12Z"/></svg> Back to top </button> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <!-- Copyright and theme information --> <div class=md-footer-copyright> <div class=md-footer-copyright__highlight> Copyright &copy; 2018 - 2023 EPAM Delivery Platform - <a href=#__consent>Change cookie settings</a> </div> powered by <a href=https://www.mkdocs.org title=MkDocs>MkDocs</a> and <a href=https://squidfunk.github.io/mkdocs-material/ title="Material for MkDocs"> Material for MkDocs</a> </div> <div class=md-social> <a href=https://www.youtube.com/@theplatformteam target=_blank rel=noopener title=www.youtube.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 576 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"/></svg> </a> <a href=https://medium.com/epam-delivery-platform target=_blank rel=noopener title=medium.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 640 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M180.5 74.262C80.813 74.262 0 155.633 0 256s80.819 181.738 180.5 181.738S361 356.373 361 256 280.191 74.262 180.5 74.262Zm288.25 10.646c-49.845 0-90.245 76.619-90.245 171.095s40.406 171.1 90.251 171.1 90.251-76.619 90.251-171.1H559c0-94.503-40.4-171.095-90.248-171.095Zm139.506 17.821c-17.526 0-31.735 68.628-31.735 153.274s14.2 153.274 31.735 153.274S640 340.631 640 256c0-84.649-14.215-153.271-31.742-153.271Z"/></svg> </a> <a href=https://hub.docker.com/u/epamedp target=_blank rel=noopener title=hub.docker.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 640 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M349.9 236.3h-66.1v-59.4h66.1v59.4zm0-204.3h-66.1v60.7h66.1V32zm78.2 144.8H362v59.4h66.1v-59.4zm-156.3-72.1h-66.1v60.1h66.1v-60.1zm78.1 0h-66.1v60.1h66.1v-60.1zm276.8 100c-14.4-9.7-47.6-13.2-73.1-8.4-3.3-24-16.7-44.9-41.1-63.7l-14-9.3-9.3 14c-18.4 27.8-23.4 73.6-3.7 103.8-8.7 4.7-25.8 11.1-48.4 10.7H2.4c-8.7 50.8 5.8 116.8 44 162.1 37.1 43.9 92.7 66.2 165.4 66.2 157.4 0 273.9-72.5 328.4-204.2 21.4.4 67.6.1 91.3-45.2 1.5-2.5 6.6-13.2 8.5-17.1l-13.3-8.9zm-511.1-27.9h-66v59.4h66.1v-59.4zm78.1 0h-66.1v59.4h66.1v-59.4zm78.1 0h-66.1v59.4h66.1v-59.4zm-78.1-72.1h-66.1v60.1h66.1v-60.1z"/></svg> </a> <a href=mailto:SupportEPMD-EDP@epam.com target=_blank rel=noopener title class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 512 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M498.1 5.6c10.1 7 15.4 19.1 13.5 31.2l-64 416c-1.5 9.7-7.4 18.2-16 23s-18.9 5.4-28 1.6L284 427.7l-68.5 74.1c-8.9 9.7-22.9 12.9-35.2 8.1S160 493.2 160 480v-83.6c0-4 1.5-7.8 4.2-10.7l167.6-182.9c5.8-6.3 5.6-16-.4-22s-15.7-6.4-22-.7L106 360.8l-88.3-44.2C7.1 311.3.3 300.7 0 288.9s5.9-22.8 16.1-28.7l448-256c10.7-6.1 23.9-5.5 34 1.4z"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings checked> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <button type=reset class="md-button md-button--primary">Reject</button> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout(function(){document.querySelector("[data-md-component=consent]").hidden=!1},250);var action,form=document.forms.consent;for(action of["submit","reset"])form.addEventListener(action,function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map(function(e){return[e,!0]}))),location.hash="",location.reload()})</script> <script id=__config type=application/json>{"base": "../..", "features": ["announce.dismiss", "content.code.copy", "navigation.sections", "navigation.tabs", "navigation.top", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.74e28a9f.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.220ee61c.min.js></script> <script src=../../js/mkdocs-charts-plugin.js></script> <script src=https://cdn.jsdelivr.net/npm/jquery@3.5.1/dist/jquery.min.js></script> <script src=https://cdn.jsdelivr.net/gh/fancyapps/fancybox@3.5.7/dist/jquery.fancybox.min.js></script> <script src=https://cdn.jsdelivr.net/npm/vega@5></script> <script src=https://cdn.jsdelivr.net/npm/vega-lite@5></script> <script src=https://cdn.jsdelivr.net/npm/vega-embed@6></script> <script src=https://unpkg.com/mermaid@8.14.0/dist/mermaid.min.js></script> <script src=https://cdnjs.cloudflare.com/ajax/libs/bodymovin/5.6.6/lottie.min.js></script> <script src=../../overrides/animation.js></script> </body> </html>
\ No newline at end of file
diff --git a/robots.txt b/robots.txt
new file mode 100644
index 000000000..5ee803f04
--- /dev/null
+++ b/robots.txt
@@ -0,0 +1 @@
+User-agent: *\nAllow: /\nSitemap: https://epam.github.io/edp-install/sitemap.xml
diff --git a/search/search_index.json b/search/search_index.json
index 778140ca5..8e951ccb6 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"faq/","title":"FAQ","text":""},{"location":"faq/#how-do-i-set-parallel-reconciliation-for-a-number-of-codebase-branches","title":"How Do I Set Parallel Reconciliation for a Number of Codebase Branches?","text":"<p>Set the CODEBASE_BRANCH_MAX_CONCURRENT_RECONCILES Env variable in codebase-operator by updating Deployment template. For example:</p> <pre><code>          ...\n          env:\n            - name: WATCH_NAMESPACE\n          ...\n\n            - name: CODEBASE_BRANCH_MAX_CONCURRENT_RECONCILES\n              value: 10\n...\n</code></pre> <p>It's not recommended to set the value above 10.</p>"},{"location":"faq/#how-to-change-the-lifespan-of-an-access-token-that-is-used-for-edp-portal-and-oidc-login-plugin","title":"How To Change the Lifespan of an Access Token That Is Used for EDP Portal and 'oidc-login' Plugin?","text":"<p>Change the Access Token Lifespan: go to your Keycloak and select Openshift realm &gt; Realm settings &gt; Tokens &gt; Access Token Lifespan &gt; set a new value to the field and save this change.</p> <p>By default, \"Access Token Lifespan\" value is 5 minutes.</p> <p> Access Token Lifespan </p>"},{"location":"features/","title":"Basic Concepts","text":"<p>Consult EDP Glossary section for definitions mentioned on this page and EDP Toolset to have a full list of tools used with the Platform. The below table contains a full list of features provided by EDP.</p> Features Description Cloud Agnostic EDP runs on Kubernetes cluster, so any Public Cloud Provider which provides Kubernetes can be used. Kubernetes clusters deployed on-premises work as well CI/CD for Microservices EDP is initially designed to support CI/CD for Microservices running as containerized applications inside Kubernetes Cluster. EDP also supports CI for:- Terraform Modules, - Open Policy Rules,- Workflows for Java (8,11,17), JavaScript (React, Vue, Angular, Express, Antora), C# (.NET 6.0), Python (FastAPI, Flask, 3.8), Go (Beego, Operator SDK) Version Control System (VCS) EDP installs Gerrit as a default Source Code Management (SCM) tool. EDP also supports GitHub and GitLab integration Branching Strategy EDP supports Trunk-based development as well as GitHub/GitLab flow. EDP creates two Pipelines per each codebase branch (see Pipeline Framework): Code Review and Build Repository Structure EDP provides separate Git repository per each Codebase and doesn't work with Monorepo. However, EDP does support customization and runs helm-lint, dockerfile-lint steps using Monorepo approach. Artifacts Versioning EDP supports two approaches for Artifacts versioning: - default (BRANCH-[TECH_STACK_VERSION]-BUILD_ID)- EDP (MAJOR.MINOR.PATCH-BUILD_ID), which is SemVer.Custom versioning can be created by implementing get-version stage Application Library EDP provides baseline codebase templates for Microservices, Libraries, within create strategy while onboarding new Codebase Stages Library Each EDP Pipeline consists of pre-defined steps (stages). Consult library documentation for more details CI Pipelines EDP provides CI Pipelines for first-class citizens: - Applications (Microservices) based on Java (8,11,17), JavaScript (React, Vue, Angular, Express, Antora), C# (.NET 6.0), Python (FastAPI, Flask, 3.8), Go (Beego, Operator SDK)- Libraries based on Java (8,11,17), JavaScript (React, Vue, Angular, Express), Python (FastAPI, Flask, 3.8), Groovy Pipeline (Codenarc), Terraform, Rego (OPA), Container (Docker), Helm (Pipeline), C#(.NET 6.0)- Autotests based on Java8, Java11, Java17 CD Pipelines EDP provides capabilities to design CD Pipelines (in Admin Console) for Microservices and defines logic for artifacts flow (promotion) from env to env. Artifacts promotion is performed automatically (Autotests), manually (User Approval) or combining both approaches Autotests EDP provides CI pipeline for autotest implemented in Java. Autotests can be used as Quality Gates in CD Pipelines Custom Pipeline Library EDP can be extended by introducing Custom Pipeline Library Dynamic Environments Each EDP CD Pipeline creates/destroys environment upon user requests"},{"location":"getting-started/","title":"Quick Start","text":""},{"location":"getting-started/#software-requirements","title":"Software Requirements","text":"<ul> <li>Kubernetes cluster 1.23+ or OpenShift 4.9+;</li> <li>Kubectl tool;</li> <li>Helm 3.10.x+;</li> <li>Keycloak 18.0+;</li> <li>(Optional) Kiosk 0.2.11.</li> </ul>"},{"location":"getting-started/#minimal-hardware-requirements","title":"Minimal Hardware Requirements","text":"<p>The system should have the following specifications to run properly:</p> <ul> <li>CPU: 8 Core</li> <li>Memory: 32 Gb</li> </ul>"},{"location":"getting-started/#edp-toolset","title":"EDP Toolset","text":"<p>EPAM Delivery Platform supports the following tools:</p> Domain Related Tools/Solutions Artifacts Management Nexus Repository, Jfrog Artifactory AWS IRSA, AWS ECR, AWS EFS, Parameter Store, S3, ALB/NLB, Route53 Build .NET, Go, Apache Gradle, Apache Maven, NPM Cluster Backup Velero Code Review Gerrit, GitLab, GitHub Container Registry AWS ECR, OpenShift Registry, Harbor, DockerHub Containers Hadolint, Kaniko, Crane Documentation as Code MkDocs, Antora (AsciiDoc) Infrastructure as Code Terraform, TFLint, Terraform Docs, Crossplane, AWS Controllers for Kubernetes Kubernetes Deployment Kubectl, Helm, Helm Docs, Chart Testing, Argo CD, Argo Rollout Kubernetes Multitenancy Kiosk, Capsule Logging OpenSearch, EFK, ELK, Loki, Splunk Monitoring Prometheus, Grafana, VictoriaMetrics Pipeline Orchestration Tekton Policies/Rules Open Policy Agent Secrets Management External Secret Operator, Vault, AWS Parameter Store Secure Development SonarQube, DefectDojo, Dependency Track,  Semgrep, Grype, Trivy, Clair, GitLeaks, CycloneDX Generator, tfsec, checkov SSO Keycloak, oauth2-proxy Test Report Tool ReportPortal, Allure Tracing OpenTelemetry, Jaeger"},{"location":"getting-started/#install-edp","title":"Install EDP","text":"<p>To install EDP with the necessary parameters, please refer to the Install EDP section of the Operator Guide. Mind the parameters in the EDP installation chart. For details, please refer to the values.yaml.</p> <p>Find below the example of the installation command:</p> <pre><code>    helm install edp epamedp/edp-install --wait --timeout=900s \\\n    --set global.dnsWildCard=&lt;cluster_DNS_wildcard&gt; \\\n    --set global.platform=&lt;platform_type&gt; \\\n    --set awsRegion=&lt;region&gt; \\\n    --namespace edp\n</code></pre> <p>Warning</p> <p>Please be aware that the command above is an example.</p>"},{"location":"getting-started/#related-articles","title":"Related Articles","text":"<p>Getting Started</p>"},{"location":"glossary/","title":"Glossary","text":"<p>Get familiar with the definitions and context for the most useful EDP terms presented in table below.</p> Terms Details EDP Component - an item used in CI/CD process EDP Portal UI - an EDP component that helps to manage, set up, and control the business entities. Artifactory - an EDP component that stores all the binary artifacts. NOTE: Nexus is used as a possible implementation of a repository. CI/CD Server - an EDP component that launches pipelines that perform the build, QA, and deployment code logic. NOTE: Jenkins is used as a possible implementation of a CI/CD server. Code Review tool - an EDP component that collaborates with the changes in the codebase. NOTE: Gerrit is used as a possible implementation of a code review tool. Identity Server - an authentication server providing a common way to verify requests to all of the applications. NOTE: Keycloak is used as a possible implementation of an identity server. Security Realm Tenant - a realm in identity server (e.g Keycloak) where all users' accounts and their access permissions are managed. The realm is unique for the identity server instance. Static Code Analyzer - an EDP component that inspects continuously a code quality before the necessary changes appear in a master branch. NOTE: SonarQube is used as a possible implementation of a static code analyzer. VCS (Version Control System) - a replication of the Gerrit repository that displays all the changes made by developers. NOTE: GitHub and GitLab are used as the possible implementation of a repository with the version control system. EDP Business Entity - a part of the CI/CD process (the integration, delivery, and deployment of any codebase changes) Application - a codebase type that is built as the binary artifact and deployable unit with the code that is stored in VCS. As a result, the application becomes a container and can be deployed in an environment. Autotests - a codebase type that inspects a product (e.g. an application set) on a stage. Autotests are not deployed to any container and launched from the respective code stage. CD Pipeline (Continuous Delivery Pipeline) - an EDP business entity that describes the whole delivery process of the selected application set via the respective stages. The main idea of the CD pipeline is to promote the application version between the stages by applying the sequential verification (i.e. the second stage will be available if the verification on the first stage is successfully completed). NOTE: The CD pipeline can include the essential set of applications with its specific stages as well. CD Pipeline Stage - an EDP business entity that is presented as the logical gate required for the application set inspection. Every stage has one OpenShift project where the selected application set is deployed. All stages are sequential and promote applications one-by-one. Codebase - an EDP business entity that possesses a code. Codebase Branch - an EDP business entity that represents a specific version in a Git branch. Every codebase branch has a Codebase Docker Stream entity. Codebase Docker Stream - a deployable component that leads to the application build and displays that the last build was verified on the specific stage. Every CD pipeline stage accepts a set of Codebase Docker Streams (CDS) that are input and output. SAMPLE: if an application1 has a master branch, the input CDS will be named as [app name]-[pipeline name]-[stage name]-[master] and the output after the passing of the DEV stage will be as follows: [app name]-[pipeline name]-[stage name]-[dev]-[verified]. Library - a codebase type that is built as the binary artifact, i.e. it`s stored in the Artifactory and can be uploaded by other applications, autotests or libraries. Quality Gate - an EDP business entity that represents the minimum acceptable results after the testing. Every stage has a quality gate that should be passed to promote the application. The stage quality gate can be a manual approve from a QA specialist OR a successful autotest launch. Quality Gate Type - this value defines trigger type that promotes artifacts (images) to the next environment in CD Pipeline. There are manual and automatic types of quality gates. The manual type means that the promoting process should be confirmed in Jenkins. The automatic type promotes the images automatically in case there are no errors in the Allure Report. NOTE: If any of the test types is not passed, the CD pipeline will fail. Trigger Type - a value that defines a trigger type used for the CD pipeline triggering. There are manual and automatic types of triggering. The manual type means that the CD pipeline should be triggered manually. The automatic type triggers the CD pipeline automatically as soon as the Codebase Docker Stream was changed. EDP CI/CD Pipelines Framework - a library that allows extending the Jenkins pipelines and stages to develop an application. Pipelines are presented as the shared library that can be connected in Jenkins. The library is connected using the Git repository link (a public repository that is supported by EDP) on the GitHub. Allure Report- a tool that represents test results in one brief report in a clear form. Automated Tests - different types of automated tests that can be run on the environment for a specific stage. Build Pipeline - a Jenkins pipeline that builds a corresponding codebase branch in the Codebase. Build Stage - a stage that takes place after the code has been submitted/merged to the repository of the main branch (the pull request from the feature branch is merged to the main one, the Patch set is submitted in Gerrit). Code Review Pipeline - a Jenkins pipeline that inspects the code candidate in the Code Review tool. Code Review Stage - a stage where code is reviewed before it goes to the main branch repository of the version control system (the commit to the feature branch is pushed, the Patch set is created in Gerrit). Deploy Pipeline - a Jenkins pipeline that is responsible for the CD Pipeline Stage deployment with the full set of applications and autotests. Deployment Stage - a part of the Continuous Delivery where artifacts are being deployed to environments. EDP CI/CD Pipelines - an orchestrator for stages that is responsible for the common technical events, e.g. initialization, in Jenkins pipeline. The set of stages for the pipeline is defined as an input JSON file for the respective Jenkins job. NOTE: There is the ability to create the necessary realization of the library pipeline on your own as well. EDP CI/CD Stages - a repository that is launched in the Jenkins pipeline. Every stage is presented as an individual Groovy file in a corresponding repository. Such single responsibility realization allows rewriting of one essential stage without changing the whole pipeline. Environment - a part of the stage where the built and packed into an image application are deployed for further testing. It`s possible to deploy several applications to several environments (Team and Integration environments) within one stage. Integration Environment - an environment type that is always deployed as soon as the new application version is built in order to launch the integration test and promote images to the next stages. The Integration Environment can be triggered manually or in case a new image appears in the Docker registry. Jenkinsfile - a text file that keeps the definition of a Jenkins Pipeline and is checked into source control. Every Job has its Jenkinsfile that is stored in the specific application repository and in Jenkins as the plain text. Jenkins Node - a machine that is a part of the Jenkins environment that is capable of executing a pipeline. Jenkins Pipeline - a user-defined model of a CD pipeline. The pipeline code defines the entire build process. Jenkins Stage - a part of the whole CI/CD process that should pass the source code in order to be released and deployed on the production. Team Environment - an environment type that can be deployed at any time by the manual trigger of the Deploy pipeline where team or developers can check out their applications. NOTE: The promotion from such kind of environment is prohibited and developed only for the local testing. OpenShift / Kubernetes (K8S) ConfigMap - a resource that stores configuration data and processes the strings that do not contain sensitive information. Docker Container - is a lightweight, standalone, and executable package. Docker Registry - a store for the Docker Container that is created for the application after the Build pipeline performance. OpenShift Web Console - a web console that enables to view, manage, and change OpenShift / K8S resources using browser. Operator Framework - a deployable unit in OpenShift that is responsible for one or a set of resources and performs its life circle (adding, displaying, and provisioning). Path - a route component that helps to find a specified path (e.g. /api) at once and skip the other. Pod - the smallest deployable unit of the large microservice application that is responsible for the application launch. The pod is presented as the one launched Docker container. When the Docker container is collected, it will be kept in Docker Registry and then saved as Pod in the OpenShift project. NOTE: The Deployment Config is responsible for the Pod push, restart, and stop processes. PV (Persistent Volume) - a cluster resource that captures the details of the storage implementation and has an independent lifecycle of any individual pod. PVC (Persistent Volume Claim) - a user request for storage that can request specific size and access mode. PV resources are consumed by PVCs. Route - a resource in OpenShift that allows getting the external access to the pushed application. Secret - an object that stores and manages all the sensitive information (e.g. passwords, tokens, and SSH keys). Service - an external connection point with Pod that is responsible for the network. A specific Service is connected to a specific Pod using labels and redirects all the requests to Pod as well. Site - a route component (link name) that is created from the indicated application name and applies automatically the project name and a wildcard DNS record."},{"location":"overview/","title":"Overview","text":"<p>EPAM Delivery Platform (EDP) is an open-source cloud-agnostic SaaS/PaaS solution for software development, licensed under Apache License 2.0. It provides a pre-defined set of CI/CD patterns and tools, which allow a user to start product development quickly with established code review, release, versioning, branching, build processes. These processes include static code analysis, security checks, linters, validators, dynamic feature environments provisioning. EDP consolidates the top Open-Source CI/CD tools by running them on Kubernetes/OpenShift, which enables web/app development either in isolated (on-prem) or cloud environments.</p> <p>EPAM Delivery Platform, which is also called \"The Rocket\", is a platform that allows shortening the time that is passed before an active development can be started from several months to several hours.</p> <p>EDP consists of the following:</p> <ul> <li>The platform based on managed infrastructure and container orchestration</li> <li>Security covering authentication, authorization, and SSO for platform services</li> <li>Development and testing toolset</li> <li>Well-established engineering process and EPAM practices (EngX) reflected in CI/CD pipelines, and delivery analytics</li> <li>Local development with debug capabilities</li> </ul>"},{"location":"overview/#features","title":"Features","text":"<ul> <li>Deployed and configured CI/CD toolset (Tekton, ArgoCD, Jenkins, Nexus, SonarQube, DefectDojo)</li> <li>Gerrit, GitLab or GitHub as a version control system for your code</li> <li>Tekton is a default pipeline orchestrator</li> <li>Jenkins is an optional pipeline orchestrator</li> <li> <p>CI pipelines</p> Tekton (by default)Jenkins (optional) Language Framework Build Tool Application Library Autotest Java Java 8, Java 11, Java 17 Gradle, Maven Python Python 3.8, FastAPI, Flask Python C# .Net 3.1, .Net 6.0 .Net Go Beego, Gin, Operator SDK Go JavaScript React, Vue, Angular, Express, Next.js, Antora NPM HCL Terraform Terraform Helm Helm, Pipeline Helm Groovy Codenarc Codenarc Rego OPA OPA Container Docker Kaniko Language Framework Build Tool Application Library Autotest Java Java 8, Java 11 Gradle, Maven Python Python 3.8 Python .Net .Net 3.1 .Net Go Beego, Operator SDK Go JavaScript React NPM HCL Terraform Terraform Groovy Codenarc Codenarc Rego OPA OPA Container Docker Kaniko </li> </ul> <ul> <li>Portal UI as a single entry point</li> <li>CD pipeline for Microservice Deployment</li> <li>Kubernetes native approach (CRD, CR) to declare CI/CD pipelines</li> </ul>"},{"location":"overview/#whats-inside","title":"What's Inside","text":"<p>EPAM Delivery Platform (EDP) is suitable for all aspects of delivery starting from development including the capability to deploy production environment. EDP architecture is represented on a diagram below.</p> <p> Architecture </p> <p>EDP consists of four cross-cutting concerns:</p> <ol> <li>Infrastructure as a Service;</li> <li>GitOps approach;</li> <li>Container orchestration and centralized services;</li> <li>Security.</li> </ol> <p>On the top of these indicated concerns, EDP adds several blocks that include:</p> <ul> <li>EDP CI/CD Components. EDP component enables a feature in CI/CD or an instance artifacts storage and distribution (Nexus or Artifactory), static code analysis (Sonar), etc.;</li> <li>EDP Artifacts. This element represents an artifact that is being delivered through EDP and presented as a code. <p>Artifact samples: frontend, backend, mobile, applications, functional and non-functional autotests, workloads for 3rd party components that can be deployed together with applications.</p> </li> </ul> <ul> <li>EDP development and production environments that share the same logic. Environments wrap a set of artifacts with a specific version, and allow performing SDLC routines in order to be sure of the artifacts quality;</li> <li>Pipelines. Pipelines cover CI/CD process, production rollout and updates. They also connect three elements indicated above via automation allowing SDLC routines to be non-human;</li> </ul>"},{"location":"overview/#technology-stack","title":"Technology Stack","text":"<p>Explore the EDP technology stack diagram</p> <p> Technology stack </p> <p>The EDP IaaS layer supports most popular public clouds AWS, Azure and GCP keeping the capability to be deployed on private/hybrid clouds based on OpenStack. EDP containers are based on Docker technology, orchestrated by Kubernetes compatible solutions.</p> <p>There are two main options for Kubernetes provided by EDP:</p> <ul> <li>Managed Kubernetes in Public Clouds to avoid installation and management of Kubernetes cluster, and get all benefits of scaling, reliability of this solution;</li> <li>OpenShift that is a Platform as a Service on the top of Kubernetes from Red Hat. OpenShift is the default option for on-premise installation and it can be considered whether the solution built on the top of EDP should be cloud-agnostic or require enterprise support;</li> </ul> <p>There is no limitation to run EDP on vanilla Kubernetes.</p>"},{"location":"overview/#related-articles","title":"Related Articles","text":"<ul> <li>Quick Start</li> <li>Basic Concepts</li> <li>Glossary</li> <li>Supported Versions and Compatibility</li> </ul>"},{"location":"roadmap/","title":"RoadMap","text":"<p>RoadMap consists of three streams:</p> <ul> <li>Community</li> <li>Architecture</li> <li>Building Blocks</li> <li>Admin Console</li> <li>Documentation</li> </ul>"},{"location":"roadmap/#i-community","title":"I. Community","text":"<p>Goals:</p> <ul> <li>Innovation Through Collaboration</li> <li>Improve OpenSource Adoption</li> <li>Build Community around technology solutions EDP is built on</li> </ul>"},{"location":"roadmap/#deliver-operators-on-operatorhub","title":"Deliver Operators on OperatorHub","text":"<p>OperatorHub is a defacto leading solution which consolidates Kubernetes Community around Operators. EDP follows the best practices of delivering Operators in a quick and reliable way. We want to improve Deployment and Management experience for our Customers by publishing all EDP operators on this HUB.</p> <p>Another artifact aggregator which is used by EDP - ArtifactHub, that holds description for both components: stable and under-development.</p> <p>OperatorHub. Keycloak Operator</p> <p>EDP Keycloak Operator is now available from OperatorHub both for Upstream (Kubernetes) and OpenShift deployments.</p>"},{"location":"roadmap/#ii-architecture","title":"II. Architecture","text":"<p>Goals:</p> <ul> <li>Improve reusability for EDP components</li> <li>Integrate Kubernetes Native Deployment solutions</li> <li>Introduce abstraction layer for CI/CD components</li> <li>Build processes around the GitOps approach</li> <li>Introduce secrets management</li> </ul>"},{"location":"roadmap/#kubernetes-multitenancy","title":"Kubernetes Multitenancy","text":"<p>Multiple instances of EDP are run in a single Kubernetes cluster. One way to achieve this is to use Multitenancy. Initially, Kiosk was selected as tools that provides this capability. An alternative option that EDP Team took into consideration is Capsule. Another tool which goes far beyond multitenancy is vcluster going a good candidate for e2e testing scenarios where one needs simple lightweight kubernetes cluster in CI pipelines.</p>"},{"location":"roadmap/#microservice-reference-architecture-framework","title":"Microservice Reference Architecture Framework","text":"<p>EDP provides basic Application Templates for a number of technology stacks (Java, .Net, NPM, Python) and Helm is used as a deployment tool. The goal is to extend this library and provide: Application Templates which are built on pre-defined architecture patterns (e.g., Microservice, API Gateway, Circuit Breaker, CQRS, Event Driven) and Deployment Approaches: Canary, Blue/Green. This requires additional tools installation on cluster as well.</p>"},{"location":"roadmap/#policy-enforcement-for-kubernetes","title":"Policy Enforcement for Kubernetes","text":"<p>Running workload in Kubernetes calls for extra effort from Cluster Administrators to ensure those workloads do follow best practices or specific requirements defined on organization level. Those requirements can be formalized in policies and integrated into: CI Pipelines and Kubernetes Cluster (through Admission Controller approach) - to guarantee proper resource management during development and runtime phases. EDP uses Open Policy Agent (from version 2.8.0), since it supports compliance check for more use-cases: Kubernetes Workloads, Terraform and Java code, HTTP APIs and many others. Kyverno is another option being checked in scope of this activity.</p>"},{"location":"roadmap/#secrets-management","title":"Secrets Management","text":"<p>EDP should provide secrets management as a part of platform. There are multiple tools providing secrets management capabilities. The aim is to be aligned with GitOps and Operator Pattern approaches so HashiCorp Vault, Banzaicloud Bank Vaults, Bitnami Sealed Secrets are currently used for internal projects and some of them should be made publicly available - as a part of EDP Deployment.</p> <p>EDP Release 2.12.x</p> <p>External Secret Operator is a recommended secret management tool for the EDP components.</p>"},{"location":"roadmap/#release-management","title":"Release Management","text":"<p>Conventional Commits and Conventional Changelog are two approaches to be used as part of release process. Today EDP provides only capabilities to manage Release Branches. This activity should address this gap by formalizing and implementing Release Process as a part of EDP. Topics to be covered: Versioning, Tagging, Artifacts Promotion.</p>"},{"location":"roadmap/#kubernetes-native-cicd-pipelines","title":"Kubernetes Native CI/CD Pipelines","text":"<p>EDP uses Jenkins as Pipeline Orchestrator. Jenkins runs workload for CI and CD parts. There is also basic support for GitLab CI, but it provides Docker image build functionality only. EDP works on providing an alternative to Jenkins and use Kubernetes Native Approach for pipeline management. There are a number of tools, which provides such capability:</p> <ul> <li>Argo CD</li> <li>Argo Workflows</li> <li>Argo Rollouts</li> <li>Tekton</li> <li>Drone</li> <li>Flux</li> </ul> <p>This list is under investigation and solution is going to be implemented in two steps:</p> <ol> <li>Introduce tool that provide Continues Delivery/Deployment approach. Argo CD is one of the best to go with.</li> <li>Integrate EDP with tool that provides Continues Integration capabilities.</li> </ol> <p>EDP Release 2.12.x</p> <p>Argo CD is suggested as a solution providing the <code>Continuous Delivery</code> capabilities.</p> <p>EDP Release 3.0</p> <p>Tekton is used as a CI/CD pipelines orchestration tool on the platform. Review edp-tekton GitHub repository that keeps all the logic behind this solution on the EDP (Pipelines, Tasks, TriggerTemplates, Interceptors, etc). Get acquainted with the series of publications on our Medium Page.</p>"},{"location":"roadmap/#advanced-edp-role-based-model","title":"Advanced EDP Role-based Model","text":"<p>EDP has a number of base roles which are used across EDP. In some cases it is necessary to provide more granular permissions for specific users. It is possible to do this using Kubernetes Native approach.</p>"},{"location":"roadmap/#notifications-framework","title":"Notifications Framework","text":"<p>EDP has a number of components which need to report their statuses: Build/Code Review/Deploy Pipelines, changes in Environments, updates with artifacts. The goal for this activity is to onboard Kubernetes Native approach which provides Notification capabilities with different sources/channels integration (e.g. Email, Slack, MS Teams). Some of these tools are Argo Events, Botkube.</p>"},{"location":"roadmap/#reconciler-component-retirement","title":"Reconciler Component Retirement","text":"<p>Persistent layer, which is based on edp-db (PostgreSQL) and reconciler component should be retired in favour of Kubernetes Custom Resource (CR). The latest features in EDP are implemented using CR approach.</p> <p>EDP Release 3.0</p> <p>Reconciler component is deprecated and is no longer supported. All the EDP components are migrated to Kubernetes Custom Resources (CR).</p>"},{"location":"roadmap/#iii-building-blocks","title":"III. Building Blocks","text":"<p>Goals:</p> <ul> <li>Introduce best practices from Microservice Reference Architecture deployment and observability using Kubernetes Native Tools</li> <li>Enable integration with the Centralized Test Reporting Frameworks</li> <li>Onboard SAST/DAST tool as a part of CI pipelines and Non-Functional Testing activities</li> </ul> <p>EDP Release 2.12.x</p> <p>SAST is introduced as a mandatory part of the CI Pipelines. The list of currently supported SAST scanners and the instruction on how to add them are also available.</p>"},{"location":"roadmap/#infrastructure-as-code","title":"Infrastructure as Code","text":"<p>EDP Target tool for Infrastructure as Code (IaC) is Terraform. EDP sees two CI/CD scenarios while working with IaC: Module Development and Live Environment Deployment. Today, EDP provides basic capabilities (CI Pipelines) for Terraform Module Development. At the same time, currently EDP doesn't provide Deployment pipelines for Live Environments and the feature is under development. Terragrunt is an option to use in Live Environment deployment. Another Kubernetes Native approach to provision infrastructure components is Crossplane.</p>"},{"location":"roadmap/#database-schema-management","title":"Database Schema Management","text":"<p>One of the challenges for Application running in Kubernetes is to manage database schema. There are a number of tools which provides such capabilities, e.g. Liquibase, Flyway. Both tools provide versioning control for database schemas. There are different approaches on how to run migration scripts in Kubernetes: in init container, as separate Job or as a separate CD stage. Purpose of this activity is to provide database schema management solution in Kubernetes as a part of EDP. EDP Team investigates SchemaHero tool and use-cases which suits Kubernetes native approach for database schema migrations.</p>"},{"location":"roadmap/#open-policy-agent","title":"Open Policy Agent","text":"<p>Open Policy Agent is introduced in version 2.8.0. EDP now supports CI for Rego Language, so you can develop your own policies. The next goal is to provide pipeline steps for running compliance policies check for Terraform, Java, Helm Chart as a part of CI process.</p>"},{"location":"roadmap/#report-portal","title":"Report Portal","text":"<p>EDP uses Allure Framework as a Test Report tool. Another option is to integrate Report Portal into EDP ecosystem.</p> <p>EDP Release 3.0</p> <p>Use ReportPortal to consolidate and analyze your Automation tests results. Consult our pages on how to perform reporting and Keycloak integration.</p>"},{"location":"roadmap/#carrier","title":"Carrier","text":"<p>Carrier provides Non-functional testing capabilities.</p>"},{"location":"roadmap/#java-17","title":"Java 17","text":"<p>EDP supports two LTS versions of Java: 8 and 11. The goal is to provide Java 17 (LTS) support.</p> <p>EDP Release 3.2.1</p> <p>CI Pipelines for Java 17 is available in EDP.</p>"},{"location":"roadmap/#velero","title":"Velero","text":"<p>Velero is used as a cluster backup tool and is deployed as a part of Platform. Currently, Multitenancy/On-premise support for backup capabilities is in process.</p>"},{"location":"roadmap/#istio","title":"Istio","text":"<p>Istio is to be used as a Service Mesh and to address challenges for Microservice or Distributed Architectures.</p>"},{"location":"roadmap/#kong","title":"Kong","text":"<p>Kong is one of tools which is planned to use as an API Gateway solution provider. Another possible candidate for investigation is Ambassador API Gateway</p>"},{"location":"roadmap/#openshift-4x","title":"OpenShift 4.X","text":"<p>EDP supports the OpenShift 4.9 platform.</p> <p>EDP Release 2.12.x</p> <p>EDP Platform runs on the latest OKD versions: 4.9 and 4.10. Creating the IAM Roles for Service Account is a recommended way to work with AWS Resources from the OKD cluster.</p>"},{"location":"roadmap/#iv-admin-console-ui","title":"IV. Admin Console (UI)","text":"<p>Goals:</p> <ul> <li>Improve U\u0425 for different user types to address their concerns in the delivery model</li> <li>Introduce user management capabilities</li> <li>Enrich with traceability metrics for products</li> </ul> <p>EDP Release 2.12.x</p> <p>EDP Team has introduced a new UI component called EDP Headlamp, which will replace the EDP Admin Console in future releases. EDP Headlamp is based on the Kinvolk Headlamp UI Client.</p> <p>EDP Release 3.0</p> <p>EDP Headlamp is used as a Control Plane UI on the platform.</p> <p>EDP Release 3.4</p> <p>Since EDP v3.4.0, Headlamp UI has been renamed to EDP Portal.</p>"},{"location":"roadmap/#users-management","title":"Users Management","text":"<p>EDP uses Keycloak as an Identity and Access provider. EDP roles/groups are managed inside the Keycloak realm, then these changes are propagated across the EDP Tools. We plan to provide this functionality in EDP Portal using the Kubernetes-native approach (Custom Resources).</p>"},{"location":"roadmap/#the-delivery-pipelines-dashboard","title":"The Delivery Pipelines Dashboard","text":"<p>The CD Pipeline section in EDP Portal provides basic information, such as environments, artifact versions deployed per each environment, and direct links to the namespaces. One option is to enrich this panel with metrics from the Prometheus, custom resources, or events. Another option is to use the existing dashboards and expose EDP metrics to them, for example, plugin for Lens or OpenShift UI Console.</p>"},{"location":"roadmap/#split-jira-and-commit-validation-sections","title":"Split Jira and Commit Validation Sections","text":"<p>Commit Validate step was initially designed to be aligned with Jira Integration and cannot be used as single feature. Target state is to ensure features CommitMessage Validation and Jira Integration both can be used independently. We also want to add support for Conventional Commits.</p> <p>EDP Release 3.2.0</p> <p>EDP Portal has separate sections for Jira Integration and CommitMessage Validation step.</p>"},{"location":"roadmap/#v-documentation-as-code","title":"V. Documentation as Code","text":"<p>Goal:</p> <ul> <li>Transparent documentation and clear development guidelines for EDP customization.</li> </ul> <p>Consolidate documentation in a single repository edp-install, use <code>mkdocs</code> tool to generate docs and GitHub Pages as a hosting solution.</p>"},{"location":"supported-versions/","title":"Supported Versions and Compatibility","text":"<p>EPAM Delivery Platform supports only the three last versions. For a stable performance, the EDP team recommends installing the corresponding Kubernetes and OpenShift versions as indicated in the table below.</p> <p>Get acquainted with the list of the latest releases and component versions on which the platform is tested and verified:</p> EDP Release Version Release Date EKS Version OpenShift Version 3.5 Sep 21, 2023 1.26 4.12 3.4 Aug 18, 2023 1.26 4.12 3.3 May 25, 2023 1.26 4.12 3.2 Mar 26, 2023 1.23 4.10 3.1 Jan 24, 2023 1.23 4.10 3.0 Dec 19, 2022 1.23 4.10 2.12 Aug 30, 2022 1.23 4.10"},{"location":"developer-guide/","title":"Overview","text":"<p>The EDP Developer guide is intended for developers and provides details on the necessary actions to extend the EDP functionality.</p>"},{"location":"developer-guide/edp-workflow/","title":"EDP Project Rules. Working Process","text":"<p>This page contains the details on the project rules and working process for EDP team and contributors. Explore the main points about working with Gerrit, following the main commit flow, as well as the details about commit types and message below.</p>"},{"location":"developer-guide/edp-workflow/#project-rules","title":"Project Rules","text":"<p>Before starting the development, please check the project rules:</p> <ol> <li> <p>It is highly recommended to become familiar with the Gerrit flow. For details, please refer to the Gerrit official documentation and pay attention to the main points:</p> <p>a. Voting in Gerrit.</p> <p>b. Resolution of Merge Conflict.</p> <p>c. Comments resolution.</p> <p>d. One Jira task should have one Merge Request (MR). If there are many changes within one MR, add the next patch set to the open MR by selecting the Amend commit check box.</p> </li> <li> <p>Only the Assignee is responsible for the MR merge and Jira task status.</p> </li> <li> <p>Every MR should be merged in a timely manner.</p> </li> <li> <p>Log time to Jira ticket.</p> </li> </ol>"},{"location":"developer-guide/edp-workflow/#working-process","title":"Working Process","text":"<p>With EDP, the main workflow is based on the getting a Jira task and creating a Merge Request according to the rules described below.</p> <p>Workflow</p> <p>Get Jira task \u2192 implement, verify by yourself the results \u2192 create Merge Request (MR) \u2192 send for review \u2192 resolve comments/add changes, ask colleagues for the final review \u2192 track the MR merge \u2192 verify by yourself the results \u2192 change the status in the Jira ticket to CODE COMPLETE or RESOLVED \u2192 share necessary links with a QA specialist in the QA Verification channel \u2192 QA specialist closes the Jira task after his verification \u2192 Jira task should be CLOSED.</p> <p>Commit Flow</p> <ol> <li> <p>Get a task in the Jira/GitHub dashboard. Please be aware of the following points:</p> JiraGitHub <p>a. Every task has a reporter who can provide more details in case something is not clear.</p> <p>b. The responsible person for the task and code implementation is the assignee who tracks the following:</p> <ul> <li>Actual Jira task status.</li> </ul> <ul> <li>Time logging.</li> </ul> <ul> <li>Add comments, attach necessary files.</li> </ul> <ul> <li>In comments, add link that refers to the merged MR (optional, if not related to many repositories).</li> </ul> <ul> <li>Code review and the final merge.</li> </ul> <ul> <li>MS Teams chats - ping other colleagues, answer questions, etc.</li> </ul> <ul> <li>Verification by a QA specialist.</li> </ul> <ul> <li>Bug fixing.</li> </ul> <p>c. Pay attention to the task Status that differs in different entities, the workflow will help to see the whole task processing:</p> <p> View Jira workflow </p> <p>d. There are several entities that are used on the EDP project: Story, Improvement, Task, Bug.</p> <p>a. Every task has a reporter who can provide more details in case something is not clear.</p> <p>b. The responsible person for the task and code implementation is the assignee who tracks the following:</p> <ul> <li>Actual GitHub task status.</li> </ul> <ul> <li>Add comments, attach necessary files.</li> </ul> <ul> <li>In comments, add link that refers to the merged MR (optional, if not related to many repositories).</li> </ul> <ul> <li>Code review and the final merge.</li> </ul> <ul> <li>MS Teams chats - ping other colleagues, answer questions, etc.</li> </ul> <ul> <li>Verification by a QA specialist.</li> </ul> <ul> <li>Bug fixing.</li> </ul> <p>c. If the task is created on your own, make sure it is populated completely. See an example below:</p> <p> GitHub issue </p> </li> <li> <p>Implement feature, improvement, fix and check the results on your own. If it is impossible to check the results of your work before the merge, verify all later.</p> </li> <li> <p>Create a Merge Request, for details, please refer to the Code Review Process.</p> </li> <li> <p>When committing, use the pattern: commit type: Commit message (#GitHub ticket number).</p> <p>a. commit type:</p> <p><code>feat</code>: (new feature for the user, not a new feature for build script)</p> <p><code>fix</code>: (bug fix for the user, not a fix to a build script)</p> <p><code>docs</code>: (changes to the documentation)</p> <p><code>style</code>: (formatting, missing semicolons, etc; no production code change)</p> <p><code>refactor</code>: (refactoring production code, eg. renaming a variable)</p> <p><code>test</code>: (adding missing tests, refactoring tests; no production code change)</p> <p><code>chore</code>: (updating grunt tasks etc; no production code change)</p> <p><code>!</code>: (added to other commit types to mark breaking changes) For example:</p> <pre><code>feat!: Job provisioner is responsible for the formation of Jenkinsfile (#26)\n\nBREAKING CHANGE: Job provisioner creates Jenkinsfile and configures it in Jenkins pipeline as a pipeline script.\n</code></pre> <p>b. Commit message:</p> <ul> <li> <p>brief, for example:</p> <p><code>fix: Fix Gerrit plugin for Jenkins provisioning (#62)</code></p> <p>or</p> </li> </ul> <ul> <li> <p>descriptive, for example:</p> <pre><code>feat: Provide the ability to configure hadolint check (#88)\n\n*Add configuration files .hadolint.yaml and .hadolint.yml to stash\n</code></pre> <p>Note</p> <p>It is mandatory to start a commit message from a capital letter.</p> </li> </ul> <p>c. GitHub tickets are typically identified using a number preceded by the # sign and enclosed in parentheses.</p> </li> </ol> <p>Note</p> <p>Make sure there is a descriptive commit message for a breaking change Merge Request. For example:</p> <p>feat!: Job provisioner is responsible for the formation of Jenkinsfile</p> <p>BREAKING CHANGE: Job provisioner creates Jenkinsfile and configures it in Jenkins pipeline as a pipeline script.</p> <p>Note</p> <p>If a Merge Request contains both new functionality and breaking changes, make sure the functionality description is placed before the breaking changes. For example:</p> <p>feat!: Update Gerrit to improve access</p> <ul> <li>Implement Developers group creation process</li> <li>Align group permissions</li> </ul> <p>BREAKING CHANGES: Update Gerrit config according to groups</p>"},{"location":"developer-guide/edp-workflow/#related-articles","title":"Related Articles","text":"<ul> <li>Conventional Commits</li> <li>Karma</li> </ul>"},{"location":"developer-guide/local-development/","title":"Workspace Setup Manual","text":"<p>This page is intended for developers with the aim to share details on how to set up the local environment and start coding in Go language for EPAM Delivery Platform.</p>"},{"location":"developer-guide/local-development/#prerequisites","title":"Prerequisites","text":"<ul> <li>Git is installed;</li> </ul> <ul> <li>One of our repositories where you would like to contribute is cloned locally;</li> </ul> <ul> <li>Docker is installed;</li> </ul> <ul> <li>Kubectl is set up;</li> </ul> <ul> <li>Local Kubernetes cluster (Kind is recommended) is installed;</li> </ul> <ul> <li>Helm is installed;</li> </ul> <ul> <li>Any IDE (GoLand is used here as an example) is installed;</li> </ul> <ul> <li>GoLang stable version is installed.</li> </ul> <p>Note</p> <p>Make sure GOPATH and GOROOT environment variables are added in PATH.</p>"},{"location":"developer-guide/local-development/#environment-setup","title":"Environment Setup","text":"<p>Set up your environment by following the steps below.</p>"},{"location":"developer-guide/local-development/#set-up-your-ide","title":"Set Up Your IDE","text":"<p>We recommend using  GoLand  and enabling the  Kubernetes  plugin. Before installing plugins, make sure to save your work because IDE may require restarting.</p>"},{"location":"developer-guide/local-development/#set-up-your-operator","title":"Set Up Your Operator","text":"<p>To set up the cloned operator, follow the three steps below:</p> <ol> <li> <p>Configure Go Build Option. Open folder in GoLand, click the  button and select the <code>Go Build</code> option:</p> <p> Add configuration </p> </li> <li> <p>Fill in the variables in Configuration tab:</p> <ul> <li>In the <code>Files</code> field, indicate the path to the main.go file;</li> </ul> <ul> <li>In the <code>Working directory</code> field, indicate the path to the operator;</li> </ul> <ul> <li>In the <code>Environment field</code>, specify the namespace to watch by setting <code>WATCH_NAMESPACE</code> variable. It should equal <code>default</code> but it can be any other if required by the cluster specifications.</li> </ul> <ul> <li>In the <code>Environment field</code>, also specify the platform type by setting <code>PLATFORM_TYPE</code>. It should equal either <code>kubernetes</code> or <code>openshift</code>.</li> </ul> <p> Build config </p> </li> <li> <p>Check cluster connectivity and variables. Local development implies working within local Kubernetes clusters. Kind (Kubernetes in Docker) is recommended so set this or another environment first before running code.</p> </li> </ol>"},{"location":"developer-guide/local-development/#pre-commit-activities","title":"Pre-commit Activities","text":"<p>Before making commit and sending pull request, take care of precautionary measures to avoid crashing some other parts of the code.</p>"},{"location":"developer-guide/local-development/#testing-and-linting","title":"Testing and Linting","text":"<p>Testing and linting must be used before every single commit with no exceptions. The instructions for the commands below are written here.</p> <p>It is mandatory to run test and lint to make sure the code passes the tests and meets acceptance criteria. Most operators are covered by tests so just run them by issuing the commands \"make test\" and \"make lint\":</p> <pre><code>  make test\n</code></pre> <p>The command \"make test\" should give the output similar to the following:</p> <p> \"make test\" command </p> <pre><code>  make lint\n</code></pre> <p>The command \"make lint\" should give the output similar to the following:</p> <p> \"make lint\" command </p>"},{"location":"developer-guide/local-development/#observe-auto-generated-docs-api-and-manifests","title":"Observe Auto-Generated Docs, API and Manifests","text":"<p>The commands below are especially essential when making changes to API. The code is unsatisfactory if these commands fail.</p> <ul> <li> <p>Generate documentation in the .MD file format so the developer can read it:</p> <pre><code>make api-docs\n</code></pre> <p>The command \"make api-docs\" should give the output similar to the following:</p> </li> </ul> <p> \"make api-docs\" command with the file contents </p> <ul> <li> <p>There are also manifests within the operator that generate zz_generated.deepcopy.go file in /api/v1 directory. This file is necessary for the platform to work but it's time-consuming to fill it by yourself so there is a mechanism that does it automatically. Update it using the following command and check if it looks properly:</p> <pre><code>make generate\n</code></pre> <p>The command \"make generate\" should give the output similar to the following:</p> </li> </ul> <p> \"make generate\" command </p> <ul> <li> <p>Refresh custom resource definitions for Kubernetes, thus allowing the cluster to know what resources it deals with.</p> <pre><code>make manifests\n</code></pre> <p>The command \"make manifests\" should give the output similar to the following:</p> </li> </ul> <p> \"make manifests\" command </p> <p>At the end of the procedure, you can push your code confidently to your branch and create a pull request.</p> <p>That's it, you're all set! Good luck in coding!</p>"},{"location":"developer-guide/local-development/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Project Rules. Working Process</li> </ul>"},{"location":"developer-guide/mk-docs-development/","title":"Documentation Flow","text":"<p>This section defines necessary steps to start developing the EDP documentation in the MkDocs Framework. The framework presents a static site generator with documentation written in Markdown. All the docs are configured with a YAML configuration file.</p> <p>Note</p> <p>For more details on the framework, please refer to the MkDocs official website.</p> <p>There are two options for working with MkDocs:</p> <ul> <li>Work with MkDocs if Docker is installed</li> <li>Work with MkDocs if Docker is not installed</li> </ul> <p>Please see below the detailed description of each options and choose the one that suits you.</p>"},{"location":"developer-guide/mk-docs-development/#mkdocs-with-docker","title":"MkDocs With Docker","text":"<p>Prerequisites:</p> <ul> <li>Docker is installed.</li> </ul> <ul> <li><code>make</code> utility is installed.</li> </ul> <ul> <li>Git is installed. Please refer to the Git downloads.</li> </ul> <p>To work with MkDocs, take the following steps:</p> <ol> <li> <p>Clone the edp-install repository to your local folder.</p> </li> <li> <p>Run the following command:</p> <p><code>make docs</code></p> </li> <li> <p>Enter the localhost:8000 address in the browser and check that documentation pages are available.</p> </li> <li> <p>Open the file editor, navigate to edp-install-&gt;docs and make necessary changes. Check all the changes at localhost:8000.</p> </li> <li> <p>Create a merge request with changes.</p> </li> </ol>"},{"location":"developer-guide/mk-docs-development/#mkdocs-without-docker","title":"MkDocs Without Docker","text":"<p>Prerequisites:</p> <ul> <li>Git is installed. Please refer to the Git downloads.</li> </ul> <ul> <li>Python 3.9.5 is installed.</li> </ul> <p>To work with MkDocs without Docker, take the following steps:</p> <ol> <li> <p>Clone the edp-install repository to your local folder.</p> </li> <li> <p>Run the following command:</p> <pre><code>pip install -r  hack/mkdocs/requirements.txt\n</code></pre> </li> <li> <p>Run the local development command:</p> <pre><code>mkdocs serve --dev-addr 0.0.0.0:8000\n</code></pre> <p>Note</p> <p>This command may not work on Windows, so a quick solution is: <pre><code>python -m mkdocs serve --dev-addr 0.0.0.0:8000\n</code></pre></p> </li> <li> <p>Enter the localhost:8000 address in the browser and check that documentation pages are available.</p> </li> <li> <p>Open the file editor, navigate to edp-install-&gt;docs and make necessary changes. Check all the changes at localhost:8000.</p> </li> <li> <p>Create a merge request with changes.</p> </li> </ol>"},{"location":"operator-guide/","title":"Overview","text":"<p>The EDP Operator guide is intended for DevOps and provides information on EDP installation, configuration and customization, as well as the platform support. Inspect the documentation to adjust the EPAM Delivery Platform according to your business needs:</p> <ul> <li>The Installation section provides the prerequisites for EDP installation, including Kubernetes or OpenShift cluster setup, Keycloak, DefectDojo, Kiosk, and Ingress-nginx setup as well as the subsequent deployment of EPAM Delivery Platform.</li> </ul> <ul> <li>The Configuration section indicates the options to set the project with adding a code language, backup, integrate VCS with Jenkins or Tekton, managing Jenkins pipelines, and logging.</li> </ul> <ul> <li>The Integration section comprises the AWS, GitHub, GitLab, Jira, and Logsight integration options.</li> </ul> <ul> <li>The Tutorials section provides information on working with various aspects, for example, using cert-manager in OpenShift, deploying AWS EKS cluster, deploying OKD 4.9 cluster, deploying OKD 4.10 cluster, managing Jenkins agent, and upgrading Keycloak v.17.0.x-legacy to v.19.0.x on Kubernetes.</li> </ul>"},{"location":"operator-guide/add-jenkins-agent/","title":"Manage Jenkins Agent","text":"<p>Inspect the main steps to add and update Jenkins agent.</p>"},{"location":"operator-guide/add-jenkins-agent/#createupdate-jenkins-agent","title":"Create/Update Jenkins Agent","text":"<p>Every Jenkins agent is based on epamedp/edp-jenkins-base-agent. Check DockerHub for the latest version. Use it to create a new agent (or update an old one). See the example with Dockerfile of gradle-java11-agent below:</p> View: Dockerfile <pre><code>    # Copyright 2021 EPAM Systems.\n    # Licensed under the Apache License, Version 2.0 (the \"License\");\n    # you may not use this file except in compliance with the License.\n    # You may obtain a copy of the License at\n    # http://www.apache.org/licenses/LICENSE-2.0\n    # Unless required by applicable law or agreed to in writing, software\n    # distributed under the License is distributed on an \"AS IS\" BASIS,\n    # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    # See the License for the specific language governing permissions and\n    # limitations under the License.\n\n    FROM epamedp/edp-jenkins-base-agent:1.0.1\n    SHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n    ENV GRADLE_VERSION=7.1 \\\n        PATH=$PATH:/opt/gradle/bin\n\n    # Install Gradle\n    RUN curl -skL -o /tmp/gradle-bin.zip https://services.gradle.org/distributions/gradle-$GRADLE_VERSION-bin.zip &amp;&amp; \\\n        mkdir -p /opt/gradle &amp;&amp; \\\n        unzip -q /tmp/gradle-bin.zip -d /opt/gradle &amp;&amp; \\\n        ln -sf /opt/gradle/gradle-$GRADLE_VERSION/bin/gradle /usr/local/bin/gradle\n\n    RUN yum install java-11-openjdk-devel.x86_64 -y &amp;&amp; \\\n        rpm -V java-11-openjdk-devel.x86_64 &amp;&amp; \\\n        yum clean all -y\n\n    WORKDIR $HOME/.gradle\n\n    RUN chown -R \"1001:0\" \"$HOME\" &amp;&amp; \\\n        chmod -R \"g+rw\" \"$HOME\"\n\n    USER 1001\n</code></pre> <p>After the Docker agent update/creation, build and load the image into the project registry (e.g. DockerHub, AWS ECR, etc.).</p>"},{"location":"operator-guide/add-jenkins-agent/#add-jenkins-agent-configuration","title":"Add Jenkins Agent Configuration","text":"<p>To add a new Jenkins agent, take the steps below:</p> <ol> <li> <p>Run the following command. Please be aware that <code>edp</code> is the name of the EDP tenant.</p> <pre><code>  kubectl edit configmap jenkins-slaves -n edp\n</code></pre> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> <p>Add new agent template.      View: ConfigMap jenkins-slaves <pre><code>  data:\n    docker-template: |-\n     &lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;docker&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;docker&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;IMAGE_NAME:IMAGE_TAG&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <p>Note</p> <p>The name and label properties should be unique(docker in the example above). Insert image name and tag instead of IMAGE_NAME:IMAGE_TAG.</p> <li> <p>Open Jenkins to ensure that everything is added correctly. Click the Manage Jenkins option, navigate to the Manage Nodes and Clouds-&gt;Configure Clouds-&gt;Kubernetes-&gt;Pod Templates..., and scroll down to find new Jenkins agent Pod Template details...:</p> <p> Jenkins pod template </p> <p>As a result, the newly added Jenkins agent will be available in the Advanced Settings block of the Admin Console tool during the codebase creation:</p> <p> Advanced settings </p> </li>"},{"location":"operator-guide/add-jenkins-agent/#modify-existing-agent-configuration","title":"Modify Existing Agent Configuration","text":"<p>If your application is integrated with EDP, take the steps below to change an existing agent configuration:</p> <ol> <li> <p>Run the following command. Please be aware that <code>edp</code> is the name of the EDP tenant.</p> <pre><code>  kubectl edit configmap jenkins-slaves -n edp\n</code></pre> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> </li> <li> <p>Find the agent template in use and change and change the parameters.</p> </li> <li> <p>Open Jenkins and check the correct addition. Click the Manage Jenkins option, navigate to the Manage Nodes and Clouds-&gt;Configure Clouds-&gt;Kubernetes-&gt;Pod Templates..., and scroll down to Pod Template details... with the necessary data.</p> </li> </ol>"},{"location":"operator-guide/add-ons-overview/","title":"Cluster Add-Ons Overview","text":"<p>This page describes the entity of Cluster Add-Ons for EPAM Delivery Platform, as well as their purpose, benefits and usage.</p>"},{"location":"operator-guide/add-ons-overview/#what-are-add-ons","title":"What Are Add-Ons","text":"<p>EDP Add-Ons is basically a Kubernetes-based structure that enables users to quickly install additional components for the platform using Argo CD applications.</p> <p>Add-Ons have been introduced into EDP starting from version 3.4.0. They empower users to seamlessly incorporate the platform with various additional components, such as SonarQube, Nexus, Keycloak, Jira, and more. This eliminates the need for manual installations, as outlined in the Install EDP page.</p> <p>In a nutshell, Add-Ons represent separate Helm Charts that imply to be installed by one click using the Argo CD tool.</p>"},{"location":"operator-guide/add-ons-overview/#add-ons-repository-structure","title":"Add-Ons Repository Structure","text":"<p>All the Add-Ons are stored in our public GitHub repository adhering to the GitOps approach. Apart from default Helm and Git files, it contains both custom resources called Applications for Argo CD and application source code. The repository follows the GitOps approach to enable Add-Ons with the capability to rollback changes when needed. The repository structure is the following:</p> <pre><code>  \u251c\u2500\u2500 CHANGELOG.md\n  \u251c\u2500\u2500 LICENSE\n  \u251c\u2500\u2500 Makefile\n  \u251c\u2500\u2500 README.md\n  \u251c\u2500\u2500 add-ons\n  \u2514\u2500\u2500 chart\n</code></pre> <ul> <li>add-ons - the directory that contains Helm charts of the applications that can be integrated with EDP using Add-Ons.</li> </ul> <ul> <li>chart - the directory that contains Helm charts with application templates that will be used to create custom resources called Applications for Argo CD.</li> </ul>"},{"location":"operator-guide/add-ons-overview/#enable-edp-add-ons","title":"Enable EDP Add-Ons","text":"<p>To enable EDP Add-Ons, it is necessary to have the configured Argo CD, and connect and synchronize the forked repository. To do this, follow the guidelines below:</p> <ol> <li> <p>Fork the Add-Ons repository to your personal account.</p> </li> <li> <p>Provide the parameter values for the values.yaml files of the desired Add-Ons you are going to install.</p> </li> <li> <p>Navigate to Argo CD -&gt; Settings -&gt; Repositories. Connect your forked repository where you have the values.yaml files changed by clicking the + Connect repo button:</p> <p> Connect the forked repository </p> </li> <li> <p>In the appeared window, fill in the following fields and click the Connect button:</p> <ul> <li>Name - select the namespace where the project is going to be deployed;</li> <li>Choose your connection method - choose Via SSH;</li> <li>Type - choose Helm;</li> <li>Repository URL - enter the URL of your forked repository.</li> </ul> <p> Repository parameters </p> </li> <li> <p>As soon as the repository is connected, the new item in the repository list will appear:</p> <p> Connected repository </p> </li> <li> <p>Navigate to Argo CD -&gt; Applications. Click the + New app button:</p> <p> Adding Argo CD application </p> </li> <li> <p>Fill in the required fields:</p> <ul> <li>Application Name - addons-demo;</li> <li>Project name - select the namespace where the project is going to be deployed;</li> <li>Sync policy - select Manual;</li> <li>Repository URL - enter the URL of your forked repository;</li> <li>Revision - Head;</li> <li>Path - select chart;</li> <li>Cluster URL - enter the URL of your cluster;</li> <li>Namespace - enter the namespace which must be equal to the Project name field.</li> </ul> </li> <li> <p>As soon as the repository is synchronized, the list of applications that can be installed by Add-Ons will be shown:</p> <p> Add-Ons list </p> </li> </ol>"},{"location":"operator-guide/add-ons-overview/#install-edp-add-ons","title":"Install EDP Add-Ons","text":"<p>Now that Add-Ons are enabled in Argo CD, they can be installed by following the steps below:</p> <ol> <li> <p>Choose the Add-On to install.</p> </li> <li> <p>On the chosen Add-On, click the \u22ee button and then Details:</p> <p> Open Add-Ons </p> </li> <li> <p>To install the Add-On, click the \u22ee button -&gt; Sync:</p> <p> Install Add-Ons </p> </li> <li> <p>Once the Add-On is installed, the Sync OK message will appear in the Add-On status bar:</p> <p> Sync OK message </p> </li> <li> <p>Open the application details by clicking on the little square with an arrow underneath the Add-On name:</p> <p> Open details </p> </li> <li> <p>Track application resources and status in the App details menu:</p> <p> Application details </p> </li> </ol> <p>As we see, Argo CD offers great observability and monitoring tools for its resources which comes in handy when using EDP Add-Ons.</p>"},{"location":"operator-guide/add-ons-overview/#available-add-ons-list","title":"Available Add-Ons List","text":"<p>The list of the available Add-Ons:</p> Name Description Default Argo CD A GitOps continuous delivery tool that helps automate the deployment, configuration, and lifecycle management of applications in Kubernetes clusters. false AWS EFS CSI Driver A Container Storage Interface (CSI) driver that enables the dynamic provisioning of Amazon Elastic File System (EFS) volumes in Kubernetes clusters. true Cert Manager A native Kubernetes certificate management controller that automates the issuance and renewal of TLS certificates. true DefectDojo A security vulnerability management tool that allows tracking and managing security findings in applications. true DependencyTrack A Software Composition Analysis (SCA) platform that helps identify and manage open-source dependencies and their associated vulnerabilities. true EDP An internal platform created by EPAM to enhance software delivery processes using DevOps principles and tools. false Extensions OIDC EDP Helm chart to provision OIDC clients for different Add-Ons using EDP Keycloak Operator. true External Secrets A Kubernetes Operator that fetches secrets from external secret management systems and injects them as Kubernetes Secrets. true Fluent Bit A lightweight and efficient log processor and forwarder that collects and routes logs from various sources in Kubernetes clusters. false Harbor A cloud-native container image registry that provides support for vulnerability scanning, policy-based image replication, and more. true Nginx ingress An Ingress controller that provides external access to services running within a Kubernetes cluster using Nginx as the underlying server. true Jaeger Operator An operator for deploying and managing Jaeger, an end-to-end distributed tracing system, in Kubernetes clusters. true Keycloak An open-source Identity and Access Management (IAM) solution that enables authentication, authorization, and user management in Kubernetes clusters. true Keycloak PostgreSQL A PostgreSQL database operator that simplifies the deployment and management of PostgreSQL instances in Kubernetes clusters. false MinIO Operator An operator that simplifies the deployment and management of MinIO, a high-performance object storage server compatible with Amazon S3, in Kubernetes clusters. true OpenSearch A community-driven, open-source search and analytics engine that provides scalable and distributed search capabilities for Kubernetes clusters. true OpenTelemetry Operator An operator for automating the deployment and management of OpenTelemetry, a set of observability tools for capturing, analyzing, and exporting telemetry data. true PostgreSQL Operator An operator for running and managing PostgreSQL databases in Kubernetes clusters with high availability and scalability. true Prometheus Operator An operator that simplifies the deployment and management of Prometheus, a monitoring and alerting toolkit, in Kubernetes clusters. true Redis Operator An operator for managing Redis, an in-memory data structure store, in Kubernetes clusters, providing high availability and horizontal scalability. true StorageClass A Kubernetes resource that provides a way to define different classes of storage with different performance characteristics for persistent volumes. true Tekton A flexible and cloud-native framework for building, testing, and deploying applications using Kubernetes-native workflows. true Vault An open-source secrets management solution that provides secure storage, encryption, and access control for sensitive data in Kubernetes clusters. true"},{"location":"operator-guide/add-other-code-language/","title":"Add Other Code Language","text":"<p>There is an ability to extend the default code languages when creating a codebase with the Clone or Import strategy.</p> <p> Other code language </p> <p>Warning</p> <p>The Create strategy does not allow to customize the default code language set.</p> <p>To customize the Build Tool list, perform the following:</p> <ul> <li> <p>Edit the edp-admin-console deployment by adding the necessary code language into the BUILD TOOLS field:</p> <pre><code> kubectl edit deployment edp-admin-console -n edp\n</code></pre> <p>Note</p> <p>Using an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> <p>Info</p> <p><code>edp</code> is the name of the EDP tenant here and in all the following steps.</p> View: edp-admin-console deployment <pre><code>...\nspec:\ncontainers:\n- env:\n...\n- name: BUILD_TOOLS\nvalue: docker # List of custom build tools in Admin Console, e.g. 'docker,helm';\n...\n...\n</code></pre> </li> </ul> <ul> <li>Add the Jenkins agent by following the instruction.</li> </ul> <ul> <li>Add the Custom CI pipeline provisioner by following the instruction.</li> </ul> <ul> <li> <p>As a result, the newly added Jenkins agent will be available in the Select Jenkins Slave dropdown list of the Advanced Settings block during the codebase creation:</p> <p> Advanced settings </p> </li> </ul> <p>If it is necessary to create Code Review and Build pipelines, add corresponding entries (e.g. stages[Build-application-docker], [Code-review-application-docker]). See the example below:</p> <pre><code>...\nstages['Code-review-application-docker'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + ',{\"name\": \"sonar\"}]'\nstages['Build-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build-image-kaniko\"}' + ',{\"name\": \"git-tag\"}]'\n...\n</code></pre> <p> Jenkins job provisioner </p> <p>Note</p> <p>Application is one of the available options. Another option might be to add a library. Please refer to the Add Library page for details.</p>"},{"location":"operator-guide/add-other-code-language/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Manage Jenkins Agent</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> </ul>"},{"location":"operator-guide/add-security-scanner/","title":"Add Security Scanner","text":"<p>In order to add a new security scanner, perform the steps below:</p> <ol> <li> <p>Select a pipeline customization option from the Customize CI Pipeline article. Follow the steps described in this article, to create a new repository.</p> <p>Note</p> <p>This tutorial will focus on adding a new stage using shared library via the custom global pipeline libraries.</p> </li> <li> <p>Open the new repository and create a directory with the <code>/src/com/epam/edp/customStages/impl/ci/impl/stageName/</code> name in the library repository, for example: <code>/src/com/epam/edp/customStages/impl/ci/impl/security/</code>. After that, add a Groovy file with another name to the same stages catalog, for example: <code>CustomSAST.groovy</code>.</p> </li> <li> <p>Copy the logic from <code>SASTMavenGradleGoApplication.groovy</code> stage into the new <code>CustomSAST.groovy</code> stage.</p> </li> <li> <p>Add a new <code>runGoSecScanner</code> function to the stage:</p> <pre><code>@Stage(name = \"sast-custom\", buildTool = [\"maven\",\"gradle\",\"go\"], type = [ProjectType.APPLICATION])\nclass CustomSAST {\n...\ndef runGoSecScanner(context) {\ndef edpName = context.platform.getJsonPathValue(\"cm\", \"edp-config\", \".data.edp_name\")\ndef reportData = [:]\nreportData.active = \"true\"\nreportData.verified = \"false\"\nreportData.path = \"sast-gosec-report.json\"\nreportData.type = \"Gosec Scanner\"\nreportData.productTypeName = \"Tenant\"\nreportData.productName = \"${edpName}\"\nreportData.engagementName = \"${context.codebase.name}-${context.git.branch}\"\nreportData.autoCreateContext = \"true\"\nreportData.closeOldFindings = \"true\"\nreportData.pushToJira = \"false\"\nreportData.environment = \"Development\"\nreportData.testTitle = \"SAST\"\nscript.sh(script: \"\"\"\n                set -ex\n                gosec -fmt=json -out=${reportData.path} ./...\n        \"\"\")\nreturn reportData\n}\n...\n}\n</code></pre> </li> <li> <p>Add function calls for the <code>runGoSecScanner</code> and <code>publishReport</code> functions:</p> <pre><code>...\nscript.node(\"sast\") {\nscript.dir(\"${testDir}\") {\nscript.unstash 'all-repo'\n...\ndef dataFromGoSecScanner = runGoSecScanner(context)\npublishReport(defectDojoCredentials, dataFromGoSecScanner)\n}\n}\n...\n</code></pre> </li> <li> <p>Gosec scanner will be installed on the Jenkins SAST agent. It is based on the <code>epamedp/edp-jenkins-base-agent</code>. Please check DockerHub for its latest version.</p> <p>See below an example of the <code>edp-jenkins-sast-agent</code> Dockerfile:</p> View: Default Dockerfile <pre><code> # Copyright 2022 EPAM Systems.\n\n # Licensed under the Apache License, Version 2.0 (the \"License\");\n # you may not use this file except in compliance with the License.\n # You may obtain a copy of the License at\n # http://www.apache.org/licenses/LICENSE-2.0\n\n # Unless required by applicable law or agreed to in writing, software\n # distributed under the License is distributed on an \"AS IS\" BASIS,\n # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\n # See the License for the specific language governing permissions and\n # limitations under the License.\n\n FROM epamedp/edp-jenkins-base-agent:1.0.31\n\n SHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n\n USER root\n\n ENV SEMGREP_SCANNER_VERSION=0.106.0 \\\n     GOSEC_SCANNER_VERSION=2.12.0\n\n RUN apk --no-cache add \\\n     curl=7.79.1-r2 \\\n     build-base=0.5-r3 \\\n     python3-dev=3.9.5-r2 \\\n     py3-pip=20.3.4-r1 \\\n     go=1.16.15-r0\n\n # hadolint ignore=DL3059\n RUN pip3 install --no-cache-dir --upgrade --ignore-installed \\\n     pip==22.2.1 \\\n     ruamel.yaml==0.17.21 \\\n     semgrep==${SEMGREP_SCANNER_VERSION}\n\n # Install GOSEC\n RUN curl -Lo /tmp/gosec.tar.gz https://github.com/securego/gosec/releases/download/v${GOSEC_SCANNER_VERSION}/gosec_${GOSEC_SCANNER_VERSION}_linux_amd64.tar.gz &amp;&amp; \\\n     tar xf /tmp/gosec.tar.gz &amp;&amp; \\\n     rm -f /tmp/gosec.tar.gz &amp;&amp; \\\n     mv gosec /bin/gosec\n\n RUN chown -R \"1001:0\" \"$HOME\" &amp;&amp; \\\n     chmod -R \"g+rw\" \"$HOME\"\n\n USER 1001\n</code></pre> </li> </ol>"},{"location":"operator-guide/add-security-scanner/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CI Pipeline</li> <li>Static Application Security Testing Overview</li> <li>Semgrep</li> </ul>"},{"location":"operator-guide/argocd-integration/","title":"Argo CD Integration","text":"<p>EDP uses Jenkins Pipeline as a part of the Continues Delivery/Continues Deployment implementation. Another approach is to use Argo CD tool as an alternative to Jenkins. Argo CD follows the best GitOps practices, uses Kubernetes native approach for the Deployment Management, has rich UI and required RBAC capabilities.</p>"},{"location":"operator-guide/argocd-integration/#argo-cd-deployment-approach-in-edp","title":"Argo CD Deployment Approach in EDP","text":"<p>Argo CD can be installed using two different approaches:</p> <ul> <li>Cluster-wide scope with the cluster-admin access</li> <li>Namespaced scope with the single namespace access</li> </ul> <p>Both approaches can be deployed with High Availability (HA) or Non High Availability (non HA) installation manifests.</p> <p>EDP uses the HA deployment with the cluster-admin permissions, to minimize cluster resources consumption by sharing single Argo CD instance across multiple EDP Tenants. Please follow the installation instructions to deploy Argo CD.</p>"},{"location":"operator-guide/argocd-integration/#edp-argo-cd-integration","title":"EDP Argo CD Integration","text":"<p>See a diagram below for the details:</p> <p> Argo CD Diagram </p> <ul> <li>Argo CD is deployed in a separate <code>argocd</code> namespace.</li> <li>Argo CD uses a <code>cluster-admin</code> role for managing cluster-scope resources.</li> <li>The <code>control-plane</code> application is created using the App of Apps approach, and its code is managed by the <code>control-plane</code> members.</li> <li>The <code>control-plane</code> is used to onboard new Argo CD Tenants (Argo CD Projects - AppProject).</li> <li>The <code>EDP Tenant Member</code> manages <code>Argo CD Applications</code> using <code>kind: Application</code> in the <code>edpTenant</code> namespace.</li> </ul> <p>The App Of Apps approach is used to manage the <code>EDP Tenants</code>. Inspect the edp-grub repository structure that is used to provide the EDP Tenants for the Argo CD Projects:</p> <pre><code>edp-grub\n\u251c\u2500\u2500 LICENSE\n\u251c\u2500\u2500 README.md\n\u251c\u2500\u2500 apps                      ### All Argo CD Applications are stored here\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 grub-argocd.yaml      # Application that provisions Argo CD Resources - Argo Projects (EDP Tenants)\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 grub-keycloak.yaml    # Application that provisions Keycloak Resources - Argo CD Groups (EDP Tenants)\n\u251c\u2500\u2500 apps-configs\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 grub\n\u2502\u00a0\u00a0     \u251c\u2500\u2500 argocd            ### Argo CD resources definition\n\u2502\u00a0\u00a0     \u2502\u00a0\u00a0 \u251c\u2500\u2500 team-bar.yaml\n\u2502\u00a0\u00a0     \u2502\u00a0\u00a0 \u2514\u2500\u2500 team-foo.yaml\n\u2502\u00a0\u00a0     \u2514\u2500\u2500 keycloak          ### Keycloak resources definition\n\u2502\u00a0\u00a0         \u251c\u2500\u2500 team-bar.yaml\n\u2502\u00a0\u00a0         \u2514\u2500\u2500 team-foo.yaml\n\u251c\u2500\u2500 bootstrap\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 root.yaml             ### Root application in App of Apps, which provision Applications from /apps\n\u2514\u2500\u2500 examples                  ### Examples\n\u2514\u2500\u2500 tenant\n        \u2514\u2500\u2500 foo-petclinic.yaml\n</code></pre> <p>The Root Application must be created under the <code>control-plane</code> scope.</p>"},{"location":"operator-guide/argocd-integration/#configuration","title":"Configuration","text":"<p>Note</p> <p>Make sure that both EDP and Argo CD are installed, and that SSO is enabled.</p> <p>To start using Argo CD with EDP, perform the following steps:</p>"},{"location":"operator-guide/argocd-integration/#keycloak","title":"Keycloak","text":"<ol> <li> <p>Create a Keycloak Group.</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmGroup\nmetadata:\nname: argocd-team-foo-users\nspec:\nname: ArgoCD-team-foo-users\nrealm: main\n</code></pre> </li> <li> <p>In Keycloak, add users to the <code>ArgoCD-team-foo-users</code> Keycloak Group.</p> </li> </ol>"},{"location":"operator-guide/argocd-integration/#argo-cd","title":"Argo CD","text":"<ol> <li> <p>Add a credential template for Gerrit, GitHub, GitLab integrations. The credential template must be created for each Git server.</p> GerritGitHub/GitLab <p>Copy existing SSH private key for Gerrit to Argo CD namespace</p> <pre><code>EDP_NAMESPACE=&lt;EPD_NAMESPACE&gt;\nGERRIT_PORT=$(kubectl get gerrit gerrit -n ${EDP_NAMESPACE} -o jsonpath='{.spec.sshPort}')\nGERRIT_ARGOCD_SSH_KEY_NAME=\"gerrit-argocd-sshkey\"\nGERRIT_URL=$(echo \"ssh://argocd@gerrit.${EDP_NAMESPACE}:${GERRIT_PORT}\" | base64)\nkubectl get secret ${GERRIT_ARGOCD_SSH_KEY_NAME} -n ${EDP_NAMESPACE} -o json | jq 'del(.data.username,.metadata.annotations,.metadata.creationTimestamp,.metadata.labels,.metadata.resourceVersion,.metadata.uid,.metadata.ownerReferences)' | jq '.metadata.namespace = \"argocd\"' | jq --arg name \"${EDP_NAMESPACE}\" '.metadata.name = $name' | jq --arg url \"${GERRIT_URL}\" '.data.url = $url' | jq '.data.sshPrivateKey = .data.id_rsa' | jq 'del(.data.id_rsa,.data.\"id_rsa.pub\")' | kubectl apply -f -\nkubectl label --overwrite secret ${EDP_NAMESPACE} -n argocd \"argocd.argoproj.io/secret-type=repo-creds\"\n</code></pre> <p>Generate an SSH key pair and add a public key to GitLab or GitHub account.</p> <p>Warning</p> <p>Use an additional GitHub/GitLab User to access a repository. For example: - GitHub, add a User to a repository with a \"Read\" role. - GitLab, add a User to a repository with a \"Guest\" role.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\" -f argocd\n</code></pre> <p>Copy SSH private key to Argo CD namespace</p> <pre><code>EDP_NAMESPACE=&lt;EDP_NAMESPACE&gt;\nVCS_HOST=\"&lt;github.com_or_gitlab.com&gt;\"\nACCOUNT_NAME=\"&lt;ACCOUNT_NAME&gt;\"\nURL=\"ssh://git@${VCS_HOST}:22/${ACCOUNT_NAME}\"\n\nkubectl create secret generic ${EDP_NAMESPACE} -n argocd \\\n--from-file=sshPrivateKey=argocd \\\n--from-literal=url=\"${URL}\"\nkubectl label --overwrite secret ${EDP_NAMESPACE} -n argocd \"argocd.argoproj.io/secret-type=repo-creds\"\n</code></pre> <p>Add public SSH key to GitHub/GitLab account.</p> </li> <li> <p>Add SSH Known hosts    for Gerrit, GitHub, GitLab integration.</p> GerritGitHub/GitLab <p>Add Gerrit host to Argo CD config map with known hosts</p> <pre><code>EDP_NAMESPACE=&lt;EDP_NAMESPACE&gt;\nKNOWN_HOSTS_FILE=\"/tmp/ssh_known_hosts\"\nARGOCD_KNOWN_HOSTS_NAME=\"argocd-ssh-known-hosts-cm\"\nGERRIT_PORT=$(kubectl get gerrit gerrit -n ${EDP_NAMESPACE} -o jsonpath='{.spec.sshPort}')\n\nrm -f ${KNOWN_HOSTS_FILE}\nkubectl get cm ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd -o jsonpath='{.data.ssh_known_hosts}' &gt; ${KNOWN_HOSTS_FILE}\nkubectl exec -it deployment/gerrit -n ${EDP_NAMESPACE} -- ssh-keyscan -p ${GERRIT_PORT} gerrit.${EDP_NAMESPACE} &gt;&gt; ${KNOWN_HOSTS_FILE}\nkubectl create configmap ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd --from-file ${KNOWN_HOSTS_FILE} -o yaml --dry-run=client | kubectl apply -f -\n</code></pre> <p>Add GitHub/GitLab host to Argo CD config map with known hosts</p> <pre><code>EDP_NAMESPACE=&lt;EPD_NAMESPACE&gt;\nVCS_HOST=\"&lt;VCS_HOST&gt;\"\nKNOWN_HOSTS_FILE=\"/tmp/ssh_known_hosts\"\nARGOCD_KNOWN_HOSTS_NAME=\"argocd-ssh-known-hosts-cm\"\n\nrm -f ${KNOWN_HOSTS_FILE}\nkubectl get cm ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd -o jsonpath='{.data.ssh_known_hosts}' &gt; ${KNOWN_HOSTS_FILE}\nssh-keyscan ${VCS_HOST} &gt;&gt; ${KNOWN_HOSTS_FILE}\nkubectl create configmap ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd --from-file ${KNOWN_HOSTS_FILE} -o yaml --dry-run=client | kubectl apply -f -\n</code></pre> </li> <li> <p>Create an Argo CD Project (EDP Tenant), for example, with the <code>team-foo</code> name:</p> AppProject<pre><code>apiVersion: argoproj.io/v1alpha1\nkind: AppProject\nmetadata:\nname: team-foo\nnamespace: argocd\n# Finalizer that ensures that project is not deleted until it is not referenced by any application\nfinalizers:\n- resources-finalizer.argocd.argoproj.io\nspec:\ndescription: CD pipelines for team-foo\nroles:\n- name: developer\ndescription: Users for team-foo tenant\npolicies:\n- p, proj:team-foo:developer, applications, create, team-foo/*, allow\n- p, proj:team-foo:developer, applications, delete, team-foo/*, allow\n- p, proj:team-foo:developer, applications, get, team-foo/*, allow\n- p, proj:team-foo:developer, applications, override, team-foo/*, allow\n- p, proj:team-foo:developer, applications, sync, team-foo/*, allow\n- p, proj:team-foo:developer, applications, update, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, create, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, delete, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, update, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, get, team-foo/*, allow\ngroups:\n# Keycloak Group name\n- ArgoCD-team-foo-users\ndestinations:\n# ensure we can deploy to ns with tenant prefix\n- namespace: 'team-foo-*'\n# allow to deploy to specific server (local in our case)\nserver: https://kubernetes.default.svc\n# Deny all cluster-scoped resources from being created, except for Namespace\nclusterResourceWhitelist:\n- group: ''\nkind: Namespace\n# Allow all namespaced-scoped resources to be created, except for ResourceQuota, LimitRange, NetworkPolicy\nnamespaceResourceBlacklist:\n- group: ''\nkind: ResourceQuota\n- group: ''\nkind: LimitRange\n- group: ''\nkind: NetworkPolicy\n# we are ok to create any resources inside namespace\nnamespaceResourceWhitelist:\n- group: '*'\nkind: '*'\n# enable access only for specific git server. The example below 'team-foo' - it is namespace where EDP deployed\nsourceRepos:\n- ssh://argocd@gerrit.team-foo:30007/*\n# enable capability to deploy objects from namespaces\nsourceNamespaces:\n- team-foo\n</code></pre> </li> <li> <p>Optional: if the Argo CD controller has not been enabled to manage the Application resources in the specific namespaces    (<code>team-foo</code>, in our case) in the Install Argo CD, modify the <code>argocd-cmd-params-cm</code>    ConfigMap in the Argo CD namespace and add the <code>application.namespaces</code> parameter to the subsection data:</p> argocd-cmd-params-cm<pre><code>...\ndata:\napplication.namespaces: team-foo\n...\n</code></pre> values.yaml file<pre><code>...\nconfigs:\nparams:\napplication.namespaces: team-foo\n...\n</code></pre> </li> <li> <p>Check that your new Repository, Known Hosts, and AppProject are added to the Argo CD UI.</p> </li> </ol> <p>Once Argo CD is successfully integrated, EDP user can utilize Argo CD to deploy CD pipelines.</p>"},{"location":"operator-guide/argocd-integration/#check-argo-cd-integration-optional","title":"Check Argo CD Integration (Optional)","text":"<p>This section provides the information on how to test the integration with Argo CD and is not mandatory to be followed.</p> <ol> <li> <p>Follow the Add Application instruction to deploy a test EDP application with the <code>demo</code> name, which should be stored in a Gerrit private repository:</p> Example: Argo CD Application  <pre><code>apiVersion: argoproj.io/v1alpha1\nkind: Application\nmetadata:\nname: demo\nspec:\nproject: team-foo\ndestination:\nnamespace: team-foo-demo\nserver: https://kubernetes.default.svc\nsource:\nhelm:\nparameters:\n- name: image.tag\nvalue: master-0.1.0-1\n- name: image.repository\nvalue: image-repo\npath: deploy-templates\nrepoURL: ssh://argocd@gerrit.team-foo:30007/demo.git\ntargetRevision: master\nsyncPolicy:\nsyncOptions:\n- CreateNamespace=true\nautomated:\nselfHeal: true\nprune: true\n</code></pre> </li> <li> <p>Check that your new Application is added to the Argo CD UI under the <code>team-foo</code> Project scope.</p> </li> </ol>"},{"location":"operator-guide/argocd-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Install Argo CD</li> </ul>"},{"location":"operator-guide/aws-marketplace-install/","title":"Install via AWS Marketplace","text":"<p>This documentation provides the detailed instructions on how to install the EPAM Delivery Platform via the AWS Marketplace.</p> <p>To initiate the installation process, navigate to our dedicated AWS Marketplace page and commence the deployment of EPAM Delivery Platform.</p> <p>Disclaimer</p> <p>EDP is aligned with industry standards for storing and managing sensitive data, ensuring optimal security. However, the use of custom solutions introduces uncertainties, thus the responsibility for the safety of your data is totally covered by platform administrator.</p>"},{"location":"operator-guide/aws-marketplace-install/#prerequisites","title":"Prerequisites","text":"<p>Please familiarize yourself with the Prerequisites page before deploying the product. To perform a minimal installation, ensure that you meet the following requirements:</p> <ul> <li>The domain name is available and associated with the ingress object in cluster.</li> <li>Cluster administrator access.</li> <li>The Tekton resources are deployed.</li> <li>Access to the cluster via Service Account token is available.</li> </ul>"},{"location":"operator-guide/aws-marketplace-install/#deploy-epam-delivery-platform","title":"Deploy EPAM Delivery Platform","text":"<p>To deploy the platform, follow the steps below:</p> <ol> <li> <p>To apply Tekton stack, deploy Tekton resources by executing the command below:</p> <pre><code> kubectl create ns tekton-pipelines\n kubectl create ns tekton-chains\n kubectl create ns tekton-pipelines-resolvers\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/latest/release.yaml\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/latest/interceptors.yaml\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/pipeline/latest/release.yaml\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/chains/latest/release.yaml\n</code></pre> </li> <li> <p>Define the mandatory parameters you would like to use for installation using the following command:</p> <pre><code> kubectl create ns edp\n helm install edp-install \\\n--namespace edp ./* \\\n--set global.dnsWildCard=example.com \\\n--set awsRegion=&lt;AWS_REGION&gt;\n</code></pre> </li> <li> <p>(Optional) Provide token to sign in to EDP Portal. Run the following command to create Service Account with cluster admin permissions:</p> <pre><code>kubectl create serviceaccount edp-admin -n edp\nkubectl create clusterrolebinding edp-cluster-admin --clusterrole=cluster-admin --serviceaccount=edp:edp-admin\nkubectl apply -f - &lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: edp-admin-token\n  namespace: edp\n  annotations:\n    kubernetes.io/service-account.name: edp-admin\ntype: kubernetes.io/service-account-token\nEOF\n</code></pre> </li> <li> <p>(Optional) To get access to EDP Portal, run the port-forwarding command:</p> <pre><code> kubectl port-forward service/edp-headlamp 59480:80 -n edp\n</code></pre> </li> <li> <p>(Optional) To open EDP Portal, navigate to the <code>http://localhost:59480</code>.</p> </li> <li> <p>(Optional) To get admin token to sign in to EDP Portal:</p> <pre><code>kubectl get secrets -o jsonpath=\"{.items[?(@.metadata.annotations['kubernetes\\.io/service-account\\.name']=='edp-admin')].data.token}\" -n edp|base64 --decode\n</code></pre> </li> </ol> <p>As a result, you will get access to EPAM Delivery Platform components via EDP Portal UI. Navigate to our Use Cases to try out EDP functionality. Visit other subsections of the Operator Guide to figure out how to configure EDP and integrate it with various tools.</p>"},{"location":"operator-guide/aws-marketplace-install/#related-articles","title":"Related Articles","text":"<ul> <li>EPAM Delivery Platform on AWS Marketplace</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Set Up Kubernetes</li> <li>Set Up OpenShift</li> <li>EDP Installation Prerequisites Overview</li> <li>Headlamp OIDC Integration</li> </ul>"},{"location":"operator-guide/capsule/","title":"Capsule Integration","text":"<p>This documentation guide provides comprehensive instructions of integrating Capsule with the EPAM Delivery Platform to enhance security and resource management.</p> <p>Note</p> <p>When integrating the EPAM Delivery Platform with Capsule, it's essential to understand that the platform needs administrative rights to make and oversee resources. This requirement might raise security concerns, but it's important to clarify that it only pertains to the deployment process within the platform. There is an alternative approach available. You can manually create permissions for each deployment flow. This alternative method can be used to address and lessen these security concerns.</p>"},{"location":"operator-guide/capsule/#installation","title":"Installation","text":"<p>To install the Capsule tool, use the Cluster Add-Ons approach. For more details, please refer to the Capsule official page.</p>"},{"location":"operator-guide/capsule/#configuration","title":"Configuration","text":"<p>To use Capsule in EDP, follow the steps below:</p> <ol> <li> <p>Run the command below to upgrade EDP with Capsule capabilities:</p> <pre><code>helm upgrade --install edp epamedp/edp-install -n edp --values values.yaml --set cd-pipeline-operator.tenancyEngine=capsule\n</code></pre> </li> <li> <p>Open the <code>CapsuleConfiguration</code> custom resource called <code>default</code>:</p> <pre><code>kubectl edit CapsuleConfiguration default\n</code></pre> <p>Add the tenant name (by default, it's the EDP namespace name) to the manifest's spec section as follows:</p> <pre><code>spec:\nuserGroups:\n- system:serviceaccounts:edp\n</code></pre> </li> </ol> <p>As a result, EDP will be using Capsule capabilities to manage tenants, thus providing better access management.</p>"},{"location":"operator-guide/capsule/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP With Values File</li> <li>Cluster Add-Ons Overview</li> <li>Set Up Kiosk</li> <li>EDP Kiosk Usage</li> </ul>"},{"location":"operator-guide/configure-keycloak-oidc-eks/","title":"EKS OIDC With Keycloak","text":"<p>This article provides the instruction of configuring Keycloak as OIDC Identity Provider for EKS. The example is written on Terraform (HCL).</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#prerequisites","title":"Prerequisites","text":"<p>To follow the instruction, check the following prerequisites:</p> <ol> <li>terraform 0.14.10</li> <li>hashicorp/aws = 4.8.0</li> <li>mrparkers/keycloak &gt;= 3.0.0</li> <li>hashicorp/kubernetes ~&gt; 2.9.0</li> <li>kubectl = 1.22</li> <li>kubelogin  &gt;= v1.25.1</li> <li>Ensure that Keycloak has network availability for AWS (not in a private network).</li> </ol> <p>Note</p> <p>To connect OIDC with a cluster, install and configure the kubelogin plugin. For Windows, it is recommended to download the kubelogin as a binary and add it to your PATH.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#solution-overview","title":"Solution Overview","text":"<p>The solution includes three types of the resources - AWS (EKS), Keycloak, Kubernetes. The left part of Keycloak resources remain unchanged after creation, thus allowing us to associate a claim for a user group membership. Other resources can be created, deleted or changed if needed. The most crucial from Kubernetes permissions are Kubernetes RoleBindings and ClusterRoles/Roles. Roles present a set of permissions, in turn RoleBindings map Kubernetes Role to representative Keycloak groups, so a group member can have just appropriate permissions.</p> <p> EKS Keycloak OIDC </p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#keycloak-configuration","title":"Keycloak Configuration","text":"<p>To configure Keycloak, follow the steps described below.</p> <ul> <li>Create a client:</li> </ul> <pre><code>resource \"keycloak_openid_client\" \"openid_client\" {\nrealm_id                                  = \"openshift\"\nclient_id                                 = \"kubernetes\"\naccess_type                               = \"CONFIDENTIAL\"\nstandard_flow_enabled                     = true\nimplicit_flow_enabled                     = false\ndirect_access_grants_enabled              = true\nservice_accounts_enabled                  = true\noauth2_device_authorization_grant_enabled = true\nbackchannel_logout_session_required       = true\n\nroot_url    = \"http://localhost:8000/\"\nbase_url    = \"http://localhost:8000/\"\nadmin_url   = \"http://localhost:8000/\"\nweb_origins = [\"*\"]\n\nvalid_redirect_uris = [\n\"http://localhost:8000/*\"\n]\n}\n</code></pre> <ul> <li>Create the client scope:</li> </ul> <pre><code>resource \"keycloak_openid_client_scope\" \"openid_client_scope\" {\nrealm_id               = &lt;realm_id&gt;\nname                   = \"groups\"\ndescription            = \"When requested, this scope will map a user's group memberships to a claim\"\ninclude_in_token_scope = true\nconsent_screen_text    = false\n}\n</code></pre> <ul> <li>Add scope to the client by selecting all default client scope:</li> </ul> <pre><code>resource \"keycloak_openid_client_default_scopes\" \"client_default_scopes\" {\nrealm_id  = &lt;realm_id&gt;\nclient_id = keycloak_openid_client.openid_client.id\n\ndefault_scopes = [\n\"profile\",\n\"email\",\n\"roles\",\n\"web-origins\",\nkeycloak_openid_client_scope.openid_client_scope.name,\n]\n}\n</code></pre> <ul> <li>Add the following mapper to the client scope:</li> </ul> <pre><code>resource \"keycloak_openid_group_membership_protocol_mapper\" \"group_membership_mapper\" {\nrealm_id            = &lt;realm_id&gt;\nclient_scope_id     = keycloak_openid_client_scope.openid_client_scope.id\nname                = \"group-membership-mapper\"\nadd_to_id_token     = true\nadd_to_access_token = true\nadd_to_userinfo     = true\nfull_path           = false\n\nclaim_name = \"groups\"\n}\n</code></pre> <ul> <li>In the authorization token, get groups membership field with the list of group membership in the realm: <pre><code>...\n\"email_verified\": false,\n\"name\": \"An User\",\n\"groups\": [\n\"&lt;env_prefix_name&gt;-oidc-viewers\",\n\"&lt;env_prefix_name&gt;-oidc-cluster-admins\"\n],\n\"preferred_username\": \"an_user@example.com\",\n\"given_name\": \"An\",\n\"family_name\": \"User\",\n\"email\": \"an_user@example.com\"\n...\n</code></pre></li> </ul> <ul> <li>Create group/groups, e.g. admin group:</li> </ul> <pre><code>resource \"keycloak_group\" \"oidc_tenant_admin\" {\nrealm_id = &lt;realm_id&gt;\nname     = \"kubernetes-oidc-admins\"\n}\n</code></pre>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#eks-configuration","title":"EKS Configuration","text":"<p>To configure EKS, follow the steps described below. In AWS Console, open EKS home page -&gt; Choose a cluster -&gt; Configuration tab -&gt; Authentication tab.</p> <p>The Terraform code for association with Keycloak:</p> <ul> <li>terraform.tfvars <pre><code>...\ncluster_identity_providers = {\nkeycloak = {\nclient_id                     = &lt;keycloak_client_id&gt;\nidentity_provider_config_name = \"Keycloak\"\nissuer_url                    = \"https://&lt;keycloak_url&gt;/auth/realms/&lt;realm_name&gt;\"\ngroups_claim                  = \"groups\"\n}\n...\n</code></pre></li> <li>the resource code <pre><code>resource \"aws_eks_identity_provider_config\" \"keycloak\" {\nfor_each = { for k, v in var.cluster_identity_providers : k =&gt; v if true }\n\ncluster_name = var.platform_name\n\noidc {\nclient_id                     = each.value.client_id\ngroups_claim                  = lookup(each.value, \"groups_claim\", null)\ngroups_prefix                 = lookup(each.value, \"groups_prefix\", null)\nidentity_provider_config_name = try(each.value.identity_provider_config_name, each.key)\nissuer_url                    = each.value.issuer_url\nrequired_claims               = lookup(each.value, \"required_claims\", null)\nusername_claim                = lookup(each.value, \"username_claim\", null)\nusername_prefix               = lookup(each.value, \"username_prefix\", null)\n}\n\ntags = var.tags\n}\n</code></pre></li> </ul> <p>Note</p> <p>The resource creation takes around 20-30 minutes. The resource doesn't support updating, so each change will lead to deletion of the old instance and creation of a new instance instead.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#kubernetes-configuration","title":"Kubernetes Configuration","text":"<p>To connect the created Keycloak resources with permissions, it is necessary to create Kubernetes Roles and RoleBindings:</p> <ul> <li>ClusterRole <pre><code>resource \"kubernetes_cluster_role_v1\" \"oidc_tenant_admin\" {\nmetadata {\nname = \"oidc-admin\"\n}\nrule {\napi_groups = [\"*\"]\nresources  = [\"*\"]\nverbs      = [\"*\"]\n}\n}\n</code></pre></li> <li>ClusterRoleBinding <pre><code>resource \"kubernetes_cluster_role_binding_v1\" \"oidc_cluster_rb\" {\nmetadata {\nname = \"oidc-cluster-admin\"\n}\nrole_ref {\napi_group = \"rbac.authorization.k8s.io\"\nkind      = \"ClusterRole\"\nname      = kubernetes_cluster_role_v1.oidc_tenant_admin.metadata[0].name\n}\nsubject {\nkind      = \"Group\"\nname      = keycloak_group.oidc_tenant_admin.name\napi_group = \"rbac.authorization.k8s.io\"\n    # work-around due https://github.com/hashicorp/terraform-provider-kubernetes/issues/710\nnamespace = \"\"\n}\n}\n</code></pre></li> </ul> <p>Note</p> <p>When creating the Keycloak group, ClusterRole, and ClusterRoleBinding, a user receives cluster admin permissions. There is also an option to provide admin permissions just to a particular namespace or another resources set in another namespace. For details, please refer to the Mixing Kubernetes Roles page.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#kubeconfig","title":"Kubeconfig","text":"<p>Template for kubeconfig:</p> <p><pre><code>apiVersion: v1\npreferences: {}\nkind: Config\n\nclusters:\n- cluster:\nserver: https://&lt;eks_url&gt;.eks.amazonaws.com\ncertificate-authority-data: &lt;certificate_authority_data&gt;\nname: &lt;cluster_name&gt;\n\ncontexts:\n- context:\ncluster: &lt;cluster_name&gt;\nuser: &lt;keycloak_user_email&gt;\nname: &lt;cluster_name&gt;\n\ncurrent-context: &lt;cluster_name&gt;\n\nusers:\n- name: &lt;keycloak_user_email&gt;\nuser:\nexec:\napiVersion: client.authentication.k8s.io/v1beta1\ncommand: kubectl\nargs:\n- oidc-login\n- get-token\n- -v1\n- --oidc-issuer-url=https://&lt;keycloak_url&gt;/auth/realms/&lt;realm&gt;\n- --oidc-client-id=&lt;keycloak_client_id&gt;\n- --oidc-client-secret=&lt;keycloak_client_secret&gt;\n</code></pre> Flag -v1 can be used for debug, in a common case it's not needed and can be deleted.</p> <p>To find the client secret:</p> <ol> <li>Open Keycloak</li> <li>Choose realm</li> <li>Find keycloak_client_id that was previously created</li> <li>Open Credentials tab</li> <li>Copy Secret</li> </ol>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#testing","title":"Testing","text":"<p>Before testing, ensure that a user is a member of the correct Keycloak group. To add a user to a Keycloak group:</p> <ol> <li>Open Keycloak</li> <li>Choose realm</li> <li>Open user screen with search field</li> <li>Find a user and open the configuration</li> <li>Open Groups tab</li> <li>In Available Groups, choose an appropriate group</li> <li>Click the Join button</li> <li>The group should appear in the Group Membership list</li> </ol> <p>Follow the steps below to test the configuration:</p> <ul> <li>Run kubectl command, it is important to specify the correct kubeconfig: <pre><code>KUBECONFIG=&lt;path_to_oidc_kubeconfig&gt; kubectl get ingresses -n &lt;namespace_name&gt;\n</code></pre></li> <li>After the first run and redirection to the Keycloak login page, log in using credentials (login:password) or using SSO Provider. In case of the successful login, you will receive the following notification that can be closed:</li> </ul> <p> OIDC Successful Login </p> <ul> <li>As the result, a respective response from the Kubernetes will appear in the console in case a user is configured correctly and is a member of the correct group and Roles/RoleBindings.</li> </ul> <ul> <li>If something is not set up correctly, the following output error will be displayed: <pre><code>Error from server (Forbidden): ingresses.networking.k8s.io is forbidden:\nUser \"https://&lt;keycloak_url&gt;/auth/realms/&lt;realm&gt;#&lt;keycloak_user_id&gt;\"\ncannot list resource \"ingresses\" in API group \"networking.k8s.io\" in the namespace \"&lt;namespace_name&gt;\"\n</code></pre></li> </ul>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#session-update","title":"Session Update","text":"<p>To update the session, clear cache. The default location for the login cache:</p> <pre><code>rm -rf ~/.kube/cache\n</code></pre>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#access-cluster-via-lens","title":"Access Cluster via Lens","text":"<p>To access the Kubernetes cluster via Lens, follow the steps below to configure it:</p> <ul> <li>Add a new kubeconfig to the location where Lens has access. The default location of the kubeconfig is ~/.kube/config but it can be changed by navigating to File -&gt; Preferences -&gt; Kubernetes -&gt; Kubeconfig Syncs;</li> <li>(Optional) Using Windows, it is recommended to reboot the system after adding a new kubeconfig.</li> <li>Authenticate on the Keycloak login page to be able to access the cluster;</li> </ul> <p>Note</p> <p>Lens does not add namespaces of the project automatically, so it is necessary to add them manually, simply go to Settings -&gt; Namespaces and add the namespaces of a project.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#related-articles","title":"Related Articles","text":"<ul> <li>Headlamp OIDC Configuration</li> </ul>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/","title":"Integrate Harbor With EDP Pipelines","text":"<p>Harbor serves as a tool for storing images and artifacts. This documentation contains instructions on how to create a project in Harbor and set up a robot account for interacting with the registry from CI pipelines.</p>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#overview","title":"Overview","text":"<p>Harbor integration with Tekton enables the centralized storage of container images within the cluster, eliminating the need for external services. By leveraging Harbor as the container registry, users can manage and store their automation results and reports in one place.</p>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#integration-procedure","title":"Integration Procedure","text":"<p>The integration process involves two steps:</p> <ol> <li> <p>Creating a project to store application images.</p> </li> <li> <p>Creating two accounts with different permissions to push (read/write) and pull (read-only) project images.</p> </li> </ol>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#create-new-project","title":"Create New Project","text":"<p>The process of creating new projects is the following:</p> <ol> <li>Log in to the Harbor console using your credentials.</li> <li> <p>Navigate to the Projects menu, click the New Project button:</p> <p> Projects menu </p> </li> <li> <p>On the New Project menu, enter a project name that matches your EDP namespace in the Project Name field. Keep other fields as default and click OK to continue:</p> <p> New Project menu </p> </li> </ol>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#set-up-robot-account","title":"Set Up Robot Account","text":"<p>To make EDP and Harbor project interact with each other, set up a robot account:</p> <ol> <li> <p>Navigate to your newly created project, select Robot Accounts menu and choose New Robot Account:</p> <p> Create Robot Account menu </p> </li> <li> <p>In the pop-up window, fill in the fields as follows:</p> <ul> <li>Name - <code>edp-push</code>;</li> <li>Expiration time -  set the value which is aligned with your organization policy;</li> <li>Description - <code>read/write permissions</code>;</li> <li>Permissions - <code>Pull Repository</code> and <code>Push Repository</code>.</li> </ul> <p>To proceed, click the ADD button:</p> <p> Robot Accounts menu </p> </li> <li> <p>In the appeared window, copy the robot account credentials or click the Export to file button to save the secret and account name locally:</p> <p> New credentials for Robot Account </p> </li> <li> <p>Provision the kaniko-docker-config secrets using kubectl, EDP Portal or with the externalSecrets operator:</p> <p>Example</p> <p>The <code>auth</code> string can be generated by this command: <pre><code>echo -n \"robot\\$edp-project+edp:secret\" | base64\n</code></pre></p> kubectlManual SecretExternal Secrets Operator <pre><code>  apiVersion: v1\nkind: Secret\nmetadata:\nname: kaniko-docker-config\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: registry\ntype: kubernetes.io/dockerconfigjson\nstringData:\n.dockerconfigjson: |\n{\n\"auths\" : {\n\"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Fill in the required fields and click <code>Save</code>.</p> <p> Registry update manual secret </p> <pre><code>\"kaniko-docker-config\":\n{\"auths\" : \"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Here, you will observe the <code>Managed by ExternalSecret</code> message:</p> <p> Registry managed by external secret operator </p> <p>Note</p> <p>More details of External Secrets Operator Integration can be found in the External Secrets Operator Integration page.</p> </li> <li> <p>Repeat steps 2-3 with values below:</p> <ul> <li>Name - <code>edp-pull</code>;</li> <li>Expiration time -  set the value which is aligned with your organization policy;</li> <li>Description - <code>read-only permissions</code>;</li> <li>Permissions - <code>Pull Repository</code>.</li> </ul> </li> <li> <p>Provision the regcred secrets using kubectl, EDP Portal or with the externalSecrets operator:</p> <p>Example</p> <p>The <code>auth</code> string can be generated by this command: <pre><code>echo -n \"robot\\$edp-project+edp-push:secret\" | base64\n</code></pre></p> kubectlManual SecretExternal Secrets Operator <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: regcred\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: registry\ntype: kubernetes.io/dockerconfigjson\nstringData:\n.dockerconfigjson: |\n{\n\"auths\" : {\n\"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Fill in the required fields and click Save.</p> <p> Registry update manual secret </p> <pre><code>\"regcred\":\n{\"auths\" : \"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Here, you will observe the <code>Managed by ExternalSecret</code> message:</p> <p> Registry managed by external secret operator </p> <p>Note</p> <p>More details of External Secrets Operator Integration can be found in the External Secrets Operator Integration page.</p> </li> <li> <p>In the values.yaml file for the edp-install Helm chart, set the following values for the specified fields:</p> Manual SecretExternal Secrets Operator <p>If the <code>kaniko-docker-config</code> secret has been created manually:</p> values.yaml<pre><code>...\nkaniko:\nexistingDockerConfig: \"kaniko-docker-config\"\nglobal:\ndockerRegistry:\nurl: harbor-registry.com\ntype: \"harbor\"\n...\n</code></pre> <p>If the <code>kaniko-docker-config</code> secret has been created via External Secrets Operator:</p> values.yaml<pre><code>...\nkaniko:\nexistingDockerConfig: \"kaniko-docker-config\"\nexternalSecrets:\nenabled: true\nglobal:\ndockerRegistry:\nurl: harbor-registry.com\ntype: \"harbor\"\n...\n</code></pre> </li> <li> <p>(Optional)  If you've already deployed the EDP Helm chart, you can update it using the following command:</p> <pre><code>helm update --install edp epamedp/edp-install \\\n--values values.yaml \\\n--namespace edp\n</code></pre> </li> </ol> <p>As a result, application images built in EDP Portal will be stored in Harbor project and will be deployed from the harbor registry.</p> <p>Harbor projects can be added and retained with a retention policy generated through the EDP script in edp-cluster-add-ons.</p>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Harbor</li> <li>Adjust Jira Integration</li> <li>Custom SonarQube Integration</li> </ul>"},{"location":"operator-guide/delete-edp/","title":"Uninstall EDP","text":"<p>This tutorial provides detailed instructions on the optimal method to uninstall the EPAM Delivery Platform.</p>"},{"location":"operator-guide/delete-edp/#deletion-procedure","title":"Deletion Procedure","text":"<p>To uninstall EDP, perform the following steps:</p> <ol> <li> <p>It is highly recommended to delete all the resources created via EDP Portal UI first. It can be:</p> <ul> <li>Applications;</li> <li>Libraries;</li> <li>Autotests;</li> <li>Infrastructures;</li> <li>CD Pipelines.</li> </ul> <p>We recommend deleting them via EDP Portal UI respectively, although it is also possible to delete all the EDP Portal resources using the <code>kubectl delete</code> command.</p> </li> <li> <p>Delete application namespaces. They should be called according to the <code>edp-&lt;cd-pipeline&gt;-&lt;stage-name&gt;</code> pattern.</p> </li> <li> <p>Uninstall EDP the same way it was installed.</p> </li> <li> <p>Run the script that deletes the rest of the custom resources:</p> View: CleanEDP.sh <pre><code>#!/bin/sh\n\n###################################################################\n# A POSIX script to remove EDP Kubernetes Custom Resources        #\n#                                                                 #\n# PREREQUISITES                                                   #\n#     kubectl&gt;=1.23.x, awscli (for EKS authentication)            #\n#                                                                 #\n# TESTED                                                          #\n#     OS: Ubuntu, FreeBSD, Windows (GitBash)                      #\n#     Shells: zsh, bash, dash                                     #\n###################################################################\n\n[ -n \"${DEBUG}\" ] &amp;&amp; set -x\n\nset -e\n\nexit_err() {\nprintf '%s\\n' \"$1\" &gt;&amp;2\nexit 1\n}\n\ncheck_kubectl() {\nif ! hash kubectl; then\nexit_err \"Error: kubectl is not installed\"\nfi\n}\n\nget_script_help() {\nself_name=\"$(basename \"$0\")\"\necho \"\\\n${self_name} deletes EDP Kubernetes Custom Resources\n\nUsage: ${self_name}\n\nOptions:\n${self_name} [OPTION] [FILE]\n\n-h, --help          Print Help\n-k, --kubeconfig    Pass Kubeconfig file\n\nDebug:\nDEBUG=true ${self_name}\n\nExamples:\n${self_name} --kubeconfig ~/.kube/custom_config\"\n}\n\nyellow_fg() {\ntput setaf 3 || true\n}\n\nno_color_out() {\ntput sgr0 || true\n}\n\nget_current_context() {\nkubectl config current-context\n}\n\nget_context_ns() {\nkubectl config view \\\n--minify --output jsonpath='{..namespace}' 2&gt; /dev/null\n}\n\nget_ns() {\nkubectl get ns \"${edp_ns}\" --output name --request-timeout='5s'\n}\n\ndelete_ns() {\nkubectl delete ns \"${edp_ns}\" --timeout='30s'\n}\n\nget_edp_crds() {\nkubectl get crds --no-headers=true | awk '/edp.epam.com/ {print $1}'\n}\n\nget_all_edp_crs_manif() {\nkubectl get \"${edp_crds_comma_list}\" -n \"${edp_ns}\" \\\n--output yaml --ignore-not-found --request-timeout='15s'\n}\n\ndel_all_edp_crs() {\nkubectl delete --all \"${edp_crds_comma_list}\" -n \"${edp_ns}\" \\\n--ignore-not-found --timeout='15s'\n}\n\niterate_edp_crs() {\nedp_crds_comma_list=\"$(printf '%s' \"${edp_crds}\" | tr -s '\\n' ',')\"\nget_all_edp_crs_manif \\\n| sed '/finalizers:/,/.*:/{//!d;}' \\\n| kubectl replace -f - || true\ndel_all_edp_crs || true\n}\n\niterate_edp_crds() {\nn=0\nwhile [ \"$n\" -lt 2 ]; do\nn=$((n + 1))\n\nif [ \"$n\" -eq 2 ]; then\n# Delete remaining resources\nedp_crds=\"keycloakclients,codebasebranches,jenkinsfolders\"\niterate_edp_crs\necho \"EDP Custom Resources in NS ${color_ns} have been deleted.\"\nbreak\nfi\n\necho \"Replacing EDP CR Manifests. Wait for output (may take 2min)...\"\nedp_crds=\"$(get_edp_crds)\"\niterate_edp_crs\ndone\n}\n\nselect_ns() {\nis_context=\"$(get_current_context)\" || exit 1\nprintf '%s' \"Current cluster: \"\nprintf '%s\\n' \"$(yellow_fg)${is_context}$(no_color_out)\"\n\ncurrent_ns=\"$(get_context_ns)\" || true\n\nprintf '%s\\n' \"Enter EDP namespace\"\nprintf '%s' \"Skip to use [$(yellow_fg)${current_ns}$(no_color_out)]: \"\nread -r edp_ns\n\nif [ -z \"${edp_ns}\" ]; then\nedp_ns=\"${current_ns}\"\necho \"${edp_ns}\"\nif [ -z \"${edp_ns}\" ]; then\nexit_err \"Error: namespace is not specified\"\nfi\nelse\nget_ns || exit 1\nfi\n\ncolor_ns=\"$(yellow_fg)${edp_ns}$(no_color_out)\"\n}\n\nchoose_delete_ns() {\nprintf '%s\\n' \"Do you want to delete namespace ${color_ns} as well? (y/n)?\"\nprintf '%s' \"Skip or enter [N/n] to keep the namespace: \"\nread -r answer\nif [ \"${answer}\" != \"${answer#[Yy]}\" ]; then\ndelete_edp_ns=true\necho \"Namespace ${color_ns} is marked for deletion.\"\nelse\necho \"Skipped. Deleting EDP Custom Resources only.\"\nfi\n}\n\ndelete_ns_if_true() {\nif [ \"${delete_edp_ns}\" = true ]; then\necho \"Deleting ${color_ns} namespace...\"\ndelete_ns || exit 1\nfi\n}\n\ninvalid_option() {\nexit_err \"Invalid option '$1'. Use -h, --help for details\"\n}\n\nmain_func() {\ncheck_kubectl\nselect_ns\nchoose_delete_ns\niterate_edp_crds\ndelete_ns_if_true\n}\n\nwhile [ \"$#\" -gt 0 ]; do\ncase \"$1\" in\n-h | --help)\nget_script_help\nexit 0\n;;\n-k | --kubeconfig)\nshift\n[ $# = 0 ] &amp;&amp; exit_err \"No Kubeconfig file specified\"\nexport KUBECONFIG=\"$1\"\n;;\n--)\nbreak\n;;\n-k* | --k*)\necho \"Did you mean '--kubeconfig'?\"\ninvalid_option \"$1\"\n;;\n-* | *)\ninvalid_option \"$1\"\n;;\nesac\nshift\ndone\n\nmain_func\n</code></pre> <p>The script will prompt user to specify the namespace where EDP was deployed in and choose if the namespace is going to be deleted. This script will delete EDP custom resources in the namespace specified by user.</p> </li> <li> <p>In Keycloak, delete the <code>edp-main</code> realm, also delete client which is supposed to be called by the <code>edp-main</code> pattern in the openshift realm.</p> </li> </ol>"},{"location":"operator-guide/delete-edp/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install EDP via Helmfile</li> <li>Keycloak Integration</li> </ul>"},{"location":"operator-guide/delete-jenkins-job-provision/","title":"Delete Jenkins Job Provision","text":"<p>To delete the job provisioner, take the following steps:</p> <ol> <li> <p>Delete the job provisioner from Jenkins. Navigate to Admin Console-&gt;Jenkins-&gt;jobs-&gt;job-provisions folder, select the necessary provisioner and click the drop-down right to the provisioner name. Select Delete project.</p> <p> Delete job provisioner </p> </li> </ol>"},{"location":"operator-guide/dependency-track/","title":"Install DependencyTrack","text":"<p>This documentation guide provides comprehensive instructions for installing and integrating DependencyTrack with the EPAM Delivery Platform.</p>"},{"location":"operator-guide/dependency-track/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/dependency-track/#installation","title":"Installation","text":"<p>To install DependencyTrack use EDP addons approach.</p>"},{"location":"operator-guide/dependency-track/#configuration","title":"Configuration","text":"<ol> <li> <p>Open <code>Administration</code> -&gt; <code>Access Management</code> -&gt; <code>Teams</code>. Click <code>Create Team</code> -&gt; <code>Automation</code> and click <code>Create</code>.</p> </li> <li> <p>Click <code>+</code> in <code>Permissions</code> and add:</p> <pre><code>BOM_UPLOAD\nPROJECT_CREATION_UPLOAD\nVIEW_PORTFOLIO\n</code></pre> </li> <li> <p>Click <code>+</code> in <code>API keys</code> to create token:</p> </li> </ol> <p> DependencyTrack settings </p> <ol> <li>Provision secrets using manifest, EDP Portal, or with the externalSecrets operator:</li> </ol> manifestEDP Portal UIExternal Secrets Operator <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-dependency-track\nnamespace: &lt;edp&gt;\nlabels:\napp.edp.epam.com/secret-type: dependency-track\nstringData:\ntoken: &lt;dependency-track-token&gt;\nurl: &lt;dependency-track-api-url&gt;\ntype: Opaque\n</code></pre> <p>Go to the <code>EDP Portal UI</code> open <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>DependencyTrack</code> apply <code>Token</code> and <code>URL</code> click the <code>save</code> button.</p> <p> DependencyTrack update manual secret </p> <p>Store DependencyTrack URL and Token in the AWS Parameter Store with the following format: <pre><code>\"ci-dependency-track\":\n{\n\"token\": \"XXXXXXXXXXXX\",\n\"url\": \"https://dependency-track.example.com\"\n}\n</code></pre></p> <p>Go to the <code>EDP Platform UI</code> open <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>DependencyTrack</code> see the <code>Managed by External Secret</code>.</p> <p> DependencyTrack managed by external secret operator </p> <p>More detail on External Secrets Operator Integration can be found on the following page</p> <p>After following the instructions provided, you should be able to integrate your DependencyTrack with the EPAM Delivery Platform.</p>"},{"location":"operator-guide/dependency-track/#related-articles","title":"Related Articles","text":"<ul> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Cluster Add-Ons Overview</li> </ul>"},{"location":"operator-guide/deploy-aws-eks/","title":"Deploy AWS EKS Cluster","text":"<p>This instruction provides detailed information on the Amazon Elastic Kubernetes Service cluster deployment and contains the additional setup such as Argo CD installation and EDP addons usage for the infrastructure management.</p>"},{"location":"operator-guide/deploy-aws-eks/#prerequisites","title":"Prerequisites","text":"<p>Before the EKS cluster deployment and configuration, make sure to check the prerequisites. Install the required tools listed below:</p> <ul> <li>Git</li> <li>Terraform</li> <li>AWS CLI</li> <li>tfenv</li> </ul> <p>To check the correct tools installation, run the following commands:</p> <pre><code>git --version\nterraform version\naws --version\ntfenv --version\n</code></pre>"},{"location":"operator-guide/deploy-aws-eks/#terraform-backend","title":"Terraform Backend","text":"<p>This step will do the following:</p> <ul> <li>Create S3 bucket with policy to store terraform states.</li> </ul> <ul> <li>Create DynamoDB to support state locking and consistency checking.</li> </ul> <p>To create the required resources, do the following:</p> <ol> <li> <p>Fork and clone git repo with project edp-terraform-aws-platform, rename it in the correspondence with project name.</p> <pre><code>git clone https://github.com/epmd-edp/edp-terraform-aws-platform.git\nmv edp-terraform-aws-platform edp-terraform-aws-platform-edp\ncd edp-terraform-aws-platform-edp/s3-backend\n</code></pre> </li> <li> <p>Fill the input variables for Terraform run in the <code>s3-backend/template.tfvars</code> file, refer to the s3-backend/example.tfvars as an example.</p> <p><pre><code># -- e.g eu-central-1\nregion = \"&lt;REGION&gt;\" # mandatory\n\ntags = {\n\"SysName\"      = \"Terraform-Backend\"\n\"SysOwner\"     = \"owner@example.com\"\n\"Environment\"  = \"EKS-TEST-CLUSTER\"\n} # isn't required\n</code></pre> Find the detailed description of the variables in the s3-backend/variables.tf file.</p> </li> <li> <p>Run Terraform apply. Initialize the backend and apply the changes.</p> <pre><code>terraform init\nterraform apply -var-file=./template.tfvars\n</code></pre> View: Terraform output example <pre><code>Outputs:\n\nterraform_lock_table_dynamodb_id = \"terraform_locks\"\nterraform_states_s3_bucket_name = \"terraform-states-012345678910\"\n</code></pre> </li> <li> <p>(Optional) Commit the local state.</p> <pre><code>git add s3-backend/terraform.tfstate\ngit commit -m \"Terraform state for s3-backend\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-aws-eks/#aws-account-and-iam-roles","title":"AWS Account and IAM Roles","text":"<p>This step will do the following:</p> <ul> <li>Create the AWS IAM role EKSDeployerRole</li> </ul> <ul> <li>Create the AWS IAM role ServiceRoleForEKSWorkerNode</li> </ul> <ul> <li>Create the AWS IAM role AWSServiceRoleEKS</li> </ul> <p>Take the following steps:</p> <ol> <li> <p>Navigate to IAM module directory.</p> <pre><code>cd ../iam\n</code></pre> </li> <li> <p>(Optional) Setup backend for store Terraform states remotely and support state locking and consistency checking via DynamoDB. Insert the missing fields in the file <code>iam/providers.tf</code>.</p> <pre><code>...\nbackend \"s3\" {\nbucket         = \"terraform-states-&lt;ACCOUNT_ID&gt;\"\nkey            = \"&lt;REGION&gt;/&lt;CLUSTER_NAME&gt;/iam/terraform.tfstate\"\nregion         = \"&lt;REGION&gt;\"\nacl            = \"bucket-owner-full-control\"\ndynamodb_table = \"terraform_locks\"\nencrypt        = true\n}\n...\n</code></pre> <p>Note</p> <p>If you plan to work with a local state, then comment out this block (the EDP team does not recommend this approach)</p> </li> <li> <p>Fill in the input variables for Terraform run in the <code>iam/template.tfvars</code> file. Use the iam/example.tfvars as an example. Please find the detailed description of the variables in the iam/variables.tf file.</p> <pre><code># Template file to use as an example to create terraform.tfvars file. Fill the gaps instead of &lt;...&gt;\n# More details on each variable can be found in the variables.tf file\n\n# -- Condition to create or not IAM role for cluster deploy\ncreate_iam_deployer = true\n\n# -- Condition to create or not IAM role for Kaniko deploy\n# -- Need in case if used ECR registry. Create it after deploy EKS CLuster\ncreate_iam_kaniko = false\n\n# -- Worker and Deployer role variables\n\n# -- e.g eu-central-1\nregion = \"&lt;REGION&gt;\" # mandatory\n\n# -- Information about boundary policies\n# -- https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html\niam_permissions_boundary_policy_arn = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:policy/eo_role_boundary\" # mandatory\n\ntags = \"\" # isn't mandatory\n\n# -- Kaniko role variables\n\n# -- More information\n# -- https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers.html\ncluster_oidc_issuer_url = \"https://oidc.eks.&lt;AWS_REGION&gt;.amazonaws.com/id/&lt;AWS_OIDC_ID&gt;\"\n\noidc_provider_arn = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/oidc.eks.&lt;AWS_REGION&gt;.amazonaws.com/id/&lt;AWS_OIDC_ID&gt;\"\n\nnamespace = \"edp\"\n</code></pre> </li> <li> <p>Initialize the backend and apply the changes.</p> <pre><code>terraform init\nterraform apply -var-file=./template.tfvars\n</code></pre> View: Terraform output example <pre><code>Outputs:\n\nkaniko_iam_role_arn = []\nkaniko_iam_role_name = []\ndeployer_iam_role_arn = [\n\"arn:aws:iam::012345678910:role/EKSDeployerRole\",\n]\ndeployer_iam_role_name = [\n\"EKSDeployerRole\",\n]\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-aws-eks/#aws-vpc-configuration-optional","title":"AWS VPC configuration (Optional)","text":"<p>This step will do the following:</p> <ul> <li>Create the AWS VPC</li> </ul> <ul> <li>Create the AWS VPC Subnets for instances and LB</li> </ul> <ul> <li>Create the AWS VPC Routing</li> </ul> <p>Take the following steps:</p> <ol> <li> <p>Navigate to VPC module directory.</p> <pre><code>cd ../vpc\n</code></pre> </li> <li> <p>(Optional) Setup backend for store Terraform states remotely and support state locking and consistency checking via DynamoDB. Insert the missing fields in the file <code>vpc/providers.tf</code>.</p> <pre><code>...\nbackend \"s3\" {\nbucket         = \"terraform-states-&lt;ACCOUNT_ID&gt;\"\nkey            = \"&lt;REGION&gt;/&lt;CLUSTER_NAME&gt;/vpc/terraform.tfstate\"\nregion         = \"&lt;REGION&gt;\"\nacl            = \"bucket-owner-full-control\"\ndynamodb_table = \"terraform_locks\"\nencrypt        = true\n}\n...\n</code></pre> <p>Note</p> <p>If you plan to work with a local state, then comment out this block (the EDP team does not recommend this approach)</p> </li> <li> <p>Fill in the input variables for Terraform run in the <code>vpc/template.tfvars</code> file. Use the vpc/example.tfvars as an example. Please find the detailed description of the variables in the vpc/variables.tf file.</p> <pre><code># -- e.g eu-central-1\nregion   = \"&lt;REGION&gt;\"\n\nrole_arn = \"arn:aws:iam::&lt;ACCOUNT_ID&gt;:role/EKSDeployerRole\"\n\nplatform_name = \"&lt;PLATFORM_NAME&gt;\"\n\n# -- VPC CIDR, e.g. \"10.0.0.0/16\"\nplatform_cidr = \"&lt;PLATFORM_CIDR&gt;\"\n\n# -- VPC Subnets AZs, e.g. [\"eu-central-1a\", \"eu-central-1b\", \"eu-central-1c\"]\nsubnet_azs    = [\"&lt;SUBNET_AZS1&gt;\", \"&lt;SUBNET_AZS2&gt;\"]\n\n# -- Private Subnets CIDR, e.g. [\"10.0.1.0/24\", \"10.0.2.0/24\", \"10.0.3.0/24\"]\nprivate_cidrs = [\"&lt;PRIVATE_CIDRS1&gt;\", \"&lt;PRIVATE_CIDRS2&gt;\"]\n\n# -- Private Subnets CIDR, e.g. [\"10.0.101.0/24\", \"10.0.102.0/24\", \"10.0.103.0/24\"]\npublic_cidrs  = [\"&lt;PUBLIC_CIDRS1&gt;\", \"&lt;PUBLIC_CIDRS2&gt;\"]\n\n# -- Tags for resources, isn't mandatory\ntags = \"\"\n</code></pre> </li> <li> <p>Initialize the backend and apply the changes.</p> <pre><code>terraform init\nterraform apply -var-file=./template.tfvars\n</code></pre> View: Terraform output example <pre><code>Outputs:\n\nprivate_subnets = [\n\"subnet-012345678910\",\n  \"subnet-012345678910\",\n  \"subnet-012345678910\",\n]\npublic_subnets = [\n\"subnet-012345678910\",\n  \"subnet-012345678910\",\n  \"subnet-012345678910\",\n]\nvpc_id = \"vpc-012345678910\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-aws-eks/#deploy-and-preconfigure-aws-eks","title":"Deploy and preconfigure AWS EKS","text":"<p>This step will do the following:</p> <ul> <li>Create the EKS Cluster</li> </ul> <ul> <li>Configure the EKS base configuration</li> </ul> <ul> <li>Deploy base components into EKS cluster</li> </ul> <ul> <li>Instal and configure Argo CD</li> </ul> <ul> <li>Onboard EDP addons on EKS cluster</li> </ul> <p>Take the following steps:</p> <ol> <li> <p>Navigate to EKS module directory.</p> <pre><code>cd ../eks\n</code></pre> </li> <li> <p>(Optional) Setup backend for store Terraform states remotely and support state locking and consistency checking via DynamoDB. Insert the missing fields in the file <code>eks/providers.tf</code>.</p> <pre><code>...\nbackend \"s3\" {\nbucket         = \"terraform-states-&lt;ACCOUNT_ID&gt;\"\nkey            = \"&lt;REGION&gt;/&lt;CLUSTER_NAME&gt;/eks/terraform.tfstate\"\nregion         = \"&lt;REGION&gt;\"\nacl            = \"bucket-owner-full-control\"\ndynamodb_table = \"terraform_locks\"\nencrypt        = true\n}\n...\n</code></pre> <p>Note</p> <p>If you plan to work with a local state, then comment out this block (the EDP team does not recommend this approach)</p> </li> <li> <p>Fill in the input variables for Terraform run in the <code>eks/template.tfvars</code> file. Use the eks/example.tfvars as an example. Please find the detailed description of the variables in the eks/variables.tf file.</p> <pre><code># -- e.g eu-central-1\nregion               = \"&lt;REGION&gt;\"\nplatform_name        = \"&lt;PLATFORM_NAME&gt;\"\nplatform_domain_name = \"&lt;PLATFORM_DNS&gt;\"\n\nrole_arn                      = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/EKSDeployerRole\"\nrole_permissions_boundary_arn = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:policy/eo_role_boundary\"\n\nvpc_id             = \"&lt;VPC_ID&gt;\" # VPC ID\nprivate_subnets_id = []         # EKS must have two subnets.\npublic_subnets_id  = []         # ALB must have two subnets.\n\ninfra_public_security_group_ids = [] # List with security groups\n\n# -- Parameter in AWS Parameter Store that contain data in format \"account:token\" in base64 format\nadd_userdata = &lt;&lt;EOF\nexport TOKEN=$(aws ssm get-parameter --name &lt;PARAMETER_NAME&gt; --query 'Parameter.Value' --region &lt;REGION&gt; --output text)\ncat &lt;&lt;DATA &gt; /var/lib/kubelet/config.json\n{\n  \"auths\":{\n    \"https://index.docker.io/v1/\":{\n      \"auth\":\"$TOKEN\"\n    }\n  }\n}\nDATA\nEOF\n\nspot_instance_types = [] # list with instance types\n\naws_auth_users = [] # -- AWS List users\ntags           = \"\"\n\nenable_argocd = true\n\nargocd_manage_add_ons = true\n\neks_addons_repo_ssh_key_secret_name = \"&lt;AWS_SECRET_MANAGER_KEY&gt;\" # ssh key with add-ons repository\n\nrepo_url = \"&lt;SSH_REPO_URL&gt;\" # repository with add-ons\n\naddons_path = \"&lt;ADD_ONS_FOLDER&gt;\" # path to add-ons folder at repository\n\n# OIDC Identity provider\ncluster_identity_providers = {}\n</code></pre> <p>This section contains variables to configure addons approach. Please find the detailed description about EDP addons.</p> </li> <li> <p>Setup Argo CD for work with addons and store and management cluster applications using the GitOps approach. Fill in the input variables in the file eks/values/argocd-values.yaml.</p> <pre><code>configs:\nssh:\nknownHosts: |\n# -- list of known host in format:\n# [host]:port key-type key\n# Example\n# [ssh.github.com]:443 ssh-rsa qgSdfOuiYhew/+afhQnvjfjhnhnqgSdfOuiYhew/+afhQnvjfjhnhn\n...\nserver:\ningress:\nhosts:\n- \"argocd.example.com\"\n</code></pre> </li> <li> <p>Update local Kubernetes configuration:</p> <pre><code>aws eks update-kubeconfig --region &lt;REGION&gt; --name &lt;CLUSTER_NAME&gt;\n</code></pre> </li> </ol> <p>After following the instructions provided, you should be able to configure AWS and create an EKS cluster with installed base utilities.</p>"},{"location":"operator-guide/deploy-aws-eks/#related-articles","title":"Related Articles","text":"<ul> <li>Cluster Add-Ons Overview</li> <li>Install EDP</li> </ul>"},{"location":"operator-guide/deploy-okd-4.10/","title":"Deploy OKD 4.10 Cluster","text":"<p>This instruction provides detailed information on the OKD 4.10 cluster deployment in the AWS Cloud and contains the additional setup necessary for the managed infrastructure.</p> <p>A full description of the cluster deployment can be found in the official documentation.</p>"},{"location":"operator-guide/deploy-okd-4.10/#prerequisites","title":"Prerequisites","text":"<p>Before the OKD cluster deployment and configuration, make sure to check the prerequisites.</p>"},{"location":"operator-guide/deploy-okd-4.10/#required-tools","title":"Required Tools","text":"<ol> <li> <p>Install the following tools listed below:</p> <ul> <li>AWS CLI</li> <li>OpenShift CLI</li> <li>Lens (optional)</li> </ul> </li> <li> <p>Create the AWS IAM user with the required permissions. Make sure the AWS account is active, and the user doesn't have a permission boundary. Remove any Service Control Policy (SCP) restrictions from the AWS account.</p> </li> <li> <p>Generate a key pair for cluster node SSH access. Please perform the steps below:</p> <ul> <li>Generate the SSH key. Specify the path and file name, such as ~/.ssh/id_ed25519, of the new SSH key. If there is an existing key pair, ensure that the public key is in the ~/.ssh directory.<pre><code>ssh-keygen -t ed25519 -N '' -f &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key identity to the SSH agent for a local user if it has not already been added.<pre><code>eval \"$(ssh-agent -s)\"\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key to the ssh-agent:<pre><code>ssh-add &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> </li> <li> <p>Build the <code>ccoctl</code> tool:</p> <ul> <li>Clone the <code>cloud-credential-operator</code> repository.<pre><code>git clone https://github.com/openshift/cloud-credential-operator.git\n</code></pre> </li> </ul> <ul> <li>Move to the <code>cloud-credential-operator</code> folder and build the <code>ccoctl</code> tool.<pre><code>cd cloud-credential-operator &amp;&amp; git checkout release-4.10\nGO_PACKAGE='github.com/openshift/cloud-credential-operator'\ngo build -ldflags \"-X $GO_PACKAGE/pkg/version.versionFromGit=$(git describe --long --tags --abbrev=7 --match 'v[0-9]*')\" ./cmd/ccoctl\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#prepare-for-the-deployment-process","title":"Prepare for the Deployment Process","text":"<p>Before deploying the OKD cluster, please perform the steps below:</p>"},{"location":"operator-guide/deploy-okd-4.10/#create-aws-resources","title":"Create AWS Resources","text":"<p>Create the AWS resources with the Cloud Credential Operator utility (the <code>ccoctl</code> tool):</p> <ol> <li> <p>Generate the public and private RSA key files that are used to set up the OpenID Connect identity provider for the cluster:</p> <pre><code>./ccoctl aws create-key-pair\n</code></pre> </li> <li> <p>Create an OpenID Connect identity provider and an S3 bucket on AWS:</p> <pre><code>./ccoctl aws create-identity-provider \\\n--name=&lt;NAME&gt; \\\n--region=&lt;AWS_REGION&gt; \\\n--public-key-file=./serviceaccount-signer.public\n</code></pre> <p>where:</p> <ul> <li>NAME - is the name used to tag any cloud resources created for tracking,</li> <li>AWS_REGION - is the AWS region in which cloud resources will be created.</li> </ul> </li> <li> <p>Create the IAM roles for each component in the cluster:</p> <ul> <li> <p>Extract the list of the <code>CredentialsRequest</code> objects from the OpenShift Container Platform release image:</p> <pre><code>oc adm release extract \\\n--credentials-requests \\\n--cloud=aws \\\n--to=./credrequests \\\n--quay.io/openshift-release-dev/ocp-release:4.10.25-x86_64\n</code></pre> <p>Note</p> <p>A version of the openshift-release-dev docker image can be found in the Quay registry.</p> </li> </ul> <ul> <li>Use the <code>ccoctl</code> tool to process all <code>CredentialsRequest</code> objects in the <code>credrequests</code> directory:<pre><code>ccoctl aws create-iam-roles \\\n--name=&lt;NAME&gt; \\\n--region=&lt;AWS_REGION&gt; \\\n--credentials-requests-dir=./credrequests\n--identity-provider-arn=arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;NAME&gt;-oidc.s3.&lt;AWS_REGION&gt;.amazonaws.com\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#create-okd-manifests","title":"Create OKD Manifests","text":"<p>Before deploying the OKD cluster, please perform the steps below:</p> <ol> <li> <p>Download the OKD installer.</p> </li> <li> <p>Extract the installation program:</p> <pre><code>tar -xvf openshift-install-linux.tar.gz\n</code></pre> </li> <li> <p>Download the installation pull secret for any private registry. This pull secret allows to authenticate with the services that are provided by the authorities, including Quay.io, serving the container images for OKD components. For example, here is a pull secret for Docker Hub:</p> The pull secret for the private registry <pre><code>{\n\"auths\":{\n\"https://index.docker.io/v1/\":{\n\"auth\":\"$TOKEN\"\n}\n}\n}\n</code></pre> </li> <li> <p>Create a deployment directory and the install-config.yaml file:</p> <pre><code>mkdir okd-deployment\ntouch okd-deployment/install-config.yaml\n</code></pre> <p>To specify more details about the OKD cluster platform or to modify the values of the required parameters, customize the install-config.yaml file for the AWS. Please see below an example of the customized file:</p> install-config.yaml - OKD cluster\u2019s platform installation configuration file <pre><code>apiVersion: v1\nbaseDomain: &lt;YOUR_DOMAIN&gt;\ncredentialsMode: Manual\ncompute:\n- architecture: amd64\nhyperthreading: Enabled\nname: worker\nplatform:\naws:\nrootVolume:\nsize: 30\nzones:\n- eu-central-1a\ntype: r5.large\nreplicas: 3\ncontrolPlane:\narchitecture: amd64\nhyperthreading: Enabled\nname: master\nplatform:\naws:\nrootVolume:\nsize: 50\nzones:\n- eu-central-1a\ntype: m5.xlarge\nreplicas: 3\nmetadata:\ncreationTimestamp: null\nname: 4-10-okd-sandbox\nnetworking:\nclusterNetwork:\n- cidr: 10.128.0.0/14\nhostPrefix: 23\nmachineNetwork:\n- cidr: 10.0.0.0/16\nnetworkType: OVNKubernetes\nserviceNetwork:\n- 172.30.0.0/16\nplatform:\naws:\nregion: eu-central-1\nuserTags:\nuser:tag: 4-10-okd-sandbox\npublish: External\npullSecret: &lt;PULL_SECRET&gt;\nsshKey: |\n&lt;SSH_KEY&gt;\n</code></pre> <p>where:</p> <ul> <li>YOUR_DOMAIN - is a base domain,</li> <li>PULL_SECRET - is a created pull secret for a private registry,</li> <li>SSH_KEY - is a created SSH key.</li> </ul> </li> <li> <p>Create the required OpenShift Container Platform installation manifests:</p> <pre><code>./openshift-install create manifests --dir okd-deployment\n</code></pre> </li> <li> <p>Copy the manifests generated by the <code>ccoctl</code> tool to the <code>manifests</code> directory created by the installation program:</p> <pre><code>cp ./manifests/* ./okd-deployment/manifests/\n</code></pre> </li> <li> <p>Copy the private key generated in the <code>tls</code> directory by the <code>ccoctl</code> tool to the installation directory:</p> <pre><code>cp -a ./tls ./okd-deployment\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#deploy-the-cluster","title":"Deploy the Cluster","text":"<p>To initialize the cluster deployment, run the following command:</p> <pre><code>./openshift-install create cluster --dir okd-deployment --log-level=info\n</code></pre> <p>Note</p> <p>If the cloud provider account configured on the host does not have sufficient permissions to deploy the cluster, the installation process stops, and the missing permissions are displayed.</p> <p>When the cluster deployment is completed, directions for accessing the cluster are displayed in the terminal, including a link to the web console and credentials for the kubeadmin user. The <code>kubeconfig</code> for the cluster will be located in okd-deployment/auth/kubeconfig.</p> Example output <pre><code>...\nINFO Install complete!\nINFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'\nINFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com\nINFO Login to the console with the user: \"kubeadmin\", and password: \"4vYBz-Ee6gm-ymBZj-Wt5AL\"\nINFO Time elapsed: 36m22s:\n</code></pre> <p>Warning</p> <p>The Ignition config files contain certificates that expire after 24 hours, which are then renewed at that time. Do not turn off the cluster for this time, or you will have to update the certificates manually. See OpenShift Container Platform documentation for more information.</p>"},{"location":"operator-guide/deploy-okd-4.10/#log-into-the-cluster","title":"Log Into the Cluster","text":"<p>To log into the cluster, export the <code>kubeconfig</code>:</p> <pre><code>  export KUBECONFIG=&lt;installation_directory&gt;/auth/kubeconfig\n</code></pre> <p>Optionally, use the Lens tool for further work with the Kubernetes cluster.</p> <p>Note</p> <p>To install and manage the cluster, refer to Lens documentation.</p>"},{"location":"operator-guide/deploy-okd-4.10/#manage-okd-cluster-without-the-inbound-rules","title":"Manage OKD Cluster Without the Inbound Rules","text":"<p>In order to manage the OKD cluster without the <code>0.0.0.0/0</code> inbound rules, please perform the steps below:</p> <ol> <li> <p>Create a Security Group with a list of your external IPs:</p> <pre><code>aws ec2 create-security-group --group-name &lt;SECURITY_GROUP_NAME&gt; --description \"&lt;DESCRIPTION_OF_SECURITY_GROUP&gt;\" --vpc-id &lt;VPC_ID&gt;\naws ec2 authorize-security-group-ingress \\\n--group-id '&lt;SECURITY_GROUP_ID&gt;' \\\n--ip-permissions 'IpProtocol=all,PrefixListIds=[{PrefixListId=&lt;PREFIX_LIST_ID&gt;}]'\n</code></pre> </li> <li> <p>Manually attach this new Security Group to all master nodes of the cluster.</p> </li> <li> <p>Create another Security Group with an Elastic IP of the Cluster VPC:</p> <pre><code>aws ec2 create-security-group --group-name custom-okd-4-10 --description \"Cluster Ip to 80, 443\" --vpc-id &lt;VPC_ID&gt;\naws ec2 authorize-security-group-ingress \\\n--group-id '&lt;SECURITY_GROUP_ID&gt;' \\\n--protocol all \\\n--port 80 \\\n--cidr &lt;ELASTIC_IP_OF_CLUSTER_VPC&gt;\naws ec2 authorize-security-group-ingress \\\n--group-id '&lt;SECURITY_GROUP_ID&gt;' \\\n--protocol all \\\n--port 443 \\\n--cidr &lt;ELASTIC_IP_OF_CLUSTER_VPC&gt;\n</code></pre> </li> <li> <p>Modify the cluster load balancer via the <code>router-default</code> svc in the <code>openshift-ingress</code> namespace, paste two Security Groups created on previous steps:</p> The pull secret for the private registry <pre><code>apiVersion: v1\nkind: Service\nmetadata:\n  name: router-default\n  namespace: openshift-ingress\n  annotations:\n    service.beta.kubernetes.io/aws-load-balancer-additional-resource-tags: \"tag_name=some_value\"\n    service.beta.kubernetes.io/aws-load-balancer-security-groups: \"&lt;SECURITY_GROUP_IDs&gt;\"\n    ...\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#optimize-spot-instances-usage","title":"Optimize Spot Instances Usage","text":"<p>In order to optimize the usage of Spot Instances on the AWS, add the following line under the <code>providerSpec</code> field in the MachineSet of Worker Nodes:</p> <pre><code>providerSpec:\nvalue:\nspotMarketOptions: {}\n</code></pre>"},{"location":"operator-guide/deploy-okd-4.10/#related-articles","title":"Related Articles","text":"<ul> <li>Deploy AWS EKS Cluster</li> <li>Manage Jenkins Agent</li> <li>Associate IAM Roles With Service Accounts</li> <li>Deploy OKD 4.9 Cluster</li> </ul>"},{"location":"operator-guide/deploy-okd/","title":"Deploy OKD 4.9 Cluster","text":"<p>This instruction provides detailed information on the OKD 4.9 cluster deployment in the AWS Cloud and contains the additional setup necessary for the managed infrastructure.</p> <p>A full description of the cluster deployment can be found in the official documentation.</p>"},{"location":"operator-guide/deploy-okd/#prerequisites","title":"Prerequisites","text":"<p>Before the OKD cluster deployment and configuration, make sure to check the prerequisites.</p>"},{"location":"operator-guide/deploy-okd/#required-tools","title":"Required Tools","text":"<ol> <li> <p>Install the following tools listed below:</p> <ul> <li>AWS CLI</li> <li>OpenShift CLI</li> <li>Lens (optional)</li> </ul> </li> <li> <p>Create the AWS IAM user with the required permissions. Make sure the AWS account is active, and the user doesn't have a permission boundary. Remove any Service Control Policy (SCP) restrictions from the AWS account.</p> </li> <li> <p>Generate a key pair for cluster node SSH access. Please perform the steps below:</p> <ul> <li>Generate the SSH key. Specify the path and file name, such as ~/.ssh/id_ed25519, of the new SSH key. If there is an existing key pair, ensure that the public key is in the ~/.ssh directory.<pre><code> ssh-keygen -t ed25519 -N '' -f &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key identity to the SSH agent for a local user if it has not already been added.<pre><code> eval \"$(ssh-agent -s)\"\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key to the ssh-agent:<pre><code> ssh-add &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd/#prepare-for-the-deployment-process","title":"Prepare for the Deployment Process","text":"<p>Before deploying the OKD cluster, please perform the steps below:</p> <ol> <li> <p>Download the OKD installer.</p> </li> <li> <p>Extract the installation program:</p> <pre><code>tar -xvf openshift-install-linux.tar.gz\n</code></pre> </li> <li> <p>Download the installation pull secret for any private registry.</p> <p>This pull secret allows to authenticate with the services that are provided by the included authorities, including Quay.io serving container images for OKD components. For example, here is a pull secret for Docker Hub:</p> The pull secret for the private registry <pre><code>{\n  \"auths\":{\n    \"https://index.docker.io/v1/\":{\n      \"auth\":\"$TOKEN\"\n    }\n  }\n}\n</code></pre> </li> <li> <p>Create the deployment directory and the install-config.yaml file:</p> <pre><code>mkdir okd-deployment\ntouch okd-deployment/install-config.yaml\n</code></pre> <p>To specify more details about the OKD cluster platform or to modify the values of the required parameters, customize the install-config.yaml file for AWS. Please see an example of the customized file below:</p> install-config.yaml - OKD cluster\u2019s platform installation configuration file <pre><code>apiVersion: v1\nbaseDomain: &lt;YOUR_DOMAIN&gt;\ncompute:\n- architecture: amd64\n  hyperthreading: Enabled\n  name: worker\n  platform:\n    aws:\n      zones:\n        - eu-central-1a\n      rootVolume:\n        size: 50\n      type: r5.large\n  replicas: 3\ncontrolPlane:\n  architecture: amd64\n  hyperthreading: Enabled\n  name: master\n  platform:\n    aws:\n      rootVolume:\n        size: 50\n      zones:\n        - eu-central-1a\n      type: m5.xlarge\n  replicas: 3\nmetadata:\n  creationTimestamp: null\n  name: 4-9-okd-sandbox\nplatform:\n  aws:\n    region: eu-central-1\n    userTags:\n      user:tag: 4-9-okd-sandbox\npublish: External\npullSecret: &lt;PULL_SECRET&gt;\nsshKey: |\n  &lt;SSH_KEY&gt;\n</code></pre> <p>where:</p> <ul> <li>YOUR_DOMAIN - is a base domain,</li> <li>PULL_SECRET - is a created pull secret for a private registry,</li> <li>SSH_KEY - is a created SSH key.</li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd/#deploy-the-cluster","title":"Deploy the Cluster","text":"<p>To initialize the cluster deployment, run the following command:</p> <pre><code>./openshift-install create cluster --dir &lt;installation_directory&gt; --log-level=info\n</code></pre> <p>Note</p> <p>If the cloud provider account configured on the host does not have sufficient permissions to deploy the cluster, the installation process stops, and the missing permissions are displayed.</p> <p>When the cluster deployment is completed, directions for accessing the cluster are displayed in the terminal, including a link to the web console and credentials for the kubeadmin user. The <code>kubeconfig</code> for the cluster will be located in okd-deployment/auth/kubeconfig.</p> Example output <pre><code>...\nINFO Install complete!\nINFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'\nINFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com\nINFO Login to the console with the user: \"kubeadmin\", and password: \"4vYBz-Ee6gm-ymBZj-Wt5AL\"\nINFO Time elapsed: 36m22s:\n</code></pre> <p>Warning</p> <p>The Ignition config files contain certificates that expire after 24 hours, which are then renewed at that time. Do not turn off the cluster for this time, or you will have to update the certificates manually. See OpenShift Container Platform documentation for more information.</p>"},{"location":"operator-guide/deploy-okd/#log-into-the-cluster","title":"Log Into the Cluster","text":"<p>To log into the cluster, export the <code>kubeconfig</code>:</p> <pre><code>  export KUBECONFIG=&lt;installation_directory&gt;/auth/kubeconfig\n</code></pre> <p>Optionally, use the Lens tool for further work with the Kubernetes cluster.</p> <p>Note</p> <p>To install and manage the cluster, refer to Lens documentation.</p>"},{"location":"operator-guide/deploy-okd/#related-articles","title":"Related Articles","text":"<ul> <li>Deploy AWS EKS Cluster</li> <li>Manage Jenkins Agent</li> <li>Deploy OKD 4.10 Cluster</li> </ul>"},{"location":"operator-guide/ebs-csi-driver/","title":"Install Amazon EBS CSI Driver","text":"<p>The Amazon Elastic Block Store (Amazon EBS) Container Storage Interface (CSI) driver allows Amazon Elastic Kubernetes Service (Amazon EKS) clusters to manage the lifecycle of Amazon EBS volumes for Kubernetes Persistent Volumes.</p>"},{"location":"operator-guide/ebs-csi-driver/#prerequisites","title":"Prerequisites","text":"<p>An existing AWS Identity and Access Management (IAM) OpenID Connect (OIDC) provider for your cluster. To determine whether you already have an OIDC provider or to create a new one, see Creating an IAM OIDC provider for your cluster.</p> <p>To add an Amazon EBS CSI add-on, please follow the steps below:</p> <ol> <li> <p>Check your cluster details (the random value in the cluster name will be required in the next step):</p> <pre><code>kubectl cluster-info\n</code></pre> </li> <li> <p>Create Kubernetes IAM Trust Policy for Amazon EBS CSI Driver. Replace <code>AWS_ACCOUNT_ID</code> with your account ID, <code>AWS_REGION</code> with your AWS Region, and <code>EXAMPLED539D4633E53DE1B71EXAMPLE</code> with the value that was returned in the previous step. Save this Trust Policy into a file <code>aws-ebs-csi-driver-trust-policy.json</code>.</p> aws-ebs-csi-driver-trust-policy.json <pre><code>  {\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Principal\": {\n\"Federated\": \"arn:aws:iam::AWS_ACCOUNT_ID:oidc-provider/oidc.eks.AWS_REGION.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE\"\n},\n\"Action\": \"sts:AssumeRoleWithWebIdentity\",\n\"Condition\": {\n\"StringEquals\": {\n\"oidc.eks.AWS_REGION.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:aud\": \"sts.amazonaws.com\",\n\"oidc.eks.AWS_REGION.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:sub\": \"system:serviceaccount:kube-system:ebs-csi-controller-sa\"\n}\n}\n}\n]\n}\n</code></pre> <p>To get the notion of the IAM Role creation, please refer to the official documentation.</p> </li> <li> <p>Create the IAM role, for example:</p> <pre><code>aws iam create-role \\\n--role-name AmazonEKS_EBS_CSI_DriverRole \\\n--assume-role-policy-document file://\"aws-ebs-csi-driver-trust-policy.json\"\n</code></pre> </li> <li> <p>Attach the required AWS Managed Policy <code>AmazonEBSCSIDriverPolicy</code> to the role with the following command:</p> <pre><code>aws iam attach-role-policy \\\n--policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy \\\n--role-name AmazonEKS_EBS_CSI_DriverRole\n</code></pre> </li> <li> <p>Add the Amazon EBS CSI add-on using the AWS CLI. Replace <code>my-cluster</code> with the name of your cluster, <code>AWS_ACCOUNT_ID</code> with your account ID, and <code>AmazonEKS_EBS_CSI_DriverRole</code> with the name of the role that was created earlier:</p> <pre><code>aws eks create-addon --cluster-name my-cluster --addon-name aws-ebs-csi-driver \\\n--service-account-role-arn arn:aws:iam::AWS_ACCOUNT_ID:role/AmazonEKS_EBS_CSI_DriverRole\n</code></pre> <p>Note</p> <p>When the plugin is deployed, it creates the <code>ebs-csi-controller-sa</code> service account. The service account is bound to a Kubernetes <code>ClusterRole</code> with the required Kubernetes permissions. The <code>ebs-csi-controller-sa</code> service account should already be annotated with <code>arn:aws:iam::AWS_ACCOUNT_ID:role/AmazonEKS_EBS_CSI_DriverRole</code>. To check the annotation, please run:</p> <pre><code>kubectl get sa ebs-csi-controller-sa -n kube-system -o=jsonpath='{.metadata.annotations}'\n</code></pre> <p>In case pods have errors, restart the <code>ebs-csi-controller</code> deployment:</p> <pre><code>kubectl rollout restart deployment ebs-csi-controller -n kube-system\n</code></pre> </li> </ol>"},{"location":"operator-guide/ebs-csi-driver/#related-articles","title":"Related Articles","text":"<ul> <li>Creating an IAM OIDC provider for your cluster</li> <li>Creating the Amazon EBS CSI driver IAM role for service accounts</li> <li>Managing the Amazon EBS CSI driver as an Amazon EKS add-on</li> </ul>"},{"location":"operator-guide/edp-access-model/","title":"EDP Access Model","text":"<p>EDP uses two different methods to regulate access to resources, each tailored to specific scenarios:</p> <ul> <li>The initial method involves <code>roles</code> and <code>groups</code> in Keycloak and is used for SonarQube, Jenkins and partly for Nexus.</li> </ul> <ul> <li>The second method of resource access control in EDP involves <code>EDP custom resources</code>. This approach requires modifying custom resources that outline the required access privileges for every user or group and is used to govern access to Gerrit, Nexus, EDP Portal, EKS Cluster and Argo CD.</li> </ul> <p>Info</p> <p>These two approaches are not interchangeable, as each has its unique capabilities.</p>"},{"location":"operator-guide/edp-access-model/#keycloak","title":"Keycloak","text":"<p>This section explains what realm roles and realm groups are and how they function within Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#realm-roles","title":"Realm Roles","text":"<p>The Keycloak realm of <code>edp</code> has two realm roles with a composite types named <code>administrator</code> and <code>developer</code>:</p> <ul> <li>The <code>administrator</code> realm role is designed for users who need administrative access to the tools used in the project. This realm role contains two roles: <code>jenkins-administrators</code> and <code>sonar-administrators</code>. Users who are assigned the <code>administrator</code> realm role will be granted these two roles automatically.</li> </ul> <ul> <li>The <code>developer</code> realm role, on the other hand, is designed for users who need access to the development tools used in the project. This realm role also contains two roles: <code>jenkins-users</code> and <code>sonar-developers</code>. Users who are assigned the <code>developer</code> realm role will be granted these two roles automatically.</li> </ul> <p>These realm roles have been defined to make it easier to assign groups of rights to users.</p> <p>The table below shows the realm roles and the composite types they relate to.</p> Realm Role Name Regular Role Composite role administrator developer jenkins-administrators jenkins-users sonar-administrators sonar-developers"},{"location":"operator-guide/edp-access-model/#realm-groups","title":"Realm Groups","text":"<p>EDP uses two different realms for group management, <code>edp</code> and <code>openshift</code>:</p> <ul> <li>The <code>edp</code> realm contains two groups that are specifically used for controlling access to Argo CD. These groups are named <code>ArgoCDAdmins</code> and <code>ArgoCD-edp-users</code>.</li> </ul> <ul> <li>The <code>openshift</code> realm contains five groups that are used for access control in both the EDP Portal and EKS cluster. These groups are named <code>edp-oidc-admins</code>, <code>edp-oidc-builders</code>, <code>edp-oidc-deployers</code>,<code>edp-oidc-developers</code> and <code>edp-oidc-viewers</code>.</li> </ul> Realm Group Name Realm Name ArgoCDAdmins <code>edp</code> <code>ArgoCD-edp-users</code> <code>edp</code> <code>edp-oidc-admins</code> openshift <code>edp-oidc-builders</code> openshift <code>edp-oidc-deployers</code> openshift <code>edp-oidc-developers</code> openshift <code>edp-oidc-viewers</code> openshift"},{"location":"operator-guide/edp-access-model/#sonarqube","title":"SonarQube","text":"<p>In the case of SonarQube, there are two ways to manage access: via Keycloak and via EDP approach. This sections describes both of the approaches.</p>"},{"location":"operator-guide/edp-access-model/#manage-access-via-keycloak","title":"Manage Access via Keycloak","text":"<p>SonarQube access is managed using Keycloak roles in the <code>edp</code> realm. The <code>sonar-developers</code> and <code>sonar-administrators</code> realm roles are the two available roles that determine user access levels. To grant access, the corresponding role must be added to the user in Keycloak.</p> <p>For example, a user who needs developer access to SonarQube should be assigned the <code>sonar-developers</code> or <code>developer</code> composite role in Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#edp-approach-for-managing-access","title":"EDP Approach for Managing Access","text":"<p>EDP provides its own SonarQube Permission Template, which is used to manage user access and permissions for SonarQube projects.</p> <p>The template is stored in the custom SonarQube resource of the operator, an example of a custom resource can be found below.</p> <p>SonarPermissionTemplate</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: SonarPermissionTemplate\nmetadata:\nname: edp-default\nspec:\ndescription: EDP permission templates (DO NOT REMOVE)\ngroupPermissions:\n- groupName: non-interactive-users\npermissions:\n- user\n- groupName: sonar-administrators\npermissions:\n- admin\n- user\n- groupName: sonar-developers\npermissions:\n- codeviewer\n- issueadmin\n- securityhotspotadmin\n- user\nname: edp-default\nprojectKeyPattern: .+\nsonarOwner: sonar\n</code></pre> <p>The SonarQube Permission Template contains three groups: <code>non-interactive-users</code>, <code>sonar-administrators</code> and <code>sonar-developers</code>:</p> <ul> <li><code>non-interactive-users</code> are users who do not require direct access to the SonarQube project but need to be informed about the project's status and progress. This group has read-only access to the project, which means that they can view the project's data and metrics but cannot modify or interact with it in any way.</li> </ul> <ul> <li><code>sonar-administrators</code> are users who have full control over the SonarQube project. They have the ability to create, modify, and delete projects, as well as manage user access and permissions. This group also has the ability to configure SonarQube settings and perform other administrative tasks.</li> </ul> <ul> <li><code>sonar-developers</code> are users who are actively working on the SonarQube project. They have read and write access to the project, which means that they can modify the project's data and metrics. This group also has the ability to configure project-specific settings and perform other development tasks.</li> </ul> <p>These groups are designed to provide different levels of access to the SonarQube project, depending on the user's role and responsibilities.</p> <p>Info</p> <p>If a user has no group, it will have the <code>sonar-users</code> group by default. This group does not have any permissions in the <code>edp-default</code> Permission Template.</p> <p>The permissions that are attached to each of the groups are described below in the table:</p> Group Name Permissions <code>non-interactive-users</code> user <code>sonar-administrators</code> admin, user <code>sonar-developers</code> codeviewer, issueadmin, securityhotspotadmin, user <code>sonar-users</code> -"},{"location":"operator-guide/edp-access-model/#nexus","title":"Nexus","text":"<p>Users authenticate to Nexus using their Keycloak credentials.</p> <p>During the authentication process, the OAuth2-Proxy receives the user's role from Keycloak.</p> <p>Info</p> <p>Only users with either the <code>administrator</code> or <code>developer</code> role in Keycloak can access Nexus.</p> <p>Nexus has four distinct roles available, including <code>edp-admin</code>, <code>edp-viewer</code>, <code>nx-admin</code> and <code>nx-anonymous</code>. To grant the user access to one or more of these roles, an entry must be added to the custom Nexus resource.</p> <p>For instance, in the context of the custom Nexus resource, the user \"user_1@example.com\" has been assigned the \"nx-admin\" role. An example can be found below:</p> <p>Nexus</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: Nexus\nmetadata:\nname: nexus\nspec:\nbasePath: /\nedpSpec:\ndnsWildcard: example.com\nkeycloakSpec:\nenabled: false\nroles:\n- developer\n- administrator\nusers:\n- roles:\n- nx-admin\nusername: user_1@example.com\n</code></pre>"},{"location":"operator-guide/edp-access-model/#gerrit","title":"Gerrit","text":"<p>The user should use their credentials from Keycloak when authenticating to Gerrit.</p> <p>After logging into Gerrit, the user is not automatically attached to any groups. To add a user to a group, the <code>GerritGroupMember</code> custom resource must be created. This custom resource specifies the user's email address and the name of the group to which they should be added.</p> <p>The ConfigMap below is an example of the <code>GerritGroupMember</code> resource:</p> <p>GerritGroupMember</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: GerritGroupMember\nmetadata:\nname: user-admins\nspec:\naccountId: user@user.com\ngroupId: Administrators\n</code></pre> <p>After the <code>GerritGroupMember</code> resource is created, the user will have the permissions and access levels associated with that group.</p>"},{"location":"operator-guide/edp-access-model/#edp-portal-and-eks-cluster","title":"EDP Portal and EKS Cluster","text":"<p>Both Portal and EKS Cluster use Keycloak groups for controlling access. Users need to be added to the required group in Keycloak to get access. The groups that are used for access control are in the <code>openshift</code> realm.</p> <p>Note</p> <p>The <code>openshift</code> realm is used because a Keycloak client for OIDC is in this realm.</p>"},{"location":"operator-guide/edp-access-model/#keycloak-groups","title":"Keycloak Groups","text":"<p>There are two types of groups provided for users:</p> <ul> <li>Independent group: provides the minimum required permission set.</li> <li>Extension group: extends the rights of an independent group.</li> </ul> <p>For example, the <code>edp-oidc-viewers</code> group can be extended with rights from the <code>edp-oidc-builders</code> group.</p> Group Name Independent Group Extension Group <code>edp-oidc-admins</code> <code>edp-oidc-developers</code> <code>edp-oidc-viewers</code> <code>edp-oidc-builders</code> <code>edp-oidc-deployers</code> Name Action List View Getting of all namespaced resources Build Starting a PipelineRun from EDP Portal UI Deploy Deploying a new version of application via Argo CD Application Group Name View Build Deploy Full Namespace Access <code>edp-oidc-admins</code> <code>edp-oidc-developers</code> <code>edp-oidc-viewers</code> <code>edp-oidc-builders</code> <code>edp-oidc-deployers</code>"},{"location":"operator-guide/edp-access-model/#cluster-rbac-resources","title":"Cluster RBAC Resources","text":"<p>The <code>edp</code> namespace has five role bindings that provide the necessary permissions for the Keycloak groups described above.</p> Role Binding Name Role Name Groups tenant-admin cluster-admin <code>edp-oidc-admins</code> tenant-builder tenant-builder <code>edp-oidc-builders</code> tenant-deployer tenant-deployer <code>edp-oidc-deployers</code> tenant-developer tenant-developer <code>edp-oidc-developers</code> tenant-viewer view <code>edp-oidc-viewers</code> , <code>edp-oidc-developers</code> <p>Note</p> <p>EDP provides an aggregate ClusterRole with permissions to view custom EDP resources. ClusterRole is named <code>edp-aggregate-view-edp</code></p> <p>Info</p> <p>The <code>tenant-admin</code> RoleBinding will be created in a created namespace by <code>cd-pipeline-operator</code>. <code>tenant-admin</code> RoleBinding assign the <code>admin</code> role to <code>edp-oidc-admins</code> and <code>edp-oidc-developers</code> groups.</p>"},{"location":"operator-guide/edp-access-model/#grant-user-access-to-the-created-namespaces","title":"Grant User Access to the Created Namespaces","text":"<p>To provide users with admin or developer privileges for project namespaces, they need to be added to the <code>edp-oidc-admins</code> and <code>edp-oidc-developers</code> groups in Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#argo-cd","title":"Argo CD","text":"<p>In Argo CD, groups are specified when creating an AppProject to restrict access to deployed applications. To gain access to deployed applications within a project, the user must be added to their corresponding Argo CD group in Keycloak. This ensures that only authorized users can access and modify applications within the project.</p> <p>Info</p> <p>By default, only the <code>ArgoCDAdmins</code> group is automatically created in Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Portal Overview</li> <li>EKS OIDC With Keycloak</li> <li>Argo CD Integration</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/","title":"EDP Kiosk Usage","text":"<p>Explore the way Kiosk, a multi-tenancy extension for Kubernetes, is used in EDP.</p>"},{"location":"operator-guide/edp-kiosk-usage/#prerequisites","title":"Prerequisites","text":"<ul> <li>Installed Kiosk 0.2.11.</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/#diagram-of-using-kiosk-by-edp","title":"Diagram of using Kiosk by EDP","text":"<p> Kiosk usage </p> <p>Agenda</p> <ul> <li>blue - created by Helm chart;</li> <li>grey - created manually</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/#usage","title":"Usage","text":"<ul> <li>EDP installation area on a diagram is described by following link;</li> </ul> <ul> <li>Once the above step is executed, edp-cd-pipeline-operator service account will be linked to kiosk-edit ClusterRole   to get an ability for leveraging Kiosk specific resources (e.g. Space);</li> </ul> <ul> <li>Newly created stage in <code>edp</code> installation of EDP generates new Kiosk Space resource that is linked to edp Kiosk Account;</li> </ul> <ul> <li>According to Kiosk doc the Space resource creates namespace with RoleBinding that contains relation between service account   which is linked to Kiosk Account and kiosk-space-admin ClusterRole.   As cd-pipeline-operator ServiceAccount is linked to Account, it has admin permissions in all generated by him namespaces.</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Set Up Kiosk</li> </ul>"},{"location":"operator-guide/eks-oidc-integration/","title":"EKS OIDC Integration","text":"<p>This page is a detailed guide on integrating Keycloak with the edp-keycloak-operator to serve as an identity provider for AWS Elastic Kubernetes Service (EKS). It provides step-by-step instructions for creating necessary realms, users, roles, and client configurations for a seamless Keycloak-EKS collaboration. Additionally, it includes guidelines on installing the edp-keycloak-operator using Helm charts.</p>"},{"location":"operator-guide/eks-oidc-integration/#prerequisites","title":"Prerequisites","text":"<ul> <li>EKS Configuration is performed;</li> <li>Helm v3.10.0 is installed;</li> <li>Keycloak is installed.</li> </ul>"},{"location":"operator-guide/eks-oidc-integration/#configure-keycloak","title":"Configure Keycloak","text":"<p>To prepare Keycloak for integration with the edp-keycloak-operator, follow the steps below:</p> <ol> <li> <p>Ensure that the openshift realm is created.</p> </li> <li> <p>Create the orchestrator user and set the password in the Master realm.</p> </li> <li> <p>In the Role Mapping tab, assign the proper roles to the user:</p> <ul> <li> <p>Realm Roles:</p> <ul> <li>create-realm;</li> </ul> <ul> <li>offline_access;</li> </ul> <ul> <li>uma_authorization.</li> </ul> </li> </ul> <ul> <li> <p>Client Roles <code>openshift-realm</code>:</p> <ul> <li>impersonation;</li> </ul> <ul> <li>manage-authorization;</li> </ul> <ul> <li>manage-clients;</li> </ul> <ul> <li>manage-users.</li> </ul> </li> </ul> </li> </ol> <p> Role mappings </p>"},{"location":"operator-guide/eks-oidc-integration/#install-keycloak-operator","title":"Install Keycloak Operator","text":"<p>To install the Keycloak operator, follow the steps below:</p> <ol> <li> <p>Add the <code>epamedp</code> Helm chart to a local client:</p> <pre><code>helm repo add epamedp https://epam.github.io/edp-helm-charts/stable\nhelm repo update\n</code></pre> </li> <li> <p>Install the Keycloak operator:</p> <pre><code>helm install keycloak-operator epamedp/keycloak-operator --namespace security --set name=keycloak-operator\n</code></pre> </li> </ol>"},{"location":"operator-guide/eks-oidc-integration/#connect-keycloak-operator-to-keycloak","title":"Connect Keycloak Operator to Keycloak","text":"<p>The next stage after installing Keycloak is to integrate it with the Keycloak operator. It can be implemented with the following steps:</p> <ol> <li> <p>Create the keycloak secret that will contain username and password to perform the integration. Set your own password. The username must be orchestrator:</p> <pre><code>kubectl -n security create secret generic keycloak \\\n--from-literal=username=orchestrator \\\n--from-literal=password=&lt;password&gt;\n</code></pre> </li> <li> <p>Create the Keycloak Custom Resource with the Keycloak instance URL and the secret created in the previous step:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: Keycloak\nmetadata:\nname: main\nnamespace: security\nspec:\nsecret: keycloak                   # Secret name\nurl: https://keycloak.example.com  # Keycloak URL\n</code></pre> </li> <li> <p>Create the KeycloakRealm Custom Resource:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealm\nmetadata:\nname: control-plane\nnamespace: security\nspec:\nrealmName: control-plane\nkeycloakOwner: main\n</code></pre> </li> <li> <p>Create the KeycloakRealmGroup Custom Resource for both administrators and developers:</p> administratorsdevelopers <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmGroup\nmetadata:\nname: administrators\nnamespace: security\nspec:\nrealm: control-plane\nname: eks-oidc-administrator\n</code></pre> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmGroup\nmetadata:\nname: developers\nnamespace: security\nspec:\nrealm: control-plane\nname: eks-oidc-developers\n</code></pre> </li> <li> <p>Create the KeycloakClientScope Custom Resource:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClientScope\nmetadata:\nname: groups-keycloak-eks\nnamespace: security\nspec:\nname: groups\nrealm: control-plane\ndescription: \"Group Membership\"\nprotocol: openid-connect\nprotocolMappers:\n- name: groups\nprotocol: openid-connect\nprotocolMapper: \"oidc-group-membership-mapper\"\nconfig:\n\"access.token.claim\": \"true\"\n\"claim.name\": \"groups\"\n\"full.path\": \"false\"\n\"id.token.claim\": \"true\"\n\"userinfo.token.claim\": \"true\"\n</code></pre> </li> <li> <p>Create the KeycloakClient Custom Resource:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: eks\nnamespace: security\nspec:\nadvancedProtocolMappers: true\nclientId: eks\ndirectAccess: true\npublic: false\ndefaultClientScopes:\n- groups\ntargetRealm: control-plane\nwebUrl: \"http://localhost:8000\"\n</code></pre> </li> <li> <p>Create the KeycloakRealmUser Custom Resource for both administrator and developer roles:</p> administrator roledeveloper role <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmUser\nmetadata:\nname: keycloakrealmuser-sample\nnamespace: security\nspec:\nrealm: control-plane\nusername: \"administrator\"\nfirstName: \"John\"\nlastName: \"Snow\"\nemail: \"administrator@example.com\"\nenabled: true\nemailVerified: true\npassword: \"12345678\"\nkeepResource: true\nrequiredUserActions:\n- UPDATE_PASSWORD\ngroups:\n- eks-oidc-administrator\n</code></pre> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmUser\nmetadata:\nname: keycloakrealmuser-sample\nnamespace: security\nspec:\nrealm: control-plane\nusername: \"developers\"\nfirstName: \"John\"\nlastName: \"Snow\"\nemail: \"developers@example.com\"\nenabled: true\nemailVerified: true\npassword: \"12345678\"\nkeepResource: true\nrequiredUserActions:\n- UPDATE_PASSWORD\ngroups:\n- eks-oidc-developers\n</code></pre> </li> <li> <p>As a result, Keycloak is integrated with the AWS Elastic Kubernetes Service. This integration enables users to log in to the EKS cluster effortlessly using their kubeconfig files while managing permissions through Keycloak.</p> </li> </ol>"},{"location":"operator-guide/eks-oidc-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Keycloak Installation</li> <li>EKS OIDC With Keycloak</li> </ul>"},{"location":"operator-guide/enable-irsa/","title":"Associate IAM Roles With Service Accounts","text":"<p>This page contains accurate information on how to associate an IAM role with the service account (IRSA) in EPAM Delivery Platform.</p> <p>Get acquainted with the AWS Official Documentation on the subject before proceeding.</p>"},{"location":"operator-guide/enable-irsa/#common-configuration-of-iam-roles-with-service-accounts","title":"Common Configuration of IAM Roles With Service Accounts","text":"<p>To successfully associate the IAM role with the service account, follow the steps below:</p> <ol> <li> <p>Create an IAM role that will further be associated with the service account. This role must have the following trust policy:</p> <p>IAM Role</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:&lt;SERVICE_ACCOUNT_NAMESPACE&gt;:&lt;SERVICE_ACCOUNT_NAME&gt;\"\n        }\n      }\n    }\n  ]\n}\n</code></pre> <p>View cluster's \u2039OIDC_PROVIDER\u203a URL.</p> <pre><code>  aws eks describe-cluster --name &lt;CLUSTER_NAME&gt; --query \"cluster.identity.oidc.issuer\" --output text\n</code></pre> <p>Example output:</p> <pre><code>  https://oidc.eks.us-west-2.amazonaws.com/id/EXAMPLED539D4633E53DE1B716D3041E\n</code></pre> <p>\u2039OIDC_PROVIDER\u203a in this example will be:</p> <pre><code>  oidc.eks.us-west-2.amazonaws.com/id/EXAMPLED539D4633E53DE1B716D3041E\n</code></pre> </li> <li> <p>Deploy the amazon-eks-pod-identity-webhook v0.2.0.</p> <p>Note</p> <p>The amazon-eks-pod-identity-webhook functionality is provided out of the box in EKS v1.21 and higher. This does not apply if the cluster has been upgraded from older versions. Therefore, skip step 2 and continue from step 3 in this documentation.</p> <p>2.1. Provide the stable(ed8c41f) version of the Docker image in the deploy/deployment-base.yaml file.</p> <p>2.2. Provide ${CA_BUNDLE}_in the_deploy/mutatingwebhook.yaml file:</p> <pre><code>  secret_name=$(kubectl -n default get sa default -o jsonpath='{.secrets[0].name}') \\\n  CA_BUNDLE=$(kubectl -n default get secret/$secret_name -o jsonpath='{.data.ca\\.crt}' | tr -d '\\n')\n</code></pre> <p>2.3. Deploy the Webhook:</p> <pre><code>  kubectl apply -f deploy/\n</code></pre> <p>2.4. Approve the csr:</p> <pre><code>  csr_name=$(kubectl get csr -o jsonpath='{.items[?(@.spec.username==\"system:serviceaccount:default:pod-identity-webhook\")].metadata.name}')\n  kubectl certificate approve $csr_name\n</code></pre> </li> <li> <p>Annotate the created service account with the IAM role:</p> <p>Service Account</p> <pre><code>  apiVersion: v1\n  kind: ServiceAccount\n  metadata:\n    name: &lt;SERVICE_ACCOUNT_NAME&gt;\n    namespace: &lt;NAMESPACE&gt;\n    annotations:\n      eks.amazonaws.com/role-arn: \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/&lt;IAM_ROLE_NAME&gt;\"\n</code></pre> </li> <li> <p>All newly launched pods with this service account will be modified and then use the associated IAM role. Find below the pod specification template:</p> <p>Pod Template</p> <pre><code>  apiVersion: v1\n  kind: Pod\n  metadata:\n    name: irsa-test\n    namespace: &lt;POD_NAMESPACE&gt;\n  spec:\n    serviceAccountName: &lt;SERVICE_ACCOUNT_NAME&gt;\n    securityContext:\n      fsGroup: 65534\n    containers:\n    - name: terraform\n      image: epamedp/edp-jenkins-terraform-agent:3.0.9\n      command: ['sh', '-c', 'aws sts \"get-caller-identity\" &amp;&amp; sleep 3600']\n</code></pre> </li> <li> <p>Check the logs of the created pod from the template above.</p> <p>Example output:</p> <pre><code>  {\n  \"UserId\": \"XXXXXXXXXXXXXXXXXXXXX:botocore-session-XXXXXXXXXX\",\n  \"Account\": \"XXXXXXXXXXXX\",\n  \"Arn\": \"arn:aws:sts::XXXXXXXXXXXX:assumed-role/AWSIRSATestRole/botocore-session-XXXXXXXXXX\"\n  }\n</code></pre> <p>As a result, it is possible to perform actions in AWS under the AWSIRSATestRole role.</p> </li> </ol>"},{"location":"operator-guide/enable-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Use Terraform Library in EDP</li> </ul>"},{"location":"operator-guide/external-secrets-operator-integration/","title":"External Secrets Operator Integration","text":"<p>External Secrets Operator (ESO) can be integrated with EDP.</p> <p>There are multiple Secrets Providers that can be used within ESO. EDP is integrated with two major providers:</p> <ul> <li>Kubernetes Secrets</li> <li>AWS Systems Manager Parameter Store</li> </ul> <p>EDP uses various secrets to integrate various applications. Below is a list of secrets that are used in the EDP platform and their description.</p> Secret Name Field Description keycloak username Admin username for keycloak, used by keycloak operator keycloak password Admin password for keycloak, used by keycloak operator defectdojo-ciuser-token token Defectdojo token with admin permissions defectdojo-ciuser-token url Defectdojo url kaniko-docker-config registry.com Change to registry url kaniko-docker-config username Registry username kaniko-docker-config password Registry password kaniko-docker-config auth Base64 encoded 'user:secret' string regcred registry.com Change to registry url regcred username Registry username regcred password Registry password regcred auth Base64 encoded 'user:secret' string github-config id_rsa Private key from github repo in base64 github-config token Api token github-config secretString Random string gitlab-config id_rsa Private key from gitlab repo in base64 gitlab-config token Api token gitlab-config secretString Random string jira-user username Jira username in base64 jira-user password Jira password in base64 sonar-ciuser-token username Sonar service account username sonar-ciuser-token secret Sonar service account secret nexus-ci-user username Nexus service account username nexus-ci-user password Nexus service accountpassword oauth2-proxy-cookie-secret cookie-secret Secret key for keycloak client in base64 nexus-proxy-cookie-secret cookie-secret Secret key for keycloak client in base64 keycloak-client-headlamp-secret Secret key for keycloak client in base64 keycloak-client-argo-secret Secret key for keycloak client in base64"},{"location":"operator-guide/external-secrets-operator-integration/#kubernetes-provider","title":"Kubernetes Provider","text":"<p>All secrets are stored in Kubernetes in pre-defined namespaces. EDP suggests using the following approach for secrets management:</p> <ul> <li><code>EDP_NAMESPACE-vault</code>, where EDP_NAMESPACE is a name of the namespace where EDP is deployed, such as <code>edp-vault</code>. This namespace is used by EDP platform. Access to secrets in the <code>edp-vault</code> is permitted only for <code>EDP Administrators</code>.</li> </ul> <ul> <li><code>EDP_NAMESPACE-cicd-vault</code>, where EDP_NAMESPACE is a name of the namespace where EDP is deployed, such as <code>edp-cicd-vault</code>. Development team uses access to secrets in the <code>edp-cicd-vault</code>for microservices development.</li> </ul> <p>See a diagram below for more details:</p> <p></p> <p>In order to install EDP, a list of passwords must be created. Secrets are provided automatically when using ESO.</p> <ol> <li> <p>Create a common namespace for secrets and EDP:</p> <pre><code>kubectl create namespace edp-vault\nkubectl create namespace edp\n</code></pre> </li> <li> <p>Create secrets in the <code>edp-vault</code> namespace:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: keycloak\nnamespace: edp-vault\ndata:\npassword: cGFzcw==  # pass in base64\nusername: dXNlcg==  # user in base64\ntype: Opaque\n</code></pre> </li> <li> <p>In the <code>edp-vault</code> namespace, create a Role with a permission to read secrets:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: Role\nmetadata:\nnamespace: edp-vault\nname: external-secret-store\nrules:\n- apiGroups: [\"\"]\nresources:\n- secrets\nverbs:\n- get\n- list\n- watch\n- apiGroups:\n- authorization.k8s.io\nresources:\n- selfsubjectrulesreviews\nverbs:\n- create\n</code></pre> </li> <li> <p>In the <code>edp-vault</code> namespace, create a ServiceAccount used by <code>SecretStore</code>:</p> <pre><code>apiVersion: v1\nkind: ServiceAccount\nmetadata:\nname: secret-manager\nnamespace: edp\n</code></pre> </li> <li> <p>Connect the Role from the <code>edp-vault</code> namespace with the ServiceAccount in the <code>edp</code> namespace:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\nname: eso-from-edp\nnamespace: edp-vault\nsubjects:\n- kind: ServiceAccount\nname: secret-manager\nnamespace: edp\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: Role\nname: external-secret-store\n</code></pre> </li> <li> <p>Create a SecretStore in the <code>edp</code> namespace, and use ServiceAccount for authentication:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: SecretStore\nmetadata:\nname: edp-vault\nnamespace: edp\nspec:\nprovider:\nkubernetes:\nremoteNamespace: edp-vault  # namespace with secrets\nauth:\nserviceAccount:\nname: secret-manager\nserver:\ncaProvider:\ntype: ConfigMap\nname: kube-root-ca.crt\nkey: ca.crt\n</code></pre> </li> <li> <p>Each secret must be defined by the <code>ExternalSecret</code> object. A code example below creates the <code>keycloak</code> secret in the <code>edp</code> namespace based on a secret with the same name in the <code>edp-vault</code> namespace:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: ExternalSecret\nmetadata:\nname: keycloak\nnamespace: edp\nspec:\nrefreshInterval: 1h\nsecretStoreRef:\nkind: SecretStore\nname: edp-vault\n# target:\n#   name: secret-to-be-created  # name of the k8s Secret to be created. metadata.name used if not defined\ndata:\n- secretKey: username       # key to be created\nremoteRef:\nkey: keycloak           # remote secret name\nproperty: username      # value will be fetched from this field\n- secretKey: password       # key to be created\nremoteRef:\nkey: keycloak           # remote secret name\nproperty: password      # value will be fetched from this field\n</code></pre> </li> </ol> <p>Apply the same approach for enabling secrets management in the namespaces used for microservices development, such as <code>sit</code> and <code>qa</code> on the diagram above.</p>"},{"location":"operator-guide/external-secrets-operator-integration/#aws-systems-manager-parameter-store","title":"AWS Systems Manager Parameter Store","text":"<p>AWS SSM Parameter Store can be used as a Secret Provider for ESO. For EDP, it is recommended to use the IAM Roles For Service Accounts approach (see a diagram below).</p> <p></p>"},{"location":"operator-guide/external-secrets-operator-integration/#aws-parameter-store-in-edp-scenario","title":"AWS Parameter Store in EDP Scenario","text":"<p>In order to install EDP, a list of passwords must be created. Follow the steps below, to get secrets from the SSM:</p> <ol> <li> <p>In the AWS, create an AWS IAM policy and an IAM role used by <code>ServiceAccount</code> in <code>SecretStore</code>. The IAM role must have permissions to get values from the SSM Parameter Store.</p> <p>a. Create an IAM policy that allows to get values from the Parameter Store with the <code>edp/</code> path. Use your <code>AWS Region</code> and <code>AWS Account Id</code>:</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Sid\": \"VisualEditor0\",\n\"Effect\": \"Allow\",\n\"Action\": \"ssm:GetParameter*\",\n\"Resource\": \"arn:aws:ssm:eu-central-1:012345678910:parameter/edp/*\"\n}\n]\n}\n</code></pre> <p>b. Create an AWS IAM role with trust relationships (defined below) and attach the IAM policy. Put your string for <code>Federated</code> value (see more on IRSA enablement for EKS Cluster) and AWS region.</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Principal\": {\n\"Federated\": \"arn:aws:iam::012345678910:oidc-provider/oidc.eks.eu-central-1.amazonaws.com/id/XXXXXXXXXXXXXXXXXX\"\n},\n\"Action\": \"sts:AssumeRoleWithWebIdentity\",\n\"Condition\": {\n\"StringLike\": {\n\"oidc.eks.eu-central-1.amazonaws.com/id/XXXXXXXXXXXXXXXXXX:sub\": \"system:serviceaccount:edp:*\"\n}\n}\n}\n]\n}\n</code></pre> </li> <li> <p>Create a secret in the AWS Parameter Store with the name <code>/edp/my-json-secret</code>. This secret is represented as a parameter of type string within the AWS Parameter Store:</p> View: Parameter Store JSON <pre><code>{\n\"keycloak\":\n{\n\"username\": \"keycloak-username\",\n\"password\": \"keycloak-password\"\n},\n\"defectdojo-ciuser-token\":\n{\n\"token\": \"XXXXXXXXXXXX\",\n\"url\": \"https://defectdojo.example.com\"\n},\n\"kaniko-docker-config\":\n{\n\"auths\" :\n{\n\"registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"&lt;base64 encoded 'user:secret' string&gt;\"\n}\n}},\n\"regcred\":\n{\n\"auths\":\n{\n\"registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\":\"&lt;base64 encoded 'user:secret' string&gt;\"\n}\n}},\n\"github-config\":\n{\n\"id_rsa\": \"id-rsa-key\",\n\"token\": \"github-token\",\n\"secretString\": \"XXXXXXXXXXXX\"\n},\n\"gitlab-config\":\n{\n\"id_rsa\": \"id-rsa-key\",\n\"token\": \"gitlab-token\",\n\"secretString\": \"XXXXXXXXXXXX\"\n},\n\"jira-user\":\n{\n\"username\": \"jira-username\",\n\"password\": \"jira-password\"\n},\n\"sonar-ciuser-token\": { \"username\": \"&lt;ci-user&gt;\",  \"secret\": \"&lt;secret&gt;\" },\n\"nexus-ci-user\": { \"username\": \"&lt;ci.user&gt;\",  \"password\": \"&lt;secret&gt;\" },\n\"oauth2-proxy-cookie-secret\": { \"cookie-secret\": \"XXXXXXXXXXXX\" },\n\"nexus-proxy-cookie-secret\": { \"cookie-secret\": \"XXXXXXXXXXXX\" },\n\"keycloak-client-headlamp-secret\":  \"XXXXXXXXXXXX\",\n\"keycloak-client-argo-secret\":  \"XXXXXXXXXXXX\"\n}\n</code></pre> </li> <li> <p>Set External Secret operator enabled by updating the values.yaml file:</p> EDP install values.yaml<pre><code>externalSecrets:\nenabled: true\n</code></pre> </li> <li> <p>Install/upgrade edp-install:</p> <pre><code>helm upgrade --install edp epamedp/edp-install --wait --timeout=900s \\\n--version &lt;edp_version&gt; \\\n--values values.yaml \\\n--namespace edp \\\n--atomic\n</code></pre> </li> </ol>"},{"location":"operator-guide/external-secrets-operator-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Install External Secrets Operator</li> </ul>"},{"location":"operator-guide/github-debug-webhooks/","title":"Debug GitHub Webhooks in Jenkins","text":"<p>A webhook enables third-party services like GitHub to send real-time updates to an application. Updates are triggered by an event or an action by the webhook provider (for example, a push to a repository, a Pull Request creation), and pushed to the application via HTTP requests, namely, Jenkins. The GitHub Jenkins job provisioner creates a webhook in the GitHub repository during the Create release pipeline once the Integrate GitHub/GitLab in Jenkins is enabled and the GitHub Webhook Configuration is completed.</p> <p>The Jenkins setup in EDP uses the following plugins responsible for listening on GitHub webhooks:</p> <ul> <li>GitHub plugin is configured to listen on Push events.</li> </ul> <ul> <li>GitHub Pull Request Builder is configured to listen on Pull Request events.</li> </ul> <p>In case of any issues with webhooks, try the following solutions:</p> <ol> <li> <p>Check that the firewalls are configured to accept the incoming traffic from the IP address range that is described in the GitHub documentation.</p> </li> <li> <p>Check that GitHub Personal Access Token is correct and has sufficient scope permissions.</p> </li> <li> <p>Check that the job has run at least once before using the hook (once an application is created in EDP, the build job should be run automatically in Jenkins).</p> </li> <li> <p>Check that both Push and issue comment and Pull Request webhooks are created on the GitHub side (unlike GitLab, GitHub does not need separate webhooks for each branch):</p> <ul> <li>Go to the GitHub repository -&gt; Settings -&gt; Webhooks.</li> </ul> <p> Webhooks settings </p> </li> <li> <p>Click each webhook and check if the event delivery is successful:</p> <ul> <li>The URL payload must be <code>https://jenkins-the-host.com/github-webhook/</code> for the GitHub plugin and <code>https://jenkins-the-host.com/ghprbhook/</code> for the GitHub Pull Request Builder.</li> <li>The content type must be application/json for Push events and application/x-www-form-urlencoded for Pull Request events.</li> <li>The html_url in the Payload request must match the repository URL and be without .git at the end of the URL.</li> </ul> </li> <li> <p>Check that the X-Hub-Signature secret is verified. It is provided by the Jenkins GitHub plugin for Push events and by the GitHub Pull Request Builder plugin for Pull Request events. The Secret field is optional. Nevertheless, if incorrect, it can prevent webhook events.</p> <p>For the GitHub plugin (Push events):</p> <ul> <li>Go to Jenkins -&gt; Manage Jenkins -&gt; Configure System, and find the GitHub plugin section.</li> <li>Select Advanced -&gt; Shared secrets to add the secret via the Jenkins Credentials Provider.</li> </ul> <p>For the GitHub Pull Request Builder (Pull Request events):</p> <ul> <li>Go to Jenkins -&gt; Manage Jenkins -&gt; Configure System, and find the GitHub Pull Request Builder plugin section.</li> <li>Check Shared secret that can be added manually.</li> </ul> </li> <li> <p>Redeliver events by clicking the Redeliver button and check the Response body.</p> <p> Manage webhook </p> <p>Note</p> <p>Use Postman to debug webhooks. Add all headers to Postman from the webhook Request -&gt; Headers field and send the payload (Request body) using the appropriate content type.</p> <p>Examples for Push and Pull Request events:</p> <p> Postman push event payload headers GitHub plugin push events </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 8:51:14 AM INFO org.jenkinsci.plugins.github.webhook.subscriber.PingGHEventSubscriber onEvent\nPING webhook received from repo &lt;https://github.com/user-profile/user-repo&gt;!\n</code></pre> <p> Postman pull request event payload headers GitHub pull request builder </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 8:17:53 AM FINE org.jenkinsci.plugins.ghprb.GhprbRootAction\nGot payload event: ping\n</code></pre> </li> <li> <p>Check that the repo pushing to Jenkins, the GitHub project URL in the project configuration, and the repos in the pipeline Job must be lined up.</p> </li> <li> <p>Enable the GitHub hook trigger for GITScm polling for the Build job.</p> <p> GitHub hook trigger </p> </li> <li> <p>Enable the GitHub Pull Request Builder for the Code Review job.</p> <p> GitHub pull request builder </p> </li> <li> <p>Filter through Jenkins log by using Jenkins custom log recorder:</p> <ul> <li>Go to Manage Jenkins -&gt; System log -&gt; Add new log recorder.</li> <li> <p>The Push events for the GitHub:</p> Logger Log Level org.jenkinsci.plugins.github.webhook.subscriber.DefaultPushGHEventSubscriber ALL com.cloudbees.jenkins.GitHubPushTrigger ALL com.cloudbees.jenkins.GitHubWebHook ALL org.jenkinsci.plugins.github.webhook.WebhookManager ALL org.jenkinsci.plugins.github.webhook.subscriber.PingGHEventSubscriber ALL </li> </ul> <ul> <li> <p>The Pull Request events for the GitHub Pull Request Builder:</p> Logger Log Level org.jenkinsci.plugins.ghprb.GhprbRootAction ALL org.jenkinsci.plugins.ghprb.GhprbTrigger ALL org.jenkinsci.plugins.ghprb.GhprbPullRequest ALL org.jenkinsci.plugins.ghprb.GhprbRepository ALL </li> </ul> <p>Note</p> <p>Below is an example of using the Pipeline script with webhooks for the GitHub plugin implemented in the EDP pipelines:</p> <pre><code>properties([pipelineTriggers([githubPush()])])\n\nnode {\n    git credentialsId: 'github-sshkey', url: 'https://github.com/someone/something.git', branch: 'master'\n}\n</code></pre> <p>Push events may not work correctly with the Job Pipeline script from SCM option in the current version of the GitHub plugin 1.34.1.</p> </li> </ol>"},{"location":"operator-guide/github-debug-webhooks/#related-articles","title":"Related Articles","text":"<ul> <li>GitHub Webhooks</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>GitHub Webhook Configuration</li> <li>Manage Jenkins CI Pipeline Job Provision</li> <li>GitHub Plugin</li> <li>GitHub Pull Request Builder</li> </ul>"},{"location":"operator-guide/github-integration/","title":"GitHub Webhook Configuration","text":"<p>Follow the steps below to automatically integrate Jenkins with GitHub webhooks.</p> <p>Note</p> <p>Before applying the GitHub integration, make sure you have already visited the Integrate GitHub/GitLab in Jenkins page.</p> <ol> <li> <p>Ensure the new job provisioner is created, as well as Secret with SSH key and GitServer custom resources.</p> </li> <li> <p>Ensure the access token for GitHub is created.</p> </li> <li> <p>Navigate to Dashboard -&gt; Manage Jenkins -&gt; Manage Credentials -&gt; Global -&gt; Add Credentials, and create new credentials with the Secret text kind. In the Secret field, provide the GitHub API token, fill in the ID field with the <code>github-access-token</code> value:</p> <p> Jenkins github credentials </p> </li> <li> <p>Navigate to Jenkins -&gt; Manage Jenkins -&gt; Configure system -&gt; GitHub, and configure the GitHub server:</p> <p> GitHub plugin config GitHub plugin Shared secrets config </p> <p>Note</p> <p>Keep the Manage hooks checkbox clear since the Job Provisioner automatically creates webhooks in the repository regardless of the checkbox selection. Select Advanced to see the shared secrets that can be used in a webhook Secret field to authenticate payloads from GitHub to Jenkins. The Secret field is optional.</p> </li> <li> <p>Configure the GitHub Pull Request Builder plugin. This plugin is responsible for listening on Pull Request webhook events and triggering Code Review jobs:</p> <p>Note</p> <p>The Secret field is optional and is used in a webhook Secret field to authenticate payloads from GitHub to Jenkins. For details, please refer to the official GitHub pull request builder plugin documentation.</p> <p> GitHub pull plugin config </p> </li> </ol>"},{"location":"operator-guide/github-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Adjust Jira Integration</li> <li>Manage Jenkins CI Pipeline Job Provision</li> </ul>"},{"location":"operator-guide/gitlab-debug-webhooks/","title":"Debug GitLab Webhooks in Jenkins","text":"<p>A webhook enables third-party services like GitLab to send real-time updates to the application. Updates are triggered by an event or action by the webhook provider (for example, a push to a repository, a Merge Request creation), and pushed to the application via the HTTP requests, namely, Jenkins. The GitLab Jenkins job provisioner creates a webhook in the GitLab repository during the Create release pipeline once the Integrate GitHub/GitLab in Jenkins is enabled and the GitLab Integration is completed.</p> <p>The Jenkins setup in EDP uses the GitLab plugin responsible for listening on GitLab webhook Push and Merge Request events.</p> <p>In case of any issues with webhooks, try the following solutions:</p> <ol> <li> <p>Check that the firewalls are configured to accept incoming traffic from the IP address range that is described in the GitLab documentation.</p> </li> <li> <p>Check that GitLab Personal Access Token is correct and has the api scope. If you have used the Project Access Token, make sure that the role is Owner or Maintainer, and it has the api scope.</p> </li> <li> <p>Check that the job has run at least once before using the hook (once an application is created in EDP, the build job should be run automatically in Jenkins).</p> </li> <li> <p>Check that both Push Events, Note Events and Merge Requests Events, Note Events webhooks are created on the GitLab side for each branch (unlike GitHub, GitLab must have separate webhooks for each branch).</p> <ul> <li>Go to the GitLab repository -&gt; Settings -&gt; Webhooks:</li> </ul> <p> Webhooks list </p> </li> <li> <p>Click Edit next to each webhook and check if the event delivery is successful. If the webhook is sent, the Recent Deliveries list becomes available. Click View details.</p> <p> Webhooks settings </p> <ul> <li>The URL payload must be similar to the job URL on Jenkins. For example: <code>https://jenkins-server.com/project/project-name/MAIN-Build-job</code> is for the Push events. <code>https://jenkins-server.com/project/project-name/MAIN-Code-review-job</code> is for the Merge Request events.</li> <li>The content type must be application/json for both events.</li> <li>The \"web_url\" in the Request body must match the repository URL.</li> <li>Project \"web_url\", \"path_with_namespace\", \"homepage\" links must be without .git at the end of the URL.</li> </ul> </li> <li> <p>Verify the Secret token (X-Gitlab-Token). This token comes from the Jenkins job due to the Jenkins GitLab Plugin and is created by our Job Provisioner:</p> <ul> <li>Go to the Jenkins job and select Configure.</li> <li>Select Advanced under the Build Triggers and check the Secret token.</li> </ul> <p>Secret token is optional and can be empty. Nevertheless, if incorrect, it can prevent webhook events.</p> </li> <li> <p>Redeliver events by clicking the Resend Request button and check the Response body.</p> <p>Note</p> <p>Use Postman to debug webhooks. Add all headers to Postman from the webhook Request Headers field and send the payload (Request body) using the appropriate content type.</p> <p>Examples for Push and Merge Request events:</p> <p> Postman push request payload headers Push request build pipeline </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 11:26:34 AM INFO com.dabsquared.gitlabjenkins.webhook.GitLabWebHook getDynamic\nWebHook call ed with url: /project/project-name/MAIN-Build-job\nJan 17, 2022 11:26:34 AM INFO com.dabsquared.gitlabjenkins.trigger.handler.AbstractWebHookTriggerHandler handle\nproject-name/MAIN-Build-job triggered for push.\n</code></pre> <p> Postman merge request payload headers Merge request code review pipeline </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 11:14:58 AM INFO com.dabsquared.gitlabjenkins.webhook.GitLabWebHook getDynamic\nWebHook called with url: /project/project-name/MAIN-Code-review-job\n</code></pre> </li> <li> <p>Check that the repository pushing to Jenkins and the repository(ies) in the pipeline Job are lined up. GitLab Connection must be defined in the job settings.</p> </li> <li> <p>Check that the settings in the Build Triggers for the Build job are as follows:</p> <p> Build triggers build pipeline </p> </li> <li> <p>Check that the settings in the Build Triggers for the Code Review job are as follows:</p> <p> Build triggers code review pipeline </p> </li> <li> <p>Filter through Jenkins log by using Jenkins custom log recorder:</p> <ul> <li>Go to Manage Jenkins -&gt; System Log -&gt; Add new log recorder.</li> <li> <p>The Push and Merge Request events for the GitLab:</p> Logger Log Level com.dabsquared.gitlabjenkins.webhook.GitLabWebHook ALL com.dabsquared.gitlabjenkins.trigger.handler.AbstractWebHookTriggerHandler ALL com.dabsquared.gitlabjenkins.trigger.handler.merge.MergeRequestHookTriggerHandlerImpl ALL com.dabsquared.gitlabjenkins.util.CommitStatusUpdater ALL </li> </ul> </li> </ol>"},{"location":"operator-guide/gitlab-debug-webhooks/#related-articles","title":"Related Articles","text":"<ul> <li>GitLab Webhooks</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Jenkins Integration With GitLab</li> <li>GitLab Integration</li> <li>Manage Jenkins CI Pipeline Job Provision</li> <li>GitLab Plugin</li> </ul>"},{"location":"operator-guide/gitlab-integration/","title":"GitLab Webhook Configuration","text":"<p>Follow the steps below to automatically create and integrate Jenkins GitLab webhooks.</p> <p>Note</p> <p>Before applying the GitLab integration, make sure to enable Integrate GitHub/GitLab in Jenkins. For details, please refer to the Integrate GitHub/GitLab in Jenkins page.</p> <ol> <li> <p>Ensure the new job provisioner is created, as well as Secret with SSH key and GitServer custom resources.</p> </li> <li> <p>Ensure the access token for GitLab is created.</p> </li> <li> <p>Create the Jenkins Credential ID by navigating to Dashboard -&gt; Manage Jenkins -&gt; Manage Credentials -&gt; Global -&gt; Add Credentials:</p> <ul> <li>Select the Secret text kind.</li> <li>Select the Global scope.</li> <li>Secret is the access token that was created earlier.</li> <li>ID is the gitlab-access-token ID.</li> <li>Use the description of the current Credential ID.</li> </ul> <p> Jenkins credential </p> <p>Warning</p> <p>When using the GitLab integration, a webhook is automatically created. After the removal of the application, the webhook stops working but is not deleted. If necessary, it must be deleted manually.</p> <p>Note</p> <p>The next step is necessary if it is needed to see the status of Jenkins Merge Requests builds in the GitLab CI/CD Pipelines section.</p> </li> <li> <p>In order to see the status of Jenkins Merge Requests builds in the GitLab CI/CD Pipelines section, configure the    GitLab plugin by navigating to Manage Jenkins -&gt; Configure System and filling in the GitLab plugin settings:</p> <ul> <li>Connection name is gitlab.</li> <li>GitLab host URL is a host URL to GitLab.</li> <li>Use the gitlab-access-token credentials.</li> </ul> <p> GitLab plugin configuration </p> <p>Find below an example of the Merge Requests build statuses in the GitLab CI/CD Pipelines section:</p> <p> GitLab pipelines statuses </p> </li> </ol>"},{"location":"operator-guide/gitlab-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Adjust Jira Integration</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Grant Jenkins Access to the Gitlab Project</li> <li>Manage Jenkins CI Pipeline Job Provision</li> </ul>"},{"location":"operator-guide/harbor-oidc/","title":"Harbor OIDC Configuration","text":"<p>This page provides instructions for configuring OIDC authorization for Harbor. This enables the use of Single Sign-On (SSO) for authorization in Harbor and allows centralized control over user access and rights through a single configuration point.</p>"},{"location":"operator-guide/harbor-oidc/#prerequisites","title":"Prerequisites","text":"<p>Before the beginning, ensure your cluster meets the following requirements:</p> <ul> <li>Keycloak is installed;</li> <li>EPAM Delivery Platform is installed.</li> </ul>"},{"location":"operator-guide/harbor-oidc/#configure-keycloak","title":"Configure Keycloak","text":"<p>To start from, configure Keycloak by creating two Kubernetes resources. Follow the steps below to succeed:</p> <ol> <li> <p>Generate the keycloak-client-harbor-secret for Keycloak using either the commands below or using the External Secrets Operator:</p> <pre><code>keycloak_client_harbor_secret=$(openssl rand -base64 32 | head -c 32)\n</code></pre> <pre><code>kubectl -n edp create secret generic keycloak-client-harbor-secret \\\n--from-literal=cookie-secret=${keycloak_client_harbor_secret}\n</code></pre> </li> <li> <p>Create the KeycloakClient custom resource by applying the HarborKeycloakClient.yaml file in the edp namespace. This custom resource will use the <code>keycloak-client-harbor-secret</code> to include the harbor client. After the download, you will receive the created harbor client, and the password that is actually the value of the Kubernetes secret from the step 1:</p> View: HarborKeycloakClient.yaml <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: harbor\nspec:\nadvancedProtocolMappers: true\nclientId: harbor\ndirectAccess: true\npublic: false\nsecret: keycloak-client-harbor-secret\ndefaultClientScopes:\n- profile\n- email\n- roles\ntargetRealm: control-plane\nwebUrl: &lt;harbor_endpoint&gt;\nprotocolMappers:\n- name: roles\nprotocol: openid-connect\nprotocolMapper: oidc-usermodel-realm-role-mapper\nconfig:\naccess.token.claim: true\nclaim.name: roles\nid.token.claim: true\nuserinfo.token.claim: true\nmultivalued: true\n</code></pre> </li> </ol>"},{"location":"operator-guide/harbor-oidc/#configure-harbor","title":"Configure Harbor","text":"<p>The next stage is to configure Harbor. Proceed with following the steps below:</p> <ol> <li> <p>Log in to Harbor UI with an account that has Harbor system administrator privileges. To get the administrator password, execute the command below:</p> <pre><code>kubectl get secret harbor -n harbor -o jsonpath='{.data.HARBOR_ADMIN_PASSWORD}' | base64 --decode\n</code></pre> </li> <li> <p>Navigate to Administration -&gt; Configuration -&gt; Authentication. Configure OIDC using the parameters below:</p> <pre><code>auth_mode: oidc_auth\noidc_name: keycloak\noidc_endpoint: &lt;keycloak_endpoint&gt;/auth/realms/control-plane\noidc_client_id: harbor\noidc_client_secret: &lt;keycloak-client-harbor-secret&gt;\noidc_groups_claim: roles\noidc_admin_group: administrator\noidc_scope: openid,email,profile,roles\nverify_certificate: true\noidc_auto_onboard: true\noidc_user_claim: preferred_username\n</code></pre> <p> Harbor Authentication Configuration </p> </li> </ol> <p>As a result, users will be prompted to authenticate themselves when logging in to Harbor UI.</p>"},{"location":"operator-guide/harbor-oidc/#related-articles","title":"Related Articles","text":"<ul> <li>Configure Access Token Lifetime</li> <li>EKS OIDC With Keycloak</li> <li>External Secrets Operator Integration</li> <li>Integrate Harbor With EDP Pipelines</li> </ul>"},{"location":"operator-guide/headlamp-oidc/","title":"Headlamp OIDC Configuration","text":"<p>This page provides the instructions of configuring the OIDC authorization for EDP Portal UI, thus allowing using SSO for authorization in Portal and controlling user access and rights from one configuration point.</p>"},{"location":"operator-guide/headlamp-oidc/#prerequisites","title":"Prerequisites","text":"<p>Ensure the following values are set first before starting the Portal OIDC configuration:</p> <ol> <li> <p><code>realm_id</code>  = openshift</p> </li> <li> <p><code>client_id</code> = kubernetes</p> </li> <li> <p><code>keycloak_client_key</code>= keycloak_client_secret_key (received from: <code>Openshift realm</code> -&gt; <code>clients</code> -&gt; <code>kubernetes</code> -&gt; <code>Credentials</code> -&gt; <code>Client secret</code>)</p> </li> <li> <p><code>group</code> = <code>edp-oidc-admins</code>, <code>edp-oidc-builders</code>, <code>edp-oidc-deployers</code>, <code>edp-oidc-developers</code>, <code>edp-oidc-viewers</code> (Should be created manually in the realm from point 1)</p> </li> </ol> <p>Note</p> <p>The values indicated above are the result of the Keycloak configuration as an OIDC identity provider. To receive them, follow the instructions on the Keycloak OIDC EKS Configuration page.</p>"},{"location":"operator-guide/headlamp-oidc/#configure-keycloak","title":"Configure Keycloak","text":"<p>To proceed with the Keycloak configuration, perform the following:</p> <ol> <li> <p>Add the URL of the Headlamp to the <code>valid_redirect_uris</code> variable in Keycloak:</p> View: keycloak_openid_client <pre><code>  valid_redirect_uris = [\n\"https://edp-headlamp-edp.&lt;dns_wildcard&gt;/*\"\n\"http://localhost:8000/*\"\n]\n</code></pre> <p>Make sure to define the following Keycloak client values as indicated:</p> <p> Keycloak client configuration </p> </li> <li> <p>Configure the Keycloak client key in Kubernetes using the Kubernetes secrets or the External Secrets Operator:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: keycloak-client-headlamp-secret\nnamespace: edp\ntype: Opaque\nstringData:\nclientSecret: &lt;keycloak_client_secret_key&gt;\n</code></pre> </li> <li> <p>Assign user to one or more groups in Keycloak.</p> </li> </ol>"},{"location":"operator-guide/headlamp-oidc/#integrate-headlamp-with-kubernetes","title":"Integrate Headlamp With Kubernetes","text":"<p>Headlamp can be integrated in Kubernetes in three steps:</p> <ol> <li> <p>Update the values.yaml file by enabling OIDC:</p> View: values.yaml <pre><code>edp-headlamp:\nconfig:\noidc:\nenabled: true\n</code></pre> </li> <li> <p>Navigate to Headlamp and log in by clicking the <code>Sign In</code> button:</p> <p> Headlamp login page </p> </li> <li> <p>Go to <code>EDP</code> section -&gt; <code>Account</code> -&gt; <code>Settings</code>, and set up a namespace:</p> <p> Headlamp namespace settings </p> </li> </ol> <p>As a result, it is possible to control access and rights from the Keycloak endpoint.</p>"},{"location":"operator-guide/headlamp-oidc/#related-articles","title":"Related Articles","text":"<ul> <li>Configure Access Token Lifetime</li> <li>EKS OIDC With Keycloak</li> <li>External Secrets Operator</li> </ul>"},{"location":"operator-guide/import-strategy-jenkins/","title":"Integrate GitHub/GitLab in Jenkins","text":"<p>This page describes how to integrate EDP with GitLab or GitHub in case of following the Jenkins deploy scenario.</p>"},{"location":"operator-guide/import-strategy-jenkins/#integration-procedure","title":"Integration Procedure","text":"<p>To start from, it is required to add both Secret with SSH key and GitServer custom resources by taking the steps below:</p> <ol> <li> <p>Generate an SSH key pair and add a public key to GitLab    or GitHub    account.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\"\n</code></pre> </li> <li> <p>Generate access token for GitLab    or GitHub    account with read/write access to the API. Both personal and project access tokens are applicable.</p> GitHubGitLab <p>To create access token in GitHub, follow the steps below:</p> <ul> <li>Log in to GitHub.</li> <li>Click the profile account and navigate to Settings -&gt; Developer Settings.</li> <li>Select Personal access tokens (classic) and generate a new token with the following parameters:</li> </ul> <p> Repo permission </p> <p>Note</p> <p>The access below is required for the GitHub Pull Request Builder plugin to get Pull Request commits, their status, and author info.</p> <p> Admin permission User permission </p> <p>Warning</p> <p>Make sure to save a new personal access token because it won`t be displayed later.</p> <p>To create access token in GitLab, follow the steps below:</p> <ul> <li>Log in to GitLab.</li> <li>In the top-right corner, click the avatar and select Settings.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Personal access tokens </p> <ul> <li>Click the Create personal access token button.</li> </ul> <p>Note</p> <p>Make sure to save the access token as there will not be any ability to access it once again.</p> <p>In case you want to create a project access token instead of a personal one, the GitLab Jenkins plugin will be able to accept payloads from webhooks for the project only:</p> <ul> <li>Log in to GitLab and navigate to the project.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>Choose a role: Owner or Maintainer.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Project access tokens </p> <ul> <li>Click the Create project access token button.</li> </ul> </li> <li> <p>Create secret in the <code>edp</code> namespace for the Git account with the id_rsa, username, and token fields. We recommend using EDP Portal to implement this:</p> <ul> <li> <p>Open EDP Portal URL. Use the Sign-In option:</p> <p> Logging screen </p> </li> </ul> <ul> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and set the <code>Default namespace</code>. The <code>Allowed namespaces</code> field is optional. All the resources created via EDP Portal are created in the <code>Default namespace</code> whereas <code>Allowed namespaces</code> means the namespaces you are allowed to access in this cluster:</p> <p> Cluster settings </p> </li> </ul> <ul> <li> <p>Log into EDP Portal UI, select <code>EDP</code> -&gt; <code>Git Servers</code> -&gt; <code>+</code> to see the <code>Create Git Server</code> menu:</p> <p> Git Servers overview </p> </li> </ul> <ul> <li> <p>Choose your Git provider, insert Host, Access token, Private SSH key. Adjust SSH port, User and HTTPS port if needed and click <code>Apply</code>:</p> <p>Note</p> <p>Do not forget to press enter at the very end of the private key to have the last row empty.</p> <p> Create Git Servers menu </p> </li> </ul> <ul> <li> <p>After performing the steps above, two Kubernetes custom resources will be created in the default namespace: secret and GitServer. EDP Portal appends random symbols to both the secret and the GitServer to provide names with uniqueness. Also, the attempt to connect to your actual Git server will be performed. If the connection with the server is established, the Git server status should be green:</p> <p> Git server status </p> <p>Note</p> <p>The value of the nameSshKeySecret property is the name of the Secret that is indicated in the first step above.</p> </li> </ul> </li> <li> <p>Create the <code>JenkinsServiceAccount</code> custom resource with the credentials field that corresponds to the nameSshKeySecret property above:</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: JenkinsServiceAccount\nmetadata:\nname: gitlab # It can also be github.\nnamespace: edp\nspec:\ncredentials: &lt;nameSshKeySecret&gt;\nownerName: ''\ntype: ssh\n</code></pre> </li> <li> <p>Double-check that the new SSH credentials called <code>gitlab</code>/<code>github</code> are created in Jenkins using the SSH key. Navigate to <code>Jenkins</code> -&gt; <code>Manage Jenkins</code> -&gt; <code>Manage Credentials</code> -&gt; <code>(global)</code>:</p> <p> Jenkins credentials </p> </li> <li> <p>Create a new job provisioner by following the instructions for GitHub or GitLab. The job provisioner will create a job suite for an application added to EDP. The job provisioner will also create webhooks for the project in GitLab using a GitLab token.</p> </li> <li> <p>Configure GitHub or GitLab plugins in Jenkins.</p> </li> </ol>"},{"location":"operator-guide/import-strategy-jenkins/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> </ul>"},{"location":"operator-guide/import-strategy-tekton/","title":"Integrate GitHub/GitLab in Tekton","text":"<p>This page describes how to integrate EDP with GitLab or GitHub Version Control System.</p> <p></p>"},{"location":"operator-guide/import-strategy-tekton/#integration-procedure","title":"Integration Procedure","text":"<p>To start from, it is required to add both Secret with SSH key, API token, and GitServer resources by taking the steps below.</p> <ol> <li> <p>Generate an SSH key pair and add a public key to GitLab    or GitHub    account.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\"\n</code></pre> </li> <li> <p>Generate access token for GitLab    or GitHub    account with read/write access to the API. Both personal and project access tokens are applicable.</p> GitHubGitLab <p>To create access token in GitHub, follow the steps below:</p> <ul> <li>Log in to GitHub.</li> <li>Click the profile account and navigate to Settings -&gt; Developer Settings.</li> <li>Select Personal access tokens (classic) and generate a new token with the following parameters:</li> </ul> <p> Repo permission </p> <p>Note</p> <p>The access below is required for the GitHub Pull Request Builder plugin to get Pull Request commits, their status, and author info.</p> <p> Admin permission User permission </p> <p>Warning</p> <p>Make sure to save a new personal access token because it won`t be displayed later.</p> <p>To create access token in GitLab, follow the steps below:</p> <ul> <li>Log in to GitLab.</li> <li>In the top-right corner, click the avatar and select Settings.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Personal access tokens </p> <ul> <li>Click the Create personal access token button.</li> </ul> <p>Note</p> <p>Make sure to save the access token as there will not be any ability to access it once again.</p> <p>In case you want to create a project access token instead of a personal one, take the following steps:</p> <ul> <li>Log in to GitLab and navigate to the project.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>Choose a role: Owner or Maintainer.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Project access tokens </p> <ul> <li>Click the Create project access token button.</li> </ul> </li> <li> <p>Create a secret in the <code>edp</code> namespace for the Git account with the id_rsa, username, and token fields. Take the following template as an example (use ci-github instead of ci-gitlab for GitHub):</p> <pre><code>kubectl create secret generic ci-gitlab -n edp \\\n--from-file=id_rsa=id_rsa \\\n--from-literal=username=git \\\n--from-literal=token=your_gitlab_access_token\n</code></pre> </li> </ol>"},{"location":"operator-guide/import-strategy-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>GitHub WebHook Configuration</li> <li>GitLab WebHook Configuration</li> </ul>"},{"location":"operator-guide/import-strategy/","title":"Enable VCS Import Strategy","text":"<p>Enabling the VCS Import strategy is a prerequisite to integrate EDP with GitLab or GitHub.</p>"},{"location":"operator-guide/import-strategy/#general-steps","title":"General Steps","text":"<p>In order to use the Import strategy, it is required to add both Secret with SSH key and GitServer custom resources by taking the steps below.</p> <ol> <li> <p>Generate an SSH key pair and add a public key to GitLab    or GitHub    account.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\"\n</code></pre> </li> <li> <p>Generate access token for GitLab    or GitHub    account with read/write access to the API. Both personal and project access tokens are applicable.</p> </li> </ol> GitHubGitLab <p>To create access token in GitHub, follow the steps below:</p> <ul> <li>Log in to GitHub.</li> <li>Click the profile account and navigate to Settings -&gt; Developer Settings.</li> <li>Select Personal access tokens (classic) and generate a new token with the following parameters:</li> </ul> <p> Repo permission </p> <p>Note</p> <p>The access below is required for the GitHub Pull Request Builder plugin to get Pull Request commits, their status, and author info.</p> <p> Admin permission User permission </p> <p>Warning</p> <p>Make sure to save a new personal access token because it won`t be displayed later.</p> <p>To create access token in GitLab, follow the steps below:</p> <ul> <li>Log in to GitLab.</li> <li>In the top-right corner, click the avatar and select Settings.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Personal access tokens </p> <ul> <li>Click the Create personal access token button.</li> </ul> <p>Note</p> <p>Make sure to save the access token as there will not be any ability to access it once again.</p> <p>In case you want to create a project access token instead of a personal one, the GitLab Jenkins plugin will be able to accept payloads from webhooks for the project only:</p> <ul> <li>Log in to GitLab and navigate to the project.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>Choose a role: Owner or Maintainer.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Project access tokens </p> <ul> <li>Click the Create project access token button.</li> </ul>"},{"location":"operator-guide/import-strategy/#ci-tool-specific-steps","title":"CI Tool Specific Steps","text":"<p>The further steps depend on the CI tool used.</p> Tekton CI toolJenkins CI tool <ol> <li> <p>Create a secret in the <code>edp-project</code> namespace for the Git account with the id_rsa, username, and token fields.   Take the following template as an example (use github instead of gitlab for GitHub):</p> <pre><code>kubectl create secret generic gitlab -n edp \\\n--from-file=id_rsa=id_rsa \\\n--from-literal=username=git \\\n--from-literal=token=your_gitlab_access_token\n</code></pre> </li> <li> <p>After completing the steps above, you can get back and continue installing EDP.</p> </li> </ol> <ol> <li> <p>Create secret in the <code>edp</code> namespace for the Git account with the id_rsa, username, and token fields. We recommend using EDP Portal to implement this:</p> <p>Open EDP Portal URL. Use the Sign-In option:</p> <p> Logging screen </p> <p>In the top right corner, enter the <code>Cluster settings</code> and set the <code>Default namespace</code>. The <code>Allowed namespaces</code> field is optional. All the resources created via EDP Portal are created in the <code>Default namespace</code> whereas <code>Allowed namespaces</code> means the namespaces you are allowed to access in this cluster:</p> <p> Cluster settings </p> <p>Log into EDP Portal UI, select <code>EDP</code> -&gt; <code>Git Servers</code> -&gt; <code>+</code> to see the <code>Create Git Server</code> menu:</p> <p> Git Servers overview </p> <p>Choose your Git provider, insert Host, Access token, Private SSH key. Adjust SSH port, User and HTTPS port if needed and click <code>Apply</code>:</p> <p>Note</p> <p>Do not forget to press enter at the very end of the private key to have the last row empty.</p> <p> Create Git Servers menu </p> <p>When everything is done, two custom resources will be created in the default namespace: secret and Git server. EDP Portal appends random symbols to both the secret and the server to provide names with uniqueness. Also, the attempt to connect to your Git server will be performed. If everything is correct, the Git server status should be green:</p> <p> Git server status </p> <p>Note</p> <p>The value of the nameSshKeySecret property is the name of the Secret that is indicated in the first step above.</p> </li> <li> <p>Create the <code>JenkinsServiceAccount</code> custom resource with the credentials field that corresponds to the nameSshKeySecret property above:</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: JenkinsServiceAccount\nmetadata:\nname: gitlab # It can also be github.\nnamespace: edp\nspec:\ncredentials: &lt;nameSshKeySecret&gt;\nownerName: ''\ntype: ssh\n</code></pre> </li> <li> <p>Double-check that the new SSH credentials called <code>gitlab</code>/<code>github</code> are created in Jenkins using the SSH key. Navigate to <code>Jenkins</code> -&gt; <code>Manage Jenkins</code> -&gt; <code>Manage Credentials</code> -&gt; <code>(global)</code>:</p> <p> Jenkins credentials </p> </li> <li> <p>The next step is to create a new job provisioner by following the instructions for GitHub or GitLab. The job provisioner will create a job suite for an application added to EDP. It will also create webhooks for the project in GitLab using a GitLab token.</p> </li> <li> <p>The next step is to integrate Jenkins with GitHub or GitLab by setting their plugins.</p> </li> </ol>"},{"location":"operator-guide/import-strategy/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> </ul>"},{"location":"operator-guide/install-argocd/","title":"Install Argo CD","text":"<p>Inspect the prerequisites and the main steps to perform for enabling Argo CD in EDP.</p>"},{"location":"operator-guide/install-argocd/#prerequisites","title":"Prerequisites","text":"<p>The following tools must be installed:</p> <ul> <li>Keycloak</li> <li>EDP</li> <li>Kubectl version 1.23.0</li> <li>Helm version 3.10.0</li> </ul>"},{"location":"operator-guide/install-argocd/#installation","title":"Installation","text":"<p>Argo CD enablement for EDP consists of two major steps:</p> <ul> <li>Argo CD integration with EDP (SSO enablement, codebase onboarding, etc.)</li> <li>Argo CD installation</li> </ul> <p>Info</p> <p>It is also possible to install Argo CD using the Helmfile. For details, please refer to the Install via Helmfile page.</p>"},{"location":"operator-guide/install-argocd/#integrate-with-edp","title":"Integrate With EDP","text":"<p>To enable Argo CD integration, ensure that the <code>argocd.enabled</code> flag values.yaml is set to <code>true</code></p>"},{"location":"operator-guide/install-argocd/#install-with-helm","title":"Install With Helm","text":"<p>Argo CD can be installed in several ways, please follow the official documentation for more details.</p> <p>Follow the steps below to install Argo CD using Helm:</p> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, apply the <code>SecurityContextConstraints</code> resource. Change the namespace in the <code>users</code> section if required.</p> <p> View: argocd-scc.yaml <p><pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 99\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: argo-redis-ha\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nseccompProfiles:\n- '*'\nusers:\n- system:serviceaccount:argocd:argo-redis-ha\n- system:serviceaccount:argocd:argo-redis-ha-haproxy\n- system:serviceaccount:argocd:argocd-notifications-controller\n- system:serviceaccount:argocd:argo-argocd-repo-server\n- system:serviceaccount:argocd:argocd-server\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </p> <ol> <li> <p>Check out the values.yaml file sample of the Argo CD customization, which is based on the <code>HA mode without autoscaling</code>:</p> View: kubernetes-values.yaml <pre><code>redis-ha:\nenabled: true\n\ncontroller:\nenableStatefulSet: true\n\nserver:\nreplicas: 2\nextraArgs:\n- \"--insecure\"\nenv:\n- name: ARGOCD_API_SERVER_REPLICAS\nvalue: '2'\ningress:\nenabled: true\nhosts:\n- \"argocd.&lt;Values.global.dnsWildCard&gt;\"\nconfig:\n# required when SSO is enabled\nurl: \"https://argocd.&lt;.Values.global.dnsWildCard&gt;\"\napplication.instanceLabelKey: argocd.argoproj.io/instance-edp\noidc.config: |\nname: Keycloak\nissuer: https://&lt;.Values.global.keycloakEndpoint&gt;/auth/realms/edp-main\nclientID: argocd\nclientSecret: $oidc.keycloak.clientSecret\nrequestedScopes:\n- openid\n- profile\n- email\n- groups\nrbacConfig:\n# users may be still be able to login,\n# but will see no apps, projects, etc...\npolicy.default: ''\nscopes: '[groups]'\npolicy.csv: |\n# default global admins\ng, ArgoCDAdmins, role:admin\n\nconfigs:\nparams:\napplication.namespaces: edp\n\nrepoServer:\nreplicas: 2\n\n# we use Keycloak so no DEX is required\ndex:\nenabled: false\n\n# Disabled for multitenancy env with single instance deployment\napplicationSet:\nenabled: false\n</code></pre> View: openshift-values.yaml <pre><code>redis-ha:\nenabled: true\n\ncontroller:\nenableStatefulSet: true\n\nserver:\nreplicas: 2\nextraArgs:\n- \"--insecure\"\nenv:\n- name: ARGOCD_API_SERVER_REPLICAS\nvalue: '2'\nroute:\nenabled: true\nhostname: \"argocd.&lt;.Values.global.dnsWildCard&gt;\"\ntermination_type: edge\ntermination_policy: Redirect\nconfig:\n# required when SSO is enabled\nurl: \"https://argocd.&lt;.Values.global.dnsWildCard&gt;\"\napplication.instanceLabelKey: argocd.argoproj.io/instance-edp\noidc.config: |\nname: Keycloak\nissuer: https://&lt;.Values.global.keycloakEndpoint&gt;/auth/realms/edp-main\nclientID: argocd\nclientSecret: $oidc.keycloak.clientSecret\nrequestedScopes:\n- openid\n- profile\n- email\n- groups\nrbacConfig:\n# users may be still be able to login,\n# but will see no apps, projects, etc...\npolicy.default: ''\nscopes: '[groups]'\npolicy.csv: |\n# default global admins\ng, ArgoCDAdmins, role:admin\n\nconfigs:\nparams:\napplication.namespaces: edp\n\nrepoServer:\nreplicas: 2\n\n# we use Keycloak so no DEX is required\ndex:\nenabled: false\n\n# Disabled for multitenancy env with single instance deployment\napplicationSet:\nenabled: false\n</code></pre> <p>Populate Argo CD values with the values from the EDP values.yaml:</p> <ul> <li>&lt;.Values.global.dnsWildCard&gt; is the EDP DNS WildCard.</li> <li>&lt;.Values.global.keycloakEndpoint&gt; is the Keycloak Hostname.</li> <li>We use <code>edp</code> namespace.</li> </ul> </li> <li> <p>Run the installation:</p> <pre><code>kubectl create ns argocd\nhelm repo add argo https://argoproj.github.io/argo-helm\nhelm install argo --version 5.33.1 argo/argo-cd -f values.yaml -n argocd\n</code></pre> </li> <li> <p>Update the <code>argocd-secret</code> secret in the <code>argocd</code> namespace by providing the correct Keycloak client secret (<code>oidc.keycloak.clientSecret</code>)    with the value from the <code>keycloak-client-argocd-secret</code> secret in the EDP namespace. Then restart the deployment:</p> <pre><code>ARGOCD_CLIENT=$(kubectl -n edp get secret keycloak-client-argocd-secret  -o jsonpath='{.data.clientSecret}')\nkubectl -n argocd patch secret argocd-secret -p=\"{\\\"data\\\":{\\\"oidc.keycloak.clientSecret\\\": \\\"${ARGOCD_CLIENT}\\\"}}\" -v=1\nkubectl -n argocd rollout restart deployment argo-argocd-server\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-argocd/#related-articles","title":"Related Articles","text":"<ul> <li>Argo CD Integration</li> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/install-defectdojo/","title":"Install DefectDojo","text":"<p>Inspect the main steps to perform for installing DefectDojo via Helm Chart.</p> <p>Info</p> <p>It is also possible to install DefectDojo using the EDP addons approach. For details, please refer to the EDP addons approach.</p>"},{"location":"operator-guide/install-defectdojo/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/install-defectdojo/#installation","title":"Installation","text":"<p>Info</p> <p>Please refer to the DefectDojo Helm Chart and Deploy DefectDojo into the Kubernetes cluster sections for details.</p> <p>To install DefectDojo, follow the steps below:</p> <ol> <li> <p>Check that a security namespace is created. If not, run the following command to create it:</p> <pre><code>kubectl create namespace defectdojo\n</code></pre> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, install the <code>SecurityContextConstraints</code> resource. In case of using a custom namespace for <code>defectdojo</code>, change the namespace in the <code>users</code> section.</p> <p> View: defectdojo-scc.yaml <p><pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: defectdojo\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:defectdojo:defectdojo\n- system:serviceaccount:defectdojo:defectdojo-rabbitmq\n- system:serviceaccount:defectdojo:default\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </p> <li> <p>Add a chart repository:</p> <pre><code>helm repo add defectdojo 'https://raw.githubusercontent.com/DefectDojo/django-DefectDojo/helm-charts'\nhelm repo update\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-postgresql-specific \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Note</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Create Rabbitmq admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-rabbitmq-specific \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Note</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long.</p> <p>The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Create DefectDojo admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo \\\n--from-literal=DD_ADMIN_PASSWORD=&lt;dd_admin_password&gt; \\\n--from-literal=DD_SECRET_KEY=&lt;dd_secret_key&gt; \\\n--from-literal=DD_CREDENTIAL_AES_256_KEY=&lt;dd_credential_aes_256_key&gt; \\\n--from-literal=METRICS_HTTP_AUTH_PASSWORD=&lt;metric_http_auth_password&gt;\n</code></pre> <p>Note</p> <p>The <code>dd_admin_password</code> password must be 22 characters long.</p> <p>The <code>dd_secret_key</code> password must be 128 characters long.</p> <p>The <code>dd_credential_aes_256_key</code> password must be 128 characters long.</p> <p>The <code>metric_http_auth_password</code> password must be 32 characters long.</p> </li> <li> <p>Install DefectDojo v.2.22.4 using defectdojo/defectdojo Helm chart v.1.6.69:</p> <pre><code>helm upgrade --install \\\ndefectdojo \\\n--version 1.6.69 \\\ndefectdojo/defectdojo \\\n--namespace defectdojo \\\n--values values.yaml\n</code></pre> <p>Check out the values.yaml file sample of the DefectDojo customization:</p> View: values.yaml <pre><code>tag: 2.22.4\nfullnameOverride: defectdojo\nhost: defectdojo.&lt;ROOT_DOMAIN&gt;\nsite_url: https://defectdojo.&lt;ROOT_DOMAIN&gt;\nalternativeHosts:\n- defectdojo-django.defectdojo\n\ninitializer:\n# should be false after initial installation was performed\nrun: true\ndjango:\ningress:\nenabled: true # change to 'false' for OpenShift\nactivateTLS: false\nuwsgi:\nlivenessProbe:\n# Enable liveness checks on uwsgi container. Those values are use on nginx readiness checks as well.\n# default value is 120, so in our case 20 is just fine\ninitialDelaySeconds: 20\n</code></pre> </li> <li> <p>For the OpenShift platform, install a Route:</p> View: defectdojo-route.yaml <pre><code>kind: Route\napiVersion: route.openshift.io/v1\nmetadata:\nname: defectdojo\nnamespace: defectdojo\nspec:\nhost: defectdojo.&lt;ROOT_DOMAIN&gt;\npath: /\ntls:\ninsecureEdgeTerminationPolicy: Redirect\ntermination: edge\nto:\nkind: Service\nname: defectdojo-django\nport:\ntargetPort: http\nwildcardPolicy: None\n</code></pre> </li>"},{"location":"operator-guide/install-defectdojo/#configuration","title":"Configuration","text":"<p>To prepare DefectDojo for integration with EDP, follow the steps below:</p> <ol> <li> <p>Create ci user in DefectDojo UI:</p> <ul> <li>Login to DefectDojo UI using admin credentials:  <pre><code>echo \"DefectDojo admin password: $(kubectl \\\nget secret defectdojo \\\n--namespace=defectdojo \\\n--output jsonpath='{.data.DD_ADMIN_PASSWORD}' \\\n| base64 --decode)\"\n</code></pre></li> <li>Go to User section</li> </ul> <ul> <li>Create new user with write permission: DefectDojo set user permission </li> </ul> </li> <li> <p>Get a token of the DefectDojo user:</p> <ul> <li>Login to the DefectDojo UI using the credentials from previous steps.</li> </ul> <ul> <li>Go to the API v2 key (token).</li> </ul> <ul> <li>Copy the API key.</li> </ul> </li> <li> <p>Provision the secret using <code>EDP Portal</code>, <code>Manifest</code> or with the <code>externalSecrets</code> operator:</p> </li> </ol> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; DefectDojo. Update or fill in the URL and Token and click the Save button.</p> <p> DefectDojo update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-defectdojo\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: defectdojo\nstringData:\nurl: https://defectdojo.example.com\ntoken: &lt;token&gt;\n</code></pre> <p>Store defectdojo URL and Token in AWS Parameter Store with following format:</p> <p><pre><code>\"ci-defectdojo\":\n{\n\"url\": \"https://defectdojo.example.com\",\n\"token\": \"XXXXXXXXXXXX\"\n}\n</code></pre> Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; DefectDojo and see the <code>Managed by External Secret</code> message.</p> <p>More details about the External Secrets Operator integration procedure can be found in the External Secrets Operator Integration page.</p> <p>After following the instructions provided, you should be able to integrate your DefectDojo with the EPAM Delivery Platform using one of the few available scenarios.</p>"},{"location":"operator-guide/install-defectdojo/#related-articles","title":"Related Articles","text":"<ul> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Install Harbor</li> </ul>"},{"location":"operator-guide/install-edp/","title":"Install EDP","text":"<p>Inspect the main steps to install EPAM Delivery Platform. Please check the Prerequisites Overview page before starting the installation. There are two recommended ways to deploy EPAM Delivery Platform:</p> <ul> <li>Using Helm (see below);</li> <li>Using Argo CD GitOps approach;</li> <li>Using AWS Marketplace.</li> </ul> <p>Note</p> <p>The installation process below is given for a Kubernetes cluster. The steps that differ for an OpenShift cluster are indicated in the notes.</p> <p>Disclaimer</p> <p>EDP is aligned with industry standards for storing and managing sensitive data, ensuring optimal security. However, the use of custom solutions introduces uncertainties, thus the responsibility for the safety of your data is totally covered by platform administrator.</p> <ol> <li> <p>EDP manages secrets via External Secret Operator to integrate with a multitude of utilities. For insights into the secrets in use and their utilization, refer to the provided External Secrets Operator Integration.</p> </li> <li> <p>Create an edp namespace or a Kiosk space depending on whether Kiosk is used or not.</p> <ul> <li> <p>Without Kiosk, create a namespace:</p> <pre><code>kubectl create namespace edp\n</code></pre> <p>Note</p> <p>For an OpenShift cluster, run the <code>oc</code> command instead of the <code>kubectl</code> one.</p> </li> </ul> <ul> <li> <p>With Kiosk, create a relevant space:</p> <pre><code>apiVersion: tenancy.kiosk.sh/v1alpha1\nkind: Space\nmetadata:\nname: edp\nspec:\naccount: edp-admin\n</code></pre> </li> </ul> <p>Note</p> <p>Kiosk is mandatory for EDP v.2.8.x. It is not implemented for the previous versions, and is optional for EDP since v.2.9.x.</p> </li> <li> <p>(Optional) Deploy and configure Keycloak to enable Single Sign-On approach. To see the details on how to configure Keycloak correctly, please refer to the Install Keycloak page.</p> </li> <li> <p>Add the Helm charts repository:</p> <pre><code>helm repo add epamedp https://epam.github.io/edp-helm-charts/stable\n</code></pre> </li> <li> <p>Choose the required Helm chart version:</p> <pre><code>helm search repo epamedp/edp-install\nNAME                    CHART VERSION   APP VERSION     DESCRIPTION\nepamedp/edp-install     3.5.3           3.5.3           A Helm chart for EDP Install\n</code></pre> <p>Note</p> <p>It is highly recommended to use the latest released version.</p> </li> <li> <p>EDP can be integrated with the following version control systems:</p> <ul> <li>Gerrit</li> <li>GitHub (by default)</li> <li>GitLab</li> </ul> <p>This integration implies in what system the development of the application will be or is already being carried out. The <code>global.gitProvider</code> flag in the edp-install controls this integration:</p> GerritGitHub (by default)GitLab values.yaml<pre><code>...\nglobal:\ngitProvider: gerrit\n...\n</code></pre> values.yaml<pre><code>...\nglobal:\ngitProvider: github\n...\n</code></pre> values.yaml<pre><code>...\nglobal:\ngitProvider: gitlab\n...\n</code></pre> <p>Internal Gerrit server can be deployed as a result of EDP deployment. For more details on how to integrate EDP with GitLab or GitHub instead of Gerrit, please refer to the Integrate GitHub/GitLab in Tekton page.</p> </li> <li> <p>(Optional) Integrate platform with SonarQube:</p> <ul> <li>External SonarQube - any SonarQube that is installed separately from EDP. For example, SonarQube that is installed using edp-cluster-add-ons or another public SonarQube server. For more details on how EDP recommends to configure SonarQube to work with the platform, please refer to the SonarQube Integration page.</li> </ul> <ul> <li>Internal SonarQube - SonarQube that is installed along with EDP.values.yaml<pre><code>...\nsonar-operator:\nenabled: true\n...\n</code></pre> </li> </ul> </li> <li> <p>(Optional) Integrate platform with Nexus:</p> <ul> <li>External Nexus - any Nexus that is installed separately from EDP. For example, Nexus that installed using edp-cluster-add-ons or another public Nexus server. For more details on how EDP recommends to configure Nexus to work with the platform, please refer to the Nexus Sonatype Integration page.</li> </ul> <ul> <li>Internal Nexus - Nexus that is installed along with EDP.values.yaml<pre><code>...\nnexus-operator:\nenabled: true\n...\n</code></pre> </li> </ul> </li> <li> <p>(Optional) Configure Container Registry for image storage.</p> <p>Since EDP v3.4.0, we enabled users to configure Harbor registry instead of AWS ECR and Openshift-registry. We recommend installing Harbor using our edp-cluster-add-ons although you can install it any other way. To integrate EDP with Harbor, see Harbor integration page.</p> <p>To enable Harbor as a registry storage, use the values below: <pre><code>global:\ndockerRegistry:\ntype: \"harbor\"\nurl: \"harbor.example.com\"\n</code></pre></p> </li> <li> <p>Check the parameters in the EDP installation chart. For details, please refer to the values.yaml file.</p> </li> <li> <p>Install EDP in the edp namespace with the Helm tool:</p> <pre><code>helm install edp epamedp/edp-install --wait --timeout=900s \\\n--version &lt;edp_version&gt; \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>See the details on the parameters below:</p> Example values.yaml file<pre><code>global:\n# -- platform type that can be either \"kubernetes\" or \"openshift\"\nplatform: \"kubernetes\"\n# DNS wildcard for routing in the Kubernetes cluster;\ndnsWildCard: \"example.com\"\n# -- Administrators of your tenant\n# -- Can be gerrit, github or gitlab. By default: github\ngitProvider: github\ndockerRegistry:\n# -- Docker Registry endpoint\nurl: \"&lt;AWS_ACCOUNT_ID&gt;.dkr.ecr.&lt;AWS_REGION&gt;.amazonaws.com\"\ntype: \"ecr\"\n\nsso:\nenabled: false\n# Keycloak address with which the platform will be integrated\nkeycloakUrl: \"https://keycloak.example.com\"\nadmins:\n- \"stub_user_one@example.com\"\ndevelopers:\n- \"stub_user_one@example.com\"\n- \"stub_user_two@example.com\"\n\n# AWS Region, e.g. \"eu-central-1\"\nawsRegion:\n\nargocd:\n# -- Enable ArgoCD integration\nenabled: true\n# -- ArgoCD URL in format schema://URI\n# -- By default, https://argocd.{{ .Values.global.dnsWildCard }}\nurl: \"\"\n\nedp-tekton:\n# Tekton Kaniko configuration section\nkaniko:\n# -- AWS IAM role to be used for kaniko pod service account (IRSA). Format: arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/&lt;AWS_IAM_ROLE_NAME&gt;\nroleArn:\n\nedp-headlamp:\nconfig:\noidc:\nenabled: false\n</code></pre> <p>Note</p> <p>Set <code>global.platform=openshift</code> while deploying EDP in OpenShift.</p> <p>Info</p> <p>The full installation with integration between tools will take at least 10 minutes.</p> </li> <li> <p>To check if the installation is successful, run the command below:</p> <p><pre><code>helm status edp -n edp\n</code></pre>   You can also check ingress endpoints to get EDP Portal endpoint to enter EDP Portal UI:   <pre><code>kubectl describe ingress -n edp\n</code></pre></p> </li> <li> <p>Once EDP is successfully installed, you can navigate to our Use Cases to try out EDP functionality.</p> </li> </ol>"},{"location":"operator-guide/install-edp/#related-articles","title":"Related Articles","text":"<ul> <li>Quick Start</li> <li>Install EDP via Helmfile</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> <li>Set Up Kubernetes</li> <li>Set Up OpenShift</li> <li>EDP Installation Prerequisites Overview</li> <li>Headlamp OIDC Integration</li> </ul>"},{"location":"operator-guide/install-external-secrets-operator/","title":"Install External Secrets Operator","text":"<p>Inspect the prerequisites and the main steps to perform for enabling External Secrets Operator in EDP.</p>"},{"location":"operator-guide/install-external-secrets-operator/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.0+ is installed. Please refer to the Helm page on GitHub for details.</li> </ul>"},{"location":"operator-guide/install-external-secrets-operator/#installation","title":"Installation","text":"<p>To install External Secrets Operator with Helm, run the following commands:</p> <pre><code>helm repo add external-secrets https://charts.external-secrets.io\n\nhelm install external-secrets \\\nexternal-secrets/external-secrets \\\n--version 0.8.3 \\\n-n external-secrets \\\n--create-namespace\n</code></pre> <p>Info</p> <p>It is also possible to install External Secrets Operator using the Helmfile or Operator Lifecycle Manager (OLM).</p>"},{"location":"operator-guide/install-external-secrets-operator/#related-articles","title":"Related Articles","text":"<ul> <li>External Secrets Operator Integration</li> <li>Install Harbor</li> </ul>"},{"location":"operator-guide/install-harbor/","title":"Install Harbor","text":"<p>EPAM Delivery Platform uses Harbor as a storage for application images that are created when building applications.</p> <p>Inspect the prerequisites and the main steps to perform for enabling Harbor in EDP.</p>"},{"location":"operator-guide/install-harbor/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/install-harbor/#installation","title":"Installation","text":"<p>To install Harbor with Helm, follow the steps below:</p> <ol> <li> <p>Create a namespace for Harbor:</p> <pre><code>kubectl create namespace harbor\n</code></pre> </li> <li> <p>Create a secret for administrator user and registry:</p> ManuallyExternal Secret Operator <pre><code>kubectl create secret generic harbor \\\n--from-literal=HARBOR_ADMIN_PASSWORD=&lt;secret&gt; \\\n--from-literal=REGISTRY_HTPASSWD=&lt;secret&gt; \\\n--from-literal=REGISTRY_PASSWD=&lt;secret&gt; \\\n--from-literal=secretKey=&lt;secret&gt; \\\n--namespace harbor\n</code></pre> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: ExternalSecret\nmetadata:\nname: harbor\nnamespace: harbor\nspec:\nrefreshInterval: 1h\nsecretStoreRef:\nkind: SecretStore\nname: aws-parameterstore\ndata:\n- secretKey: HARBOR_ADMIN_PASSWORD\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.HARBOR_ADMIN_PASSWORD\n- secretKey: secretKey\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.secretKey\n- secretKey: REGISTRY_HTPASSWD\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.REGISTRY_HTPASSWD\n- secretKey: REGISTRY_PASSWD\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.REGISTRY_PASSWD\n</code></pre> <p>Note</p> <p>The <code>HARBOR_ADMIN_PASSWORD</code> is the initial password of Harbor admin. The <code>secretKey</code> is the secret key that is used for encryption. Must be 16 characters long. The <code>REGISTRY_PASSWD</code> is Harbor registry password. The <code>REGISTRY_HTPASSWD</code> is login and password in htpasswd string format. This value is the string in the password file generated by the <code>htpasswd</code> command where the username is <code>harbor_registry_user</code> and the encryption type is <code>bcrypt</code>. See the example below: <pre><code>htpasswd -bBc passwordfile harbor_registry_user harbor_registry_password\n</code></pre> The username must be <code>harbor_registry_user</code>. The password must be the value from <code>REGISTRY_PASSWD</code>.</p> </li> <li> <p>Add the Helm Harbor Charts for the local client.</p> <pre><code>helm repo add harbor https://helm.goharbor.io\n</code></pre> </li> <li> <p>Check the parameters in the Harbor installation chart. For details, please refer to    the values.yaml file.</p> </li> <li> <p>Install Harbor in the \u2039harbor\u203a namespace with the Helm tool.</p> <pre><code>helm install harbor harbor/harbor\n    --version 1.12.2 \\\n--namespace harbor \\\n--values values.yaml\n</code></pre> <p>See the details on the parameters below:</p> <p>Example values.yaml file</p> <pre><code># we use Harbor secret to consolidate all the Harbor secrets\nexistingSecretAdminPassword: harbor\nexistingSecretAdminPasswordKey: HARBOR_ADMIN_PASSWORD\nexistingSecretSecretKey: harbor\n\ncore:\n# The XSRF key. Will be generated automatically if it isn't specified\nxsrfKey: \"\"\njobservice:\n# Secret is used when job service communicates with other components.\n# If a secret key is not specified, Helm will generate one.\n# Must be a string of 16 chars.\nsecret: \"\"\nregistry:\n# Secret is used to secure the upload state from client\n# and registry storage backend.\n# If a secret key is not specified, Helm will generate one.\n# Must be a string of 16 chars.\nsecret: \"\"\ncredentials:\nusername: harbor_registry_user\nexistingSecret: harbor\nfullnameOverride: harbor\n# If Harbor is deployed behind the proxy, set it as the URL of proxy\nexternalURL: https://core.harbor.domain\nipFamily:\nipv6:\nenabled: false\nexpose:\ntls:\nenabled: false\ningress:\nhosts:\ncore: core.harbor.domain\nnotary: notary.harbor.domain\nupdateStrategy:\ntype: Recreate\npersistence:\npersistentVolumeClaim:\nregistry:\nsize: 30Gi\njobservice:\njobLog:\nsize: 1Gi\ndatabase:\nsize: 2Gi\nredis:\nsize: 1Gi\ntrivy:\nsize: 5Gi\ndatabase:\ninternal:\n# The initial superuser password for internal database\npassword: \"changeit\"\n</code></pre> </li> <li> <p>To check if the installation is successful, run the command below:</p> <p><pre><code>helm status &lt;harbor-release&gt; -n harbor\n</code></pre>   You can also check ingress endpoints to get Harbor endpoint to enter Harbor UI:   <pre><code>kubectl describe ingress &lt;harbor_ingress&gt; -n harbor\n</code></pre></p> </li> </ol>"},{"location":"operator-guide/install-harbor/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Integrate Harbor With EDP Pipelines</li> </ul>"},{"location":"operator-guide/install-ingress-nginx/","title":"Install NGINX Ingress Controller","text":"<p>Inspect the prerequisites and the main steps to perform for installing Install NGINX Ingress Controller on Kubernetes.</p>"},{"location":"operator-guide/install-ingress-nginx/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.2 is installed. Please refer to the Helm page on GitHub for details.</li> </ul>"},{"location":"operator-guide/install-ingress-nginx/#installation","title":"Installation","text":"<p>Info</p> <p>It is also possible to install NGINX Ingress Controller using the Helmfile. For details, please refer to the Install via Helmfile page.</p> <p>To install the ingress-nginx chart, follow the steps below:</p> <ol> <li> <p>Create an ingress-nginx namespace:</p> <pre><code>kubectl create namespace ingress-nginx\n</code></pre> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx\nhelm repo update\n</code></pre> </li> <li> <p>Install the ingress-nginx chart:</p> <pre><code>helm install ingress ingress-nginx/ingress-nginx \\\n--version 4.7.0 \\\n--values values.yaml \\\n--namespace ingress-nginx\n</code></pre> <p>Check out the values.yaml file sample of the ingress-nginx chart customization:</p> </li> </ol> View: values.yaml <pre><code>controller:\naddHeaders:\nX-Content-Type-Options: nosniff\nX-Frame-Options: SAMEORIGIN\nresources:\nlimits:\nmemory: \"256Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"128M\"\nconfig:\nssl-redirect: 'true'\nclient-header-buffer-size: '64k'\nhttp2-max-field-size: '64k'\nhttp2-max-header-size: '64k'\nlarge-client-header-buffers: '4 64k'\nupstream-keepalive-timeout: '120'\nkeep-alive: '10'\nuse-forwarded-headers: 'true'\nproxy-real-ip-cidr: '172.32.0.0/16'\nproxy-buffer-size: '8k'\n\n# To watch Ingress objects without the ingressClassName field set parameter value to true.\n# https://kubernetes.github.io/ingress-nginx/#i-have-only-one-ingress-controller-in-my-cluster-what-should-i-do\nwatchIngressWithoutClass: true\n\nservice:\ntype: NodePort\nnodePorts:\nhttp: 32080\nhttps: 32443\nupdateStrategy:\nrollingUpdate:\nmaxUnavailable: 1\ntype: RollingUpdate\nmetrics:\nenabled: true\ndefaultBackend:\nenabled: true\nserviceAccount:\ncreate: true\nname: nginx-ingress-service-account\n</code></pre> <p>Warning</p> <p>Align value controller.config.proxy-real-ip-cidr with AWS VPC CIDR.</p>"},{"location":"operator-guide/install-keycloak/","title":"Install Keycloak","text":"<p>Inspect the prerequisites and the main steps to perform for installing Keycloak.</p> <p>Info</p> <p>The installation process below is given for a Kubernetes cluster. The steps that differ for an OpenShift cluster are indicated in the warnings blocks.</p>"},{"location":"operator-guide/install-keycloak/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.0+ is installed. Please refer to the Helm page on GitHub for details.</li> </ul> <p>Info</p> <p>EDP team is using a Keycloakx helm chart from the codecentric repository, but other repositories can be used as well (e.g. Bitnami). Before installing Keycloak, it is necessary to install a PostgreSQL database.</p> <p>Info</p> <p>It is also possible to install Keycloak using the Helmfile. For details, please refer to the Install via Helmfile page.</p>"},{"location":"operator-guide/install-keycloak/#postgresql-installation","title":"PostgreSQL Installation","text":"<p>To install PostgreSQL, follow the steps below:</p> <ol> <li> <p>Check that a security namespace is created. If not, run the following command to create it:</p> <pre><code>kubectl create namespace security\n</code></pre> <p>Warning</p> <p>On the OpenShift platform, apply the <code>SecurityContextConstraints</code> resource. Change the namespace in the <code>users</code> section if required.</p> View: keycloak-scc.yaml <pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: keycloak\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:security:keycloakx\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> View: postgresql-keycloak-scc.yaml <pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: postgresql-keycloak\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:security:default\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-postgresql \\\n--from-literal=password=&lt;postgresql_password&gt; \\\n--from-literal=postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> </li> <li> <p>Add a helm chart repository:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Install PostgreSQL v15.2.0 using bitnami/postgresql Helm chart v12.1.15:</p> <p>Info</p> <p>The PostgreSQL can be deployed in production ready mode. For example, it may include multiple replicas, persistent storage, autoscaling, and monitoring. For details, please refer to the official Chart documentation.</p> <pre><code>helm install postgresql bitnami/postgresql \\\n--version 12.1.15 \\\n--values values.yaml \\\n--namespace security\n</code></pre> <p>Check out the values.yaml file sample of the PostgreSQL customization:</p> View: values.yaml <pre><code># PostgreSQL read only replica parameters\nreadReplicas:\n# Number of PostgreSQL read only replicas\nreplicaCount: 1\n\nimage:\ntag: 15.2.0-debian-11-r0\n\nglobal:\npostgresql:\nauth:\nusername: admin\nexistingSecret: keycloak-postgresql\ndatabase: keycloak\n\nprimary:\npersistence:\nenabled: true\nsize: 3Gi\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-keycloak/#keycloak-installation","title":"Keycloak Installation","text":"<p>To install Keycloak, follow the steps below:</p> <ol> <li> <p>Use <code>security</code> namespace from the PostgreSQL installation.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add codecentric https://codecentric.github.io/helm-charts\nhelm repo update\n</code></pre> </li> <li> <p>Create Keycloak admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-admin-creds \\\n--from-literal=username=&lt;keycloak_admin_username&gt; \\\n--from-literal=password=&lt;keycloak_admin_password&gt;\n</code></pre> </li> <li> <p>Install Keycloak 20.0.3 using codecentric/keycloakx Helm chart:</p> <p>Info</p> <p>Keycloak can be deployed in production ready mode. For example, it may include multiple replicas, persistent storage, autoscaling, and monitoring. For details, please refer to the official Chart documentation.</p> <pre><code>helm install keycloakx codecentric/keycloakx \\\n--version 2.2.1 \\\n--values values.yaml \\\n--namespace security\n</code></pre> <p>Check out the values.yaml file sample of the Keycloak customization:</p> View: values.yaml <pre><code>replicas: 1\n\n# Deploy the latest version\nimage:\ntag: \"20.0.3\"\n\n# start: create OpenShift realm which is required by EDP\nextraInitContainers: |\n- name: realm-provider\nimage: busybox\nimagePullPolicy: IfNotPresent\ncommand:\n- sh\nargs:\n- -c\n- |\necho '{\"realm\": \"openshift\",\"enabled\": true}' &gt; /opt/keycloak/data/import/openshift.json\nvolumeMounts:\n- name: realm\nmountPath: /opt/keycloak/data/import\n\n# The following parameter is unrecommended to expose. Exposed health checks lead to an unnecessary attack vector.\nhealth:\nenabled: false\n# The following parameter is unrecommended to expose. Exposed metrics lead to an unnecessary attack vector.\nmetrics:\nenabled: false\n\nextraVolumeMounts: |\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumes: |\n- name: realm\nemptyDir: {}\n\ncommand:\n- \"/opt/keycloak/bin/kc.sh\"\n- \"--verbose\"\n- \"start\"\n- \"--auto-build\"\n- \"--http-enabled=true\"\n- \"--http-port=8080\"\n- \"--hostname-strict=false\"\n- \"--hostname-strict-https=false\"\n- \"--spi-events-listener-jboss-logging-success-level=info\"\n- \"--spi-events-listener-jboss-logging-error-level=warn\"\n- \"--import-realm\"\n\nextraEnv: |\n- name: KC_PROXY\nvalue: \"passthrough\"\n- name: KEYCLOAK_ADMIN\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: username\n- name: KEYCLOAK_ADMIN_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: password\n- name: JAVA_OPTS_APPEND\nvalue: &gt;-\n-XX:+UseContainerSupport\n-XX:MaxRAMPercentage=50.0\n-Djava.awt.headless=true\n-Djgroups.dns.query={{ include \"keycloak.fullname\" . }}-headless\n\n# This block should be uncommented if you install Keycloak on Kubernetes\ningress:\nenabled: true\nannotations:\nkubernetes.io/ingress.class: nginx\ningress.kubernetes.io/affinity: cookie\n# The following parameter is unrecommended to expose. Admin paths lead to an unnecessary attack vector.\nconsole:\nenabled: false\nrules:\n- host: keycloak.&lt;ROOT_DOMAIN&gt;\npaths:\n- path: '{{ tpl .Values.http.relativePath $ | trimSuffix \"/\" }}/'\npathType: Prefix\n\n# This block should be uncommented if you set Keycloak to OpenShift and change the host field\n# route:\n#   enabled: false\n#   # Path for the Route\n#   path: '/'\n#   # Host name for the Route\n#   host: \"keycloak.&lt;ROOT_DOMAIN&gt;\"\n#   # TLS configuration\n#   tls:\n#     enabled: true\n\nresources:\nlimits:\nmemory: \"2048Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"512Mi\"\n\n# Check database readiness at startup\ndbchecker:\nenabled: true\n\ndatabase:\nvendor: postgres\nexistingSecret: keycloak-postgresql\nhostname: postgresql\nport: 5432\nusername: admin\ndatabase: keycloak\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-keycloak/#configuration","title":"Configuration","text":"<p>To prepare Keycloak for integration with EDP, follow the steps below:</p> <ol> <li> <p>Ensure that the <code>openshift</code> realm is created.</p> </li> <li> <p>Create the <code>edp_&lt;EDP_PROJECT&gt;</code> user and set the password in the <code>Master</code> realm.</p> <p>Note</p> <p>This user should be used by EDP to access Keycloak. Please refer to the Install EDP and Install EDP via Helmfile sections for details.</p> </li> <li> <p>In the <code>Role Mapping</code> tab, assign the proper roles to the user:</p> <ul> <li> <p>Realm Roles:</p> <ul> <li>create-realm,</li> </ul> <ul> <li>offline_access,</li> </ul> <ul> <li>uma_authorization</li> </ul> </li> </ul> <ul> <li> <p>Client Roles <code>openshift-realm</code>:</p> <ul> <li>impersonation,</li> </ul> <ul> <li>manage-authorization,</li> </ul> <ul> <li>manage-clients,</li> </ul> <ul> <li>manage-users</li> </ul> </li> </ul> <p> Role mappings </p> </li> </ol>"},{"location":"operator-guide/install-keycloak/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install via Helmfile</li> <li>Install Harbor</li> </ul>"},{"location":"operator-guide/install-kiosk/","title":"Set Up Kiosk","text":"<p>Kiosk is a multi-tenancy extension for managing tenants and namespaces in a shared Kubernetes cluster. Within EDP, Kiosk is used to separate resources and enables the following options (see more details):</p> <ul> <li>Access to the EDP tenants in a Kubernetes cluster;</li> </ul> <ul> <li>Multi-tenancy access at the service account level for application deploy.</li> </ul> <p>Inspect the main steps to set up Kiosk for the proceeding EDP installation.</p> <p>Note</p> <p>Kiosk deploy is mandatory for EDP v.2.8.. In earlier versions, Kiosk is not implemented. Since EDP v.2.9.0, integration with Kiosk is an optional feature. You may not want to use it, so just skip those steps and disable in Helm parameters during EDP deploy.</p> <pre><code># global.kioskEnabled: &lt;true/false&gt;\n</code></pre>"},{"location":"operator-guide/install-kiosk/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.18.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.6.0 is installed. Please refer to the Helm page on GitHub for details.</li> </ul>"},{"location":"operator-guide/install-kiosk/#installation","title":"Installation","text":"<ul> <li>Deploy Kiosk version 0.2.11 in the cluster. To install it, run the following command:<pre><code>  # Install kiosk with helm v3\n\n  helm repo add kiosk https://charts.devspace.sh/\n  kubectl create namespace kiosk\n  helm install kiosk --version 0.2.11 kiosk/kiosk -n kiosk --atomic\n</code></pre> </li> </ul> <p>For more details, please refer to the Kiosk page on the GitHub.</p>"},{"location":"operator-guide/install-kiosk/#configuration","title":"Configuration","text":"<p>To provide access to the EDP tenant, follow the steps below.</p> <ul> <li>Check that a security namespace is created. If not, run the following command to create it:<pre><code>  kubectl create namespace security\n</code></pre> </li> </ul> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> <ul> <li>Add a service account to the security namespace.<pre><code>  kubectl -n security create sa edp\n</code></pre> </li> </ul> <p>Info</p> <p>Please note that <code>edp</code> is the name of the EDP tenant here and in all the following steps.</p> <ul> <li>Apply the Account template to the cluster. Please check the sample below: <pre><code>apiVersion: tenancy.kiosk.sh/v1alpha1\nkind: Account\nmetadata:\nname: edp-admin\nspec:\nspace:\nclusterRole: kiosk-space-admin\nsubjects:\n- kind: ServiceAccount\nname: edp\nnamespace: security\n</code></pre></li> </ul> <ul> <li>Apply the ClusterRoleBinding to the 'kiosk-edit' cluster role (current role is added during installation of Kiosk). Please check the sample below: <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\nname: edp-kiosk-edit\nsubjects:\n- kind: ServiceAccount\nname: edp\nnamespace: security\nroleRef:\nkind: ClusterRole\nname: kiosk-edit\napiGroup: rbac.authorization.k8s.io\n</code></pre></li> <li>To provide access to the EDP tenant, generate kubeconfig with Service Account edp permission. The edp account created earlier is located in the security namespace.</li> </ul>"},{"location":"operator-guide/install-loki/","title":"Install Grafana Loki","text":"<p>EDP configures the logging with the help of Grafana Loki aggregation system.</p>"},{"location":"operator-guide/install-loki/#installation","title":"Installation","text":"<p>To install Loki, follow the steps below:</p> <ol> <li> <p>Create logging namespace:</p> <pre><code>  kubectl create namespace logging\n</code></pre> <p>Note</p> <p>On the OpenShift cluster, run the <code>oc</code> command instead of the <code>kubectl</code> command.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>  helm repo add grafana https://grafana.github.io/helm-charts\n  helm repo update\n</code></pre> <p>Note</p> <p>It is possible to use Amazon Simple Storage Service Amazon S3 as an object storage for Loki. To configure access, please refer to the IRSA for Loki documentation.</p> </li> <li> <p>Install Loki v.2.6.0:</p> <pre><code>  helm install loki grafana/loki \\\n  --version 2.6.0 \\\n  --values values.yaml \\\n  --namespace logging\n</code></pre> <p>Check out the values.yaml file sample of the Loki customization:</p> View: values.yaml <pre><code>image:\nrepository: grafana/loki\ntag: 2.3.0\nconfig:\nauth_enabled: false\nschema_config:\nconfigs:\n- from: 2021-06-01\nstore: boltdb-shipper\nobject_store: s3\nschema: v11\nindex:\nprefix: loki_index_\nperiod: 24h\nstorage_config:\naws:\ns3: s3://&lt;AWS_REGION&gt;/loki-&lt;CLUSTER_NAME&gt;\nboltdb_shipper:\nactive_index_directory: /data/loki/index\ncache_location: /data/loki/boltdb-cache\nshared_store: s3\nchunk_store_config:\nmax_look_back_period: 24h\nresources:\nlimits:\nmemory: \"128Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"128Mi\"\nserviceAccount:\ncreate: true\nname: edp-loki\nannotations:\neks.amazonaws.com/role-arn: \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\npersistence:\nenabled: false\n</code></pre> <p>Note</p> <p>In case of using cluster scheduling and amazon-eks-pod-identity-webhook, it is necessary to restart the Loki pod after the cluster is up and running. Please refer to the Schedule Pods Restart documentation.</p> </li> <li> <p>Configure custom bucket policy to delete the old data.</p> </li> </ol>"},{"location":"operator-guide/install-reportportal/","title":"Install ReportPortal","text":"<p>Inspect the prerequisites and the main steps to perform for installing ReportPortal.</p> <p>Info</p> <p>It is also possible to install ReportPortal using the Helmfile. For details, please refer to the Install via Helmfile page.</p>"},{"location":"operator-guide/install-reportportal/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.2 is installed. Please refer to the Helm page on GitHub for details.</li> </ul> <p>Info</p> <p>Please refer to the ReportPortal Helm Chart section for details.</p>"},{"location":"operator-guide/install-reportportal/#minio-installation","title":"MinIO Installation","text":"<p>To install MinIO, follow the steps below:</p> <ol> <li> <p>Check that <code>edp</code> namespace is created. If not, run the following command to create it:</p> <pre><code>kubectl create namespace edp\n</code></pre> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, install the <code>SecurityContextConstraints</code> resources. In case of using a custom namespace for the <code>reportportal</code>, change the namespace in the <code>users</code> section.</p> View: report-portal-third-party-resources-scc.yaml <pre><code>apiVersion: security.openshift.io/v1\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: report-portal-minio-rabbitmq-postgresql\nallowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:report-portal:minio\n- system:serviceaccount:report-portal:rabbitmq\n- system:serviceaccount:report-portal:postgresql\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> View: report-portal-elasticsearch-scc.yaml <pre><code>apiVersion: security.openshift.io/v1\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: report-portal-elasticsearch\nallowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegedContainer: true\nallowedCapabilities: []\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- max: 1000\nmin: 1000\ngroups: []\npriority: 0\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities: []\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMax: 1000\nuidRangeMin: 0\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:report-portal:elasticsearch-master\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create MinIO admin secret:</p> <pre><code>kubectl -n edp create secret generic reportportal-minio-creds \\\n--from-literal=root-password=&lt;root_password&gt; \\\n--from-literal=root-user=&lt;root_user&gt;\n</code></pre> </li> <li> <p>Install MinIO v.11.10.3 using bitnami/minio Helm chart v.11.10.3:</p> <pre><code>helm install minio bitnami/minio \\\n--version 11.10.3 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the MinIO customization:</p> View: values.yaml <pre><code>auth:\nexistingSecret: reportportal-minio-creds\npersistence:\nsize: 1Gi\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#rabbitmq-installation","title":"RabbitMQ Installation","text":"<p>To install RabbitMQ, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> </li> <li> <p>Use <code>bitnami</code> chart repository from the MinIO installation.</p> </li> <li> <p>Create RabbitMQ admin secret:</p> <pre><code>kubectl -n edp create secret generic reportportal-rabbitmq-creds \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Warning</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long. The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Install RabbitMQ v.10.3.8 using bitnami/rabbitmq Helm chart v.10.3.8:</p> <pre><code>helm install rabbitmq bitnami/rabbitmq \\\n--version 10.3.8 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the RabbitMQ customization:</p> View: values.yaml <pre><code>auth:\nexistingPasswordSecret: reportportal-rabbitmq-creds\nexistingErlangSecret: reportportal-rabbitmq-creds\npersistence:\nsize: 1Gi\n</code></pre> </li> <li> <p>After the rabbitmq pod gets the status Running, you need to configure the RabbitMQ memory threshold</p> <pre><code>kubectl -n edp exec -it rabbitmq-0 -- rabbitmqctl set_vm_memory_high_watermark 0.8\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#elasticsearch-installation","title":"Elasticsearch Installation","text":"<p>To install Elasticsearch, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add elastic https://helm.elastic.co\nhelm repo update\n</code></pre> </li> <li> <p>Install Elasticsearch v.7.17.3 using elastic/elasticsearch Helm chart v.7.17.3:</p> <pre><code>helm install elasticsearch elastic/elasticsearch \\\n--version 7.17.3 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the Elasticsearch customization:</p> View: values.yaml <pre><code>replicas: 1\n\nextraEnvs:\n- name: discovery.type\nvalue: single-node\n- name: cluster.initial_master_nodes\nvalue: \"\"\n\nrbac:\ncreate: true\n\nresources:\nrequests:\ncpu: \"100m\"\nmemory: \"2Gi\"\n\nvolumeClaimTemplate:\nresources:\nrequests:\nstorage: 3Gi\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#postgresql-installation","title":"PostgreSQL Installation","text":"<p>To install PostgreSQL, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add bitnami-archive https://raw.githubusercontent.com/bitnami/charts/archive-full-index/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n edp create secret generic reportportal-postgresql-creds \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Warning</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Install PostgreSQL v.10.9.4 using Helm chart v.10.9.4:</p> <pre><code>helm install postgresql bitnami-archive/postgresql \\\n--version 10.9.4 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the PostgreSQL customization:</p> View: values.yaml <pre><code>persistence:\nsize: 1Gi\nresources:\nrequests:\ncpu: \"100m\"\nserviceAccount:\nenabled: true\npostgresqlUsername: \"rpuser\"\npostgresqlDatabase: \"reportportal\"\nexistingSecret: \"reportportal-postgresql-creds\"\ninitdbScripts:\ninit_postgres.sh: |\n#!/bin/sh\n/opt/bitnami/postgresql/bin/psql -U postgres -d ${POSTGRES_DB} -c 'CREATE EXTENSION IF NOT EXISTS ltree; CREATE EXTENSION IF NOT EXISTS pgcrypto; CREATE EXTENSION IF NOT EXISTS pg_trgm;'\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#reportportal-installation","title":"ReportPortal Installation","text":"<p>To install ReportPortal, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, install the <code>SecurityContextConstraints</code> resource. In case of using a custom namespace for the <code>reportportal</code>, change the namespace in the <code>users</code> section.</p> View: report-portal-reportportal-scc.yaml <pre><code>apiVersion: security.openshift.io/v1\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: report-portal\nallowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegedContainer: true\nallowedCapabilities: []\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- max: 1000\nmin: 1000\ngroups: []\npriority: 0\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities: []\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMax: 1000\nuidRangeMin: 0\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:report-portal:reportportal\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add report-portal \"https://reportportal.github.io/kubernetes\"\nhelm repo update\n</code></pre> </li> <li> <p>Install ReportPortal v.5.8.0 using Helm chart v.5.8.0:</p> <pre><code>helm install report-portal report-portal/reportportal \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the ReportPortal customization:</p> View: values.yaml <pre><code>serviceindex:\nresources:\nrequests:\ncpu: 50m\nuat:\nresources:\nrequests:\ncpu: 50m\nserviceui:\nresources:\nrequests:\ncpu: 50m\nserviceAccountName: \"reportportal\"\nsecurityContext:\nrunAsUser: 0\nserviceapi:\nresources:\nrequests:\ncpu: 50m\nserviceanalyzer:\nresources:\nrequests:\ncpu: 50m\nserviceanalyzertrain:\nresources:\nrequests:\ncpu: 50m\n\nrabbitmq:\nSecretName: \"reportportal-rabbitmq-creds\"\nendpoint:\naddress: rabbitmq.&lt;EDP_PROJECT&gt;.svc.cluster.local\nuser: user\napiuser: user\n\npostgresql:\nSecretName: \"reportportal-postgresql-creds\"\nendpoint:\naddress: postgresql.&lt;EDP_PROJECT&gt;.svc.cluster.local\n\nelasticsearch:\nendpoint: http://elasticsearch-master.&lt;EDP_PROJECT&gt;.svc.cluster.local:9200\n\nminio:\nsecretName: \"reportportal-minio-creds\"\nendpoint: http://minio.&lt;EDP_PROJECT&gt;.svc.cluster.local:9000\nendpointshort: minio.&lt;EDP_PROJECT&gt;.svc.cluster.local:9000\naccesskeyName: \"root-user\"\nsecretkeyName: \"root-password\"\n\ningress:\n# IF YOU HAVE SOME DOMAIN NAME SET INGRESS.USEDOMAINNAME to true\nusedomainname: true\nhosts:\n- report-portal-&lt;EDP_PROJECT&gt;.&lt;ROOT_DOMAIN&gt;\n</code></pre> </li> <li> <p>For the OpenShift platform, install a Gateway with Route:</p> View: gateway-config-cm.yaml <pre><code>kind: ConfigMap\nmetadata:\nname: gateway-config\nnamespace: report-portal\napiVersion: v1\ndata:\ntraefik-dynamic-config.yml: |\nhttp:\nmiddlewares:\nstrip-ui:\nstripPrefix:\nprefixes:\n- \"/ui\"\nforceSlash: false\nstrip-api:\nstripPrefix:\nprefixes:\n- \"/api\"\nforceSlash: false\nstrip-uat:\nstripPrefix:\nprefixes:\n- \"/uat\"\nforceSlash: false\n\nrouters:\nindex-router:\nrule: \"Path(`/`)\"\nservice: \"index\"\nui-router:\nrule: \"PathPrefix(`/ui`)\"\nmiddlewares:\n- strip-ui\nservice: \"ui\"\nuat-router:\nrule: \"PathPrefix(`/uat`)\"\nmiddlewares:\n- strip-uat\nservice: \"uat\"\napi-router:\nrule: \"PathPrefix(`/api`)\"\nmiddlewares:\n- strip-api\nservice: \"api\"\n\nservices:\nuat:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-uat:9999/\"\n\nindex:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-index:8080/\"\n\napi:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-api:8585/\"\n\nui:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-ui:8080/\"\ntraefik.yml: |\nentryPoints:\nhttp:\naddress: \":8081\"\nmetrics:\naddress: \":8082\"\n\nmetrics:\nprometheus:\nentryPoint: metrics\naddEntryPointsLabels: true\naddServicesLabels: true\nbuckets:\n- 0.1\n- 0.3\n- 1.2\n- 5.0\n\nproviders:\nfile:\nfilename: /etc/traefik/traefik-dynamic-config.yml\n</code></pre> View: gateway-deployment.yaml <pre><code>apiVersion: apps/v1\nkind: Deployment\nmetadata:\nlabels:\napp: reportportal\nname: gateway\nnamespace: report-portal\nspec:\nreplicas: 1\nselector:\nmatchLabels:\ncomponent: gateway\ntemplate:\nmetadata:\nlabels:\ncomponent: gateway\nspec:\ncontainers:\n- image: quay.io/waynesun09/traefik:2.3.6\nname: traefik\nports:\n- containerPort: 8080\nprotocol: TCP\nresources: {}\nvolumeMounts:\n- mountPath: /etc/traefik/\nname: config\nreadOnly: true\nvolumes:\n- name: config\nconfigMap:\ndefaultMode: 420\nname: gateway-config\n</code></pre> View: gateway-route.yaml <pre><code>kind: Route\napiVersion: route.openshift.io/v1\nmetadata:\nlabels:\napp: reportportal\nname: reportportal\nnamespace: report-portal\nspec:\nhost: report-portal.&lt;CLUSTER_DOMAIN&gt;\nport:\ntargetPort: http\ntls:\ninsecureEdgeTerminationPolicy: Redirect\ntermination: edge\nto:\nkind: Service\nname: gateway\nweight: 100\nwildcardPolicy: None\n</code></pre> View: gateway-service.yaml <pre><code>apiVersion: v1\nkind: Service\nmetadata:\nlabels:\napp: reportportal\ncomponent: gateway\nname: gateway\nnamespace: report-portal\nspec:\nports:\n# use 8081 to allow for usage of the dashboard which is on port 8080\n- name: http\nport: 8081\nprotocol: TCP\ntargetPort: 8081\nselector:\ncomponent:  gateway\nsessionAffinity: None\ntype: ClusterIP\n</code></pre> </li> </ol> <p>Note</p> <p>For user access: default/1q2w3e For admin access: superadmin/erebus Please refer to the ReportPortal.io page for details.</p>"},{"location":"operator-guide/install-reportportal/#related-articles","title":"Related Articles","text":"<ul> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/install-tekton/","title":"Install Tekton","text":"<p>EPAM Delivery Platform uses Tekton resources, such as Tasks, Pipelines, Triggers, and Interceptors, for running the CI/CD pipelines.</p> <p>Inspect the main steps to perform for installing the Tekton resources via the Tekton release files.</p>"},{"location":"operator-guide/install-tekton/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.24.0 or higher is installed. Please refer to the Kubernetes official website for details.</li> <li>For Openshift/OKD, the latest version of the <code>oc</code> utility is required. Please refer to the OKD page on GitHub for details.</li> <li>Created AWS ECR repository for Kaniko cache. By default, the Kaniko cache repository name is <code>kaniko-cache</code> and this parameter is located in our Tekton <code>common-library</code>.</li> </ul>"},{"location":"operator-guide/install-tekton/#installation-on-kubernetes-cluster","title":"Installation on Kubernetes Cluster","text":"<p>To install Tekton resources, follow the steps below:</p> <p>Info</p> <p>Please refer to the Install Tekton Pipelines and Install and set up Tekton Triggers sections for details.</p> <ol> <li> <p>Install Tekton pipelines v0.51.0 using the release file:</p> <p>Note</p> <p>Tekton Pipeline resources are used for managing and running EDP Tekton Pipelines and Tasks. Please refer to the EDP Tekton Pipelines and EDP Tekton Tasks pages for details.</p> <pre><code>kubectl apply -f https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.51.0/release.yaml\n</code></pre> </li> <li> <p>Install Tekton Triggers v0.25.0 using the release file:</p> <p>Note</p> <p>Tekton Trigger resources are used for managing and running EDP Tekton EventListeners, Triggers, TriggerBindings and TriggerTemplates. Please refer to the EDP Tekton Triggers page for details.</p> <pre><code>kubectl apply -f https://storage.googleapis.com/tekton-releases/triggers/previous/v0.25.0/release.yaml\n</code></pre> </li> <li> <p>Install Tekton Interceptors v0.25.0 using the release file:</p> <p>Note</p> <p>EPAM Delivery Platform uses GitLab and GitHub ClusterInterceptors for managing requests from webhooks.</p> <pre><code>kubectl apply -f https://storage.googleapis.com/tekton-releases/triggers/previous/v0.25.0/interceptors.yaml\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-tekton/#installation-on-okd-cluster","title":"Installation on OKD cluster","text":"<p>To install Tekton resources, follow the steps below:</p> <p>Info</p> <p>Please refer to the Install Tekton Operator documentation for details.</p> <p>Note</p> <p>Tekton Operator also deploys Pipelines as Code CI that requires OpenShift v4.11 (based on Kubernetes v1.24) or higher. This feature is optional and its deployments can be scaled to zero replicas.</p> <p>Install Tekton Operator v0.67.0 using the release file:</p> <pre><code>kubectl apply -f https://github.com/tektoncd/operator/releases/download/v0.67.0/openshift-release.yaml\n</code></pre> <p>After the installation, the Tekton Operator will install the following components: Pipeline, Trigger, and Addons.</p> <p>Note</p> <p>If there is the following error in the <code>openshift-operators</code> namespace for <code>openshift-pipelines-operator</code> and <code>tekton-operator-webhook</code> deployments:</p> <pre><code>Error: container has runAsNonRoot and image will run as root\n</code></pre> <p>Patch the deployments with the following commands:</p> <pre><code>kubectl -n openshift-operators patch deployment openshift-pipelines-operator -p '{\"spec\": {\"template\": {\"spec\": {\"securityContext\": {\"runAsUser\": 1000}}}}}'\nkubectl -n openshift-operators patch deployment tekton-operator-webhook -p '{\"spec\": {\"template\": {\"spec\": {\"securityContext\": {\"runAsUser\": 1000}}}}}'\n</code></pre> <p>Grant access for Tekton Service Accounts in the <code>openshift-pipelines</code> namespace to the Privileged SCC:</p> <pre><code>oc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-operators-proxy-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-pipelines-controller\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-pipelines-resolvers\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-pipelines-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-triggers-controller\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-triggers-core-interceptors\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-triggers-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:pipelines-as-code-controller\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:pipelines-as-code-watcher\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:pipelines-as-code-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:default\n</code></pre>"},{"location":"operator-guide/install-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/install-velero/","title":"Install Velero","text":"<p>Velero is an open source tool to safely back up, recover, and migrate Kubernetes clusters and persistent volumes. It works both on premises and in a public cloud. Velero consists of a server process running as a deployment in your Kubernetes cluster and a command-line interface (CLI) with which DevOps teams and platform operators configure scheduled backups, trigger ad-hoc backups, perform restores, and more.</p>"},{"location":"operator-guide/install-velero/#installation","title":"Installation","text":"<p>To install Velero, follow the steps below:</p> <ol> <li> <p>Create velero namespace:</p> <pre><code>  kubectl create namespace velero\n</code></pre> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>  helm repo add vmware-tanzu https://vmware-tanzu.github.io/helm-charts\n  helm repo update\n</code></pre> <p>Note</p> <p>Velero AWS Plugin requires access to AWS resources.  To configure access, please refer to the IRSA for Velero documentation.</p> </li> <li> <p>Install Velero v.2.14.13:</p> <pre><code>  helm install velero vmware-tanzu/velero \\\n  --version 2.14.13 \\\n  --values values.yaml \\\n  --namespace velero\n</code></pre> <p>Check out the values.yaml file sample of the Velero customization:</p> View: values.yaml <pre><code>image:\nrepository: velero/velero\ntag: v1.5.3\nsecurityContext:\nfsGroup: 65534\nrestic:\nsecurityContext:\nfsGroup: 65534\nserviceAccount:\nserver:\ncreate: true\nname: edp-velero\nannotations:\neks.amazonaws.com/role-arn: \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\"\ncredentials:\nuseSecret: false\nconfiguration:\nprovider: aws\nbackupStorageLocation:\nname: default\nbucket: velero-&lt;CLUSTER_NAME&gt;\nconfig:\nregion: eu-central-1\nvolumeSnapshotLocation:\nname: default\nconfig:\nregion: &lt;AWS_REGION&gt;\ninitContainers:\n- name: velero-plugin-for-aws\nimage: velero/velero-plugin-for-aws:v1.1.0\nvolumeMounts:\n- mountPath: /target\nname: plugins\n</code></pre> <p>Note</p> <p>In case of using cluster scheduling and amazon-eks-pod-identity-webhook, it is necessary to restart the Velero pod after the cluster is up and running. Please refer to the Schedule Pods Restart documentation.</p> </li> <li> <p>Install the client side (velero cli) according to the official documentation.</p> </li> </ol>"},{"location":"operator-guide/install-velero/#configuration","title":"Configuration","text":"<ol> <li> <p>Create backup for all components in the namespace:</p> <pre><code>  velero backup create &lt;BACKUP_NAME&gt; --include-namespaces &lt;NAMESPACE&gt;\n</code></pre> </li> <li> <p>Create a daily backup of the namespace:</p> <pre><code>  velero schedule create &lt;BACKUP_NAME&gt;  --schedule \"0 10 * * MON-FRI\" --include-namespaces &lt;NAMESPACE&gt; --ttl 120h0m0s\n</code></pre> </li> <li> <p>To restore from backup, use the following command:</p> <pre><code>  velero restore create &lt;RESTORE_NAME&gt; --from-backup &lt;BACKUP_NAME&gt;\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/","title":"Install via Helmfile","text":"<p>This article provides the instruction on how to deploy EDP and components in Kubernetes using Helmfile that is intended for deploying Helm charts. Helmfile templates are available in GitHub repository.</p> <p>Important</p> <p>The Helmfile installation method for EPAM Delivery Platform (EDP) is currently not actively maintained. We strongly recommend exploring alternative installation options for the most up-to-date and well-supported deployment experience. You may consider using the Add-Ons approach or opting for installation via the AWS Marketplace to ensure a reliable and secure deployment of EDP.</p>"},{"location":"operator-guide/install-via-helmfile/#prerequisites","title":"Prerequisites","text":"<p>The following tools and plugins must be installed:</p> <ul> <li>Kubectl version 1.23.0;</li> <li>Helm version 3.10.0+;</li> <li>Helmfile version 0.144.0;</li> <li>Helm diff plugin version 3.6.0.</li> </ul>"},{"location":"operator-guide/install-via-helmfile/#helmfile-structure","title":"Helmfile Structure","text":"<ul> <li>The <code>envs/common.yaml</code> file contains the specification for environments pattern, list of helm repositories from which it is necessary to fetch the helm charts and additional Helm parameters.</li> <li>The <code>envs/platform.yaml</code> file contains global parameters that are used in various Helmfiles.</li> <li>The <code>releases/envs/</code> contains symbol links to environments files.</li> <li>The <code>releases/*.yaml</code> file contains description of parameters that is used when deploying a Helm chart.</li> <li>The <code>helmfile.yaml</code> file defines components to be installed by defining a path to Helm releases files.</li> <li>The <code>envs/ci.yaml</code> file contains stub parameters for CI linter.</li> <li>The <code>test/lint-ci.sh</code> script for running CI linter with debug loglevel and stub parameters.</li> <li>The <code>resources/*.yaml</code> file contains additional resources for the OpenShift platform.</li> </ul>"},{"location":"operator-guide/install-via-helmfile/#operate-helmfile","title":"Operate Helmfile","text":"<p>Before applying the Helmfile, please fill in the global parameters in the <code>envs/platform.yaml</code> (check the examples in the <code>envs/ci.yaml</code>) and <code>releases/*.yaml</code> files for every Helm deploy.</p> <p>Pay attention to the following recommendations while working with the Helmfile:</p> <ul> <li>To launch Lint, run the <code>test/lint-ci.sh</code> script.</li> </ul> <ul> <li>Display the difference between the deployed and environment state (<code>helm diff</code>):<pre><code>helmfile --environment platform -f helmfile.yaml diff\n</code></pre> </li> </ul> <ul> <li>Apply the deployment:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ul> <ul> <li>Modify the deployment and apply the changes:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml sync\n</code></pre> </li> </ul> <ul> <li>To deploy the components according to the label, use the selector to target a subset of releases when running the Helmfile. It can be useful for large Helmfiles with the releases that are logically grouped together. For example, to display the difference only for the <code>nginx-ingress</code> file, use the following command:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml diff\n</code></pre> </li> </ul> <ul> <li>To destroy the release, run the following command:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml destroy\n</code></pre> </li> </ul>"},{"location":"operator-guide/install-via-helmfile/#deploy-components","title":"Deploy Components","text":"<p>Using the Helmfile, the following components can be installed:</p> <ul> <li>NGINX Ingress Controller</li> <li>Keycloak</li> <li>EPAM Delivery Platform</li> <li>Argo CD</li> <li>External Secrets Operator</li> <li>DefectDojo</li> <li>Moon</li> <li>ReportPortal</li> <li>Kiosk</li> <li>Monitoring stack, included Prometheus, Alertmanager, Grafana, PrometheusOperator</li> </ul> <ul> <li>Logging ELK stack, included Elasticsearch, Fluent-bit, Kibana</li> <li>Logging Grafana/Loki stack, included Grafana, Loki, Promtail, Logging Operator, Logging Operator Logging</li> </ul>"},{"location":"operator-guide/install-via-helmfile/#deploy-nginx-ingress-controller","title":"Deploy NGINX Ingress Controller","text":"<p>Info</p> <p>Skip this step for the OpenShift platform, because it has its own Ingress Controller.</p> <p>To install NGINX Ingress controller, follow the steps below:</p> <ol> <li> <p>In the <code>releases/nginx-ingress.yaml</code> file, set the <code>proxy-real-ip-cidr</code> parameter according to the value with AWS VPC IPv4 CIDR.</p> </li> <li> <p>Install NGINX Ingress controller:</p> <pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-keycloak","title":"Deploy Keycloak","text":"<p>Keycloak requires a database deployment, so it has two charts: <code>releases/keycloak.yaml</code> and <code>releases/postgresql-keycloak.yaml</code>.</p> <p>To install Keycloak, follow the steps below:</p> <ol> <li> <p>Create a <code>security</code> namespace:</p> <p>Note</p> <p>For the OpenShift users: This namespace is also indicated as <code>users</code> in the following custom <code>SecurityContextConstraints</code> resources: <code>resources/keycloak-scc.yaml</code> and <code>resources/postgresql-keycloak-scc.yaml</code>. Change the namespace name when using a custom namespace.</p> <pre><code>kubectl create namespace security\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-postgresql \\\n--from-literal=password=&lt;postgresql_password&gt; \\\n--from-literal=postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>dnsWildCard</code> parameter.</p> </li> <li> <p>Create Keycloak admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-admin-creds \\\n--from-literal=username=&lt;keycloak_admin_username&gt; \\\n--from-literal=password=&lt;keycloak_admin_password&gt;\n</code></pre> </li> <li> <p>Install Keycloak:</p> <pre><code>helmfile  --selector component=sso --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-external-secrets-operator","title":"Deploy External Secrets Operator","text":"<p>To install External Secrets Operator, follow the steps below:</p> <pre><code>helmfile --selector component=secrets --environment platform -f helmfile.yaml apply\n</code></pre>"},{"location":"operator-guide/install-via-helmfile/#deploy-kiosk","title":"Deploy Kiosk","text":"<p>To install Kiosk, follow the steps below:</p> <pre><code>helmfile --selector component=kiosk --environment platform -f helmfile.yaml apply\n</code></pre>"},{"location":"operator-guide/install-via-helmfile/#deploy-epam-delivery-platform","title":"Deploy EPAM Delivery Platform","text":"<p>To install EDP, follow the steps below:</p> <ol> <li> <p>Create a <code>platform</code> namespace:</p> <pre><code>kubectl create namespace platform\n</code></pre> </li> <li> <p>For EDP, it is required to have Keycloak access to perform the integration. Create a secret with the user and password provisioned in the step 2 of the Keycloak Configuration section.</p> <pre><code>kubectl -n platform create secret generic keycloak \\\n  --from-literal=username=&lt;username&gt; \\\n  --from-literal=password=&lt;password&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>edpName</code> and <code>keycloakEndpoint</code> parameters.</p> </li> <li> <p>In the <code>releases/edp-install.yaml</code> file, check and fill in all values.</p> </li> <li> <p>Install EDP:</p> <pre><code>helmfile  --selector component=edp --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-argo-cd","title":"Deploy Argo CD","text":"<p>Before Argo CD deployment, install the following tools:</p> <ul> <li>Keycloak</li> <li>EDP</li> </ul> <p>To install Argo CD, follow the steps below:</p> <ol> <li> <p>Install Argo CD:</p> <p>For the OpenShift users:<p>When using a custom namespace for Argo CD, the <code>argocd</code> namespace is also indicated as <code>users</code> in the <code>resources/argocd-scc.yaml</code> custom <code>SecurityContextConstraints</code> resource. Change it there as well.</p> </p> <pre><code>helmfile --selector component=argocd --environment platform -f helmfile.yaml apply\n</code></pre> </li> <li> <p>Update the <code>argocd-secret</code> secret in the Argo CD namespace by providing the correct Keycloak client secret (<code>oidc.keycloak.clientSecret</code>) with the value from the <code>keycloak-client-argocd-secret</code> secret in EDP namespace. Then restart the deployment:</p> <pre><code>ARGOCD_CLIENT=$(kubectl -n platform get secret keycloak-client-argocd-secret  -o jsonpath='{.data.clientSecret}')\nkubectl -n argocd patch secret argocd-secret -p=\"{\\\"data\\\":{\\\"oidc.keycloak.clientSecret\\\": \\\"${ARGOCD_CLIENT}\\\"}}\" -v=1\nkubectl -n argocd rollout restart deployment argo-argocd-server\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-defectdojo","title":"Deploy DefectDojo","text":"<p>Prerequisites</p> <ol> <li>Before DefectDojo deployment,first make sure to have the Keycloak configuration.</li> </ol> <p>Info</p> <p>It is also possible to install DefectDojo via Helm Chart. For details, please refer to the Install DefectDojo page.</p> <p>To install DefectDojo via Helmfile, follow the steps below:</p> <ol> <li> <p>Create a DefectDojo namespace:</p> <p>For the OpenShift users:</p> <p>This namespace is also indicated as <code>users</code> in the <code>resources/defectdojo-scc.yaml</code> custom <code>SecurityContextConstraints</code> resource. Change it when using a custom namespace. Also, change the namespace in the <code>resources/defectdojo-route.yaml</code> file.</p> <pre><code>kubectl create namespace defectdojo\n</code></pre> </li> <li> <p>Modify the <code>host</code> in <code>resources/defectdojo-route.yaml</code> (only for OpenShift).</p> </li> <li> <p>Create a PostgreSQL admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-postgresql-specific \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Note</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Create a RabbitMQ admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-rabbitmq-specific \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Note</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long.</p> <p>The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Create a DefectDojo admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo \\\n--from-literal=DD_ADMIN_PASSWORD=&lt;dd_admin_password&gt; \\\n--from-literal=DD_SECRET_KEY=&lt;dd_secret_key&gt; \\\n--from-literal=DD_CREDENTIAL_AES_256_KEY=&lt;dd_credential_aes_256_key&gt; \\\n--from-literal=METRICS_HTTP_AUTH_PASSWORD=&lt;metric_http_auth_password&gt;\n</code></pre> <p>Note</p> <p>The <code>dd_admin_password</code> password must be 22 characters long.</p> <p>The <code>dd_secret_key</code> password must be 128 characters long.</p> <p>The <code>dd_credential_aes_256_key</code> password must be 128 characters long.</p> <p>The <code>metric_http_auth_password</code> password must be 32 characters long.</p> </li> <li> <p>Create a Keycloak client secret for DefectDojo:</p> <p>Note</p> <p>The <code>keycloak_client_secret</code> value received from: <code>edpName</code>-main realm -&gt; clients -&gt; defectdojo -&gt; Credentials -&gt; Client secret</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-extrasecrets \\\n--from-literal=DD_SOCIAL_AUTH_KEYCLOAK_SECRET=&lt;keycloak_client_secret&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>dnsWildCard</code> parameter.</p> </li> <li> <p>In the releases/defectdojo.yaml file, check and fill in all values.</p> </li> <li> <p>Install DefectDojo:</p> <pre><code>helmfile  --selector component=defectdojo --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-reportportal","title":"Deploy ReportPortal","text":"<p>Info</p> <p>It is also possible to install ReportPortal via Helm Chart. For details, please refer to the Install ReportPortal page.</p> <p>ReportPortal requires third-party deployments: RabbitMQ, ElasticSearch, PostgreSQL, MinIO.</p> <p>To install third-party resources, follow the steps below:</p> <ol> <li> <p>Create a RabbitMQ admin secret:</p> <pre><code>kubectl -n report-portal create secret generic reportportal-rabbitmq-creds \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Warning</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long.</p> <p>The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Create a PostgreSQL admin secret:</p> <pre><code>kubectl -n report-portal create secret generic reportportal-postgresql-creds \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Warning</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Create a MinIO admin secret:</p> <pre><code>kubectl -n report-portal create secret generic reportportal-minio-creds \\\n--from-literal=root-password=&lt;root_password&gt; \\\n--from-literal=root-user=&lt;root_user&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>dnsWildCard</code> and <code>edpName</code> parameters.</p> <p>For the OpenShift users:</p> <p>The namespace is also indicated as <code>users</code> in the following custom <code>SecurityContextConstraints</code> resources: <code>resources/report-portal-elasticsearch-scc.yaml</code> and <code>resources/report-portal-third-party-resources-scc.yaml</code>. Change the namespace name when using a custom namespace.</p> </li> <li> <p>Install third-party resources:</p> <pre><code>helmfile --selector component=report-portal-third-party-resources --environment platform -f helmfile.yaml apply\n</code></pre> </li> <li> <p>After the rabbitmq pod gets the status Running, you need to configure the RabbitMQ memory threshold</p> <pre><code>kubectl -n report-portal exec -it rabbitmq-0 -- rabbitmqctl set_vm_memory_high_watermark 0.8\n</code></pre> </li> </ol> <p>To install ReportPortal via Helmfile, follow the steps below:</p> <p>For the OpenShift users:</p> <ol> <li>The namespace is also indicated as <code>users</code> in the <code>resources/report-portal-reportportal-scc.yaml</code> custom <code>SecurityContextConstraints</code> resource. Change it when using a custom namespace.</li> <li>Change the namespace in the following files: <code>resources/report-portal-gateway/gateway-config-cm</code>, <code>resources/report-portal-gateway/gateway-deployment</code>, <code>resources/report-portal-gateway/gateway-route</code>, and <code>resources/report-portal-gateway/gateway-service</code>.</li> <li>Modify the <code>host</code> in <code>resources/report-portal-gateway/gateway-route</code></li> </ol> <pre><code>helmfile --selector component=report-portal --environment platform -f helmfile.yaml apply\n</code></pre> <p>Note</p> <p>For user access: default/1q2w3e For admin access: superadmin/erebus Please refer to the ReportPortal.io page for details.</p>"},{"location":"operator-guide/install-via-helmfile/#deploy-moon","title":"Deploy Moon","text":"<p>Moon is a browser automation solution compatible with Selenium, Cypress, Playwright, and Puppeteer using Kubernetes or Openshift to launch browsers.</p> <p>Note</p> <p>Aerokube/Moon does not require third-party deployments.</p> <p>Follow the steps below to deploy Moon:</p> <ol> <li> <p>Use the following command to install Moon:</p> <pre><code>helmfile --selector component=moon --environment platform -f helmfile.yaml apply\n</code></pre> </li> <li> <p>After the installation, open the Ingress Dashboard and check that <code>SELENOID</code> and <code>SSE</code> have the <code>CONNECTED</code> status.</p> <p> Main board </p> </li> <li> <p>In Moon, use the following command with the Ingress rule, for example, <code>wd/hub</code>:</p> <pre><code>    curl -X POST 'http://&lt;INGRESS_LINK&gt;/wd/hub/session' -d '{\n                \"desiredCapabilities\":{\n                    \"browserName\":\"firefox\",\n                    \"version\": \"79.0\",\n                    \"platform\":\"ANY\",\n                    \"enableVNC\": true,\n                    \"name\": \"edp\",\n                    \"sessionTimeout\": \"480s\"\n                }\n            }'\n</code></pre> <p>See below the list of Moon Dashboard Ingress rules:</p> <p> Moon Dashboard Ingress rules </p> <p>After using the command above, the container will start, and the VNC viewer will be displayed on the Moon Dashboard:</p> <p> VNC viewer with the container starting </p> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-monitoring","title":"Deploy Monitoring","text":"<p>The monitoring stack includes Grafana, Prometheus, Alertmanager, and Karma-dashboard. To deploy it follow the steps:</p> <ol> <li> <p>Generate a token for Keycloak client:</p> <p>Note</p> <p>The token must be 32-character and include alphabetic and numeric symbols. For example, use the following command:</p> <pre><code>keycloak_client_secret=$(date +%s | sha256sum | base64 | head -c 32 ; echo)\n</code></pre> </li> <li> <p>Create a secret for the Keycloak client:</p> <pre><code>kubectl -n platform create secret generic keycloak-client-grafana \\\n--from-literal=clientSecret=&lt;keycloak_client_secret&gt;\n</code></pre> </li> <li> <p>Create a secret for the Grafana:</p> <pre><code>kubectl -n monitoring create secret generic keycloak-client-grafana \\\n--from-literal=GF_AUTH_GENERIC_OAUTH_CLIENT_SECRET=&lt;keycloak_client_secret&gt; \\\n</code></pre> </li> <li> <p>Create a custom resource for the Keycloak client:</p> View: keycloak_client <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: grafana\nnamespace: platform\nspec:\nclientId: grafana\ndirectAccess: true\nserviceAccount:\nenabled: true\ntargetRealm: platform-main\nwebUrl: https://grafana-monitoring.&lt;dnsWildCard&gt;\nsecret: keycloak-client.grafana\n</code></pre> </li> <li> <p>Run command:</p> <pre><code>helmfile --selector component=monitoring --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-logging","title":"Deploy Logging","text":"ELK stackGrafana, Loki, Promtail stack <p>To install Elasticsearch, Kibana and Fluentbit, run command:</p> <pre><code>helmfile --selector component=logging-elastic --environment platform -f helmfile.yaml apply\n</code></pre> <p>To install Grafana, Loki, Promtail, follow the steps below:</p> <ol> <li> <p>Make sure that appropriate resources are created:</p> <ul> <li>Secret for the Keycloak client</li> </ul> <ul> <li>Secret for the Grafana</li> </ul> </li> <li> <p>Create a custom resource for the Keycloak client:</p> View: keycloak_client <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: grafana\nnamespace: platform\nspec:\nclientId: grafana-logging\ndirectAccess: true\nserviceAccount:\nenabled: true\ntargetRealm: platform-main\nwebUrl: https://grafana-logging.&lt;dnsWildCard&gt;\nsecret: keycloak-client.grafana\n</code></pre> </li> <li> <p>Run command:</p> <pre><code>helmfile --selector component=logging --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install NGINX Ingress Controller</li> <li>Install Keycloak</li> <li>Install DefectDojo</li> <li>Install ReportPortal</li> <li>Install Argo CD</li> </ul>"},{"location":"operator-guide/jira-gerrit-integration/","title":"Adjust VCS Integration With Jira","text":"<p>In order to adjust the Version Control System integration with Jira Server, first make sure you have the following prerequisites:</p> <ul> <li>VCS Server</li> <li>Jira</li> <li>Crucible</li> </ul> <p>When checked the prerequisites, follow the steps below to proceed with the integration:</p> <ol> <li> <p>Integrate every project in VCS Server with every project in Crucible by creating a corresponding request in EPAM Support Portal. Add the repositories links and fill in the Keep Informed field as this request must be approved.</p> <p> Request example </p> </li> <li> <p>Provide additional details to the support team. If the VCS is Gerrit, inspect the sample below of its integration:</p> <p>2.1 Create a new \"crucible-\" user in Gerrit with SSH key and add a new user to the \"Non-Interactive Users\" Gerrit group; <p>2.2 Create a new group in Gerrit \"crucible-watcher-group\" and add the \"crucible-\" user; <p>2.3 Provide access to All-Projects for the \"crucible-watcher-group\" group:</p> <p> Gerrit All-Projects configuration </p> <p> Gerrit All-Projects configuration </p> <li> <p>To link commits with Jira ticket, being in Gerrit, enter a Jira ticket ID in a commit message using the specific format:</p> <p>[PROJECT-CODE-1234]: commit message</p> <p>where PROJECT-CODE is a specific code of a project, 1234 is an ID number, and a commit message.</p> </li> <li> <p>As a result, all Gerrit commits will be displayed on Crucible:</p> <p> Crucible project </p> </li>"},{"location":"operator-guide/jira-gerrit-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Adjust Jira Integration</li> </ul>"},{"location":"operator-guide/jira-integration/","title":"Adjust Jira Integration","text":"<p>This documentation guide provides step-by-step instructions for enabling the Jira integration option in the EDP Portal UI for EPAM Delivery Platform. Jira integration allows including useful metadata in Jira tickets.</p>"},{"location":"operator-guide/jira-integration/#overview","title":"Overview","text":"<p>Integrating Jira can provide a number of benefits, such as increased visibility and traceability, automatic linking code changes to relevant Jira issues, streamlining the management and tracking of development progress.</p> <p>By linking CI pipelines to Jira issues, teams can get a better understanding of the status of their work and how it relates to the overall development process. This can help to improve communication and collaboration, and ultimately lead to faster and more efficient delivery of software.</p> <p>Enabling Jira integration allows for the automatic population of three fields in Jira tickets: Fix Versions, Components, and Labels. Each of these fields provides distinct benefits:</p> <ul> <li>Fix Versions: helps track progress against release schedules;</li> <li>Components: allows grouping related issues together;</li> <li>Labels: enables identification of specific types of work.</li> </ul> <p>Teams can utilize these fields to enhance their work prioritization, identify dependencies, improve collaboration, and ultimately achieve faster software delivery.</p>"},{"location":"operator-guide/jira-integration/#integration-procedure","title":"Integration Procedure","text":"<p>In order to adjust the Jira server integration, add the JiraServer CR by performing the following:</p> <ol> <li> <p>Provision the secret using <code>EDP Portal</code>, <code>Manifest</code> or with the <code>externalSecrets</code> operator:</p> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; Jira. Update or fill in the URL, User, Password fields and click the Save button:</p> <p> Jira update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-jira\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type=jira\nstringData:\nurl: https://jira.example.com\nusername: username\npassword: password\n</code></pre> <pre><code>\"ci-jira\":\n{\n\"url\": \"https://jira.example.com\",\n\"username\": \"username\",\n\"password\": \"password\"\n}\n</code></pre> </li> <li> <p>Create JiraServer CR in the OpenShift/Kubernetes namespace with the apiUrl, credentialName and rootUrl fields:</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: JiraServer\nmetadata:\nname: jira-server\nspec:\napiUrl: 'https://jira-api.example.com'\ncredentialName: ci-jira\nrootUrl: 'https://jira.example.com'\n</code></pre> <p>Note</p> <p>The value of the credentialName property is the name of the Secret, which is indicated in the first point above.</p> </li> <li> <p>In the EDP Portal UI, navigate to the Advanced Settings menu to check that the Integrate with Jira server check box appeared:</p> <p> Advanced settings </p> <p>Note</p> <p>There are four predefined variables with the respective values that can be specified singly or as a combination:</p> <p>EDP_COMPONENT \u2013 returns application-name EDP_VERSION \u2013 returns 0.0.0-SNAPSHOT or 0.0.0-RC EDP_SEM_VERSION \u2013 returns 0.0.0 EDP_GITTAG \u2013 returns build/0.0.0-SNAPSHOT.2 or build/0.0.0-RC.2</p> <p>There are no character restrictions when combining the variables, combination samples: EDP_SEM_VERSION-EDP_COMPONENT or EDP_COMPONENT-hello-world/EDP_VERSION, etc.</p> <p>As a result of successful Jira integration, the additional information will be added to tickets.</p> </li> </ol>"},{"location":"operator-guide/jira-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Adjust VCS Integration With Jira</li> <li>Add Application</li> </ul>"},{"location":"operator-guide/kaniko-irsa/","title":"IAM Roles for Kaniko Service Accounts","text":"<p>Note</p> <p>The information below is relevant in case ECR is used as Docker container registry. Make sure that IRSA is enabled and amazon-eks-pod-identity-webhook is deployed according to the Associate IAM Roles With Service Accounts documentation.</p> <p>The \"build-image-kaniko\" stage manages ECR through IRSA that should be available on the cluster. Follow the steps below to create a required role:</p> <ol> <li> <p>Create AWS IAM Policy \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko_policy\":</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n        \"Effect\": \"Allow\",\n        \"Action\": [\n            \"ecr:*\",\n            \"cloudtrail:LookupEvents\"\n        ],\n        \"Resource\": \"arn:aws:ecr:&lt;AWS_REGION&gt;:&lt;AWS_ACCOUNT_ID&gt;:repository/&lt;EDP_NAMESPACE&gt;/*\"\n    },\n    {\n        \"Effect\": \"Allow\",\n        \"Action\": \"ecr:GetAuthorizationToken\",\n        \"Resource\": \"*\"\n    },\n    {\n        \"Effect\": \"Allow\",\n        \"Action\": [\n            \"ecr:DescribeRepositories\",\n            \"ecr:CreateRepository\"\n        ],\n        \"Resource\": \"arn:aws:ecr:&lt;AWS_REGION&gt;:&lt;AWS_ACCOUNT_ID&gt;:repository/*\"\n    }\n  ]\n}\n</code></pre> </li> <li> <p>Create AWS IAM Role \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\" with trust relationships:</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:edp:edp-kaniko\"\n        }\n      }\n    }\n  ]\n}\n</code></pre> </li> <li> <p>Attach the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko_policy\" policy to the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\" role.</p> </li> <li> <p>Define the resulted arn role value into the kaniko.roleArn parameter in values.yaml during the EDP installation.</p> </li> </ol>"},{"location":"operator-guide/kaniko-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Associate IAM Roles With Service Accounts</li> <li>Install EDP</li> </ul>"},{"location":"operator-guide/kibana-ilm-rollover/","title":"Aggregate Application Logs Using EFK Stack","text":"<p>This documentation describes the advantages of EFK stack over the traditional ELK stack, explains the value that this stack brings to EDP and instructs how to set up the EFK stack to integrate the advanced logging system with your application.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#elk-stack-overview","title":"ELK Stack Overview","text":"<p>The ELK (Elasticsearch, Logstash and Kibana) stack gives the ability to aggregate logs from all the managed systems and applications, analyze these logs and create visualizations for application and infrastructure monitoring, faster troubleshooting, security analytics and more.</p> <p>Here is a brief description of the ELK stack default components:</p> <ul> <li>Beats family - The logs shipping tool that conveys logs from the source locations, such as Filebeat, Metricbeat, Packetbeat, etc. Beats can work instead of Logstash or along with it.</li> <li>Logstash - The log processing framework for log collecting, processing, storing and searching activities.</li> <li>Elasticsearch - The distributed search and analytics engine based on Lucene Java library.</li> <li>Kibana - The visualization engine that queries the data from Elasticsearch.</li> </ul> <p> ELK Stack </p>"},{"location":"operator-guide/kibana-ilm-rollover/#efk-stack-overview","title":"EFK Stack Overview","text":"<p>We use FEK (also called EFK) (Fluent Bit, Elasticsearch, Kibana) stack in Kubernetes instead of ELK because this stack provides us with the support for Logsight for Stage Verification and Incident Detection. In addition to it, Fluent Bit has a smaller memory fingerprint than Logstash. Fluent Bit has the Inputs, Parsers, Filters and Outputs plugins similarly to Logstash.</p> <p> FEK Stack </p>"},{"location":"operator-guide/kibana-ilm-rollover/#automate-elasticsearch-index-rollover-with-ilm","title":"Automate Elasticsearch Index Rollover With ILM","text":"<p>In this guide, index rollover with the Index Lifecycle Management ILM is automated in the FEK stack.</p> <p>The resources can be created via API using curl, Postman, Kibana Dev Tools console or via GUI. They are going to be created them using Kibana Dev Tools.</p> <ol> <li> <p>Go to <code>Management</code> \u2192 <code>Dev Tools</code> in the Kibana dashboard:</p> <p> Dev Tools </p> </li> <li> <p>Create index lifecycle policy with the index rollover:</p> <p>Note</p> <p>This policy can also be created in GUI in <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Index Lifecycle Policies</code>.</p> <p>Index Lifecycle has several phases: Hot, Warm, Cold, Frozen, Delete. Indices also have different priorities in each phase. The warmer the phase, the higher the priority is supposed to be, e.g., 100 for the hot phase, 50 for the warm phase, and 0 for the cold phase. </p> <p>In this Use Case, only the Hot and Delete phases are configured. So an index will be created, rolled over to a new index when 1gb in size or 1day in time and deleted in 7 days. The rollover may not happen exactly at 1GB because it depends on how often Kibana checks the index size. Kibana usually checks the index size every 10 minutes but this can be changed by setting the indices.lifecycle.poll_interval monitoring timer.</p> <p>The index lifecycle policy example:</p> Index Lifecycle Policy <pre><code>PUT _ilm/policy/fluent-bit-policy\n{\n\"policy\": {\n\"phases\": {\n\"hot\": {\n\"min_age\": \"0ms\",\n\"actions\": {\n\"set_priority\": {\n\"priority\": 100\n},\n\"rollover\": {\n\"max_size\": \"1gb\",\n\"max_primary_shard_size\": \"1gb\",\n\"max_age\": \"1d\"\n}\n}\n},\n\"delete\": {\n\"min_age\": \"7d\",\n\"actions\": {\n\"delete\": {\n\"delete_searchable_snapshot\": true\n}\n}\n}\n}\n}\n}\n</code></pre> <p>Insert the code above into the <code>Dev Tools</code> and click the arrow to send the <code>PUT</code> request.</p> </li> <li> <p>Create an index template so that a new index is created according to this template after the rollover:</p> <p>Note</p> <p>This policy can also be created in GUI in <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Index Management</code> \u2192 <code>Index Templates</code>.</p> <p>Expand the menu below to see the index template example:</p> Index Template <pre><code>PUT /_index_template/fluent-bit\n{\n\"index_patterns\": [\"fluent-bit-kube-*\"],\n\"template\": {\n\"settings\": {\n\"index\": {\n\"lifecycle\": {\n\"name\": \"fluent-bit-policy\",\n\"rollover_alias\": \"fluent-bit-kube\"\n},\n\"number_of_shards\": \"1\",\n\"number_of_replicas\": \"0\"\n}\n}\n}\n}\n</code></pre> <p>Note</p> <ul> <li><code>index.lifecycle.rollover_alias</code> is required when using a policy containing the rollover action and specifies which alias to rollover on behalf of this index. The intention here is that the rollover alias is also defined on the index.</li> </ul> <ul> <li><code>number_of_shards</code> is the quantity of the primary shards. Elasticsearch index is really just a logical grouping of one or more physical shards, where each shard is actually a self-contained index. By distributing the documents in an index across multiple shards and distributing those shards across multiple nodes, Elasticsearch can ensure redundancy, which both protects against hardware failures and increases query capacity as nodes are added to a cluster. As the cluster grows (or shrinks), Elasticsearch automatically migrates shards to re-balance the cluster. Please refer to the official documentation here.</li> </ul> <ul> <li> <p><code>number_of_replicas</code> is the number of replica shards. A replica shard is a copy of a primary shard. Elasticsearch will never assign a replica to the same node as the primary shard, so make sure you have more than one node in your Elasticsearch cluster if you need to use replica shards. The Elasticsearch cluster details and the quantity of nodes can be checked with:</p> <pre><code>GET _cluster/health\n</code></pre> </li> </ul> <p>Since we use one node, the number_of_shards  is 1 and number_of_replicas is 0. If you put more replicas within one node, your index will get yellow status in Kibana, yet still be working.</p> </li> <li> <p>Create an empty index with write permissions:</p> <p>Note</p> <p>This index can also be created in GUI in <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Index Management</code> \u2192 <code>Indices</code>.</p> <p>Index example with the date math format:</p> Index <pre><code># URI encoded /&lt;fluent-bit-kube-{now/d}-000001&gt;\nPUT /%3Cfluent-bit-kube-%7Bnow%2Fd%7D-000001%3E\n{\n\"aliases\": {\n\"fluent-bit-kube\": {\n\"is_write_index\": true\n}\n}\n}\n</code></pre> <p>The code above will create an index in the<code>{index_name}-{current_date}-{rollover_index_increment}</code> format. For example: <code>fluent-bit-kube-2023.03.17-000001</code>.</p> <p>Please refer to the official documentation on the index rollover with Date Math here.</p> <p>Note</p> <p>It is also possible to use index pattern below if the date math format does not seem applicable:</p> <p> Index <pre><code>PUT fluent-bit-kube-000001\n{\n\"aliases\": {\n\"fluent-bit-kube\": {\n\"is_write_index\": true\n}\n}\n}\n</code></pre> </p> <p>Check the status of the created index:</p> <pre><code>GET fluent-bit-kube*-000001/_ilm/explain\n</code></pre> </li> <li> <p>Configure Fluent Bit. Play attention to the Elasticsearch Output plugin configuration.</p> <p>The important fields in the <code>[OUTPUT]</code> section are <code>Index fluent-bit-kube</code> since we should use the index with the same name as Rollover Alias in Kibana and <code>Logstash_Format Off</code> as we use the Rollover index pattern in Kibana that increments by 1.</p> <p>ConfigMap example with Configuration Variables for <code>HTTP_User</code> and <code>HTTP_Passwd</code>:</p> ConfigMap fluent-bit <pre><code>data:\nfluent-bit.conf: |\n[SERVICE]\nDaemon Off\nFlush 10\nLog_Level info\nParsers_File parsers.conf\nParsers_File custom_parsers.conf\nHTTP_Server On\nHTTP_Listen 0.0.0.0\nHTTP_Port 2020\nHealth_Check On\n\n[INPUT]\nName tail\nTag kube.*\nPath /var/log/containers/*.log\nParser docker\nMem_Buf_Limit 5MB\nSkip_Long_Lines Off\nRefresh_Interval 10\n[INPUT]\nName systemd\nTag host.*\nSystemd_Filter _SYSTEMD_UNIT=kubelet.service\nRead_From_Tail On\nStrip_Underscores On\n\n[FILTER]\nName                kubernetes\nMatch               kube.*\nKube_Tag_Prefix     kube.var.log.containers.\nKube_URL            https://kubernetes.default.svc:443\nKube_CA_File        /var/run/secrets/kubernetes.io/serviceaccount/ca.crt\nKube_Token_File     /var/run/secrets/kubernetes.io/serviceaccount/token\nMerge_Log           Off\nMerge_Log_Key       log_processed\nK8S-Logging.Parser  On\nK8S-Logging.Exclude On\n[FILTER]\nName nest\nMatch kube.*\nOperation lift\nNested_under kubernetes\nAdd_prefix kubernetes.\n[FILTER]\nName modify\nMatch kube.*\nCopy kubernetes.container_name tags.container\nCopy log message\nCopy kubernetes.container_image tags.image\nCopy kubernetes.namespace_name tags.namespace\n[FILTER]\nName nest\nMatch kube.*\nOperation nest\nWildcard tags.*\nNested_under tags\nRemove_prefix tags.\n\n[OUTPUT]\nName            es\nMatch           kube.*\nIndex           fluent-bit-kube\nHost            elasticsearch-master\nPort            9200\nHTTP_User       ${ES_USER}\nHTTP_Passwd     ${ES_PASSWORD}\nLogstash_Format Off\nTime_Key       @timestamp\nType            flb_type\nReplace_Dots    On\nRetry_Limit     False\nTrace_Error     Off\n</code></pre> </li> <li> <p>Create index pattern (Data View starting from Kibana v8.0):</p> <p>Go to <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Kibana</code> \u2192 <code>Index patterns</code> and create an index with the <code>fluent-bit-kube-*</code> pattern:</p> <p> Index Pattern </p> </li> <li> <p>Check logs in Kibana. Navigate to <code>Analytics</code> \u2192 <code>Discover</code>:</p> <p> Logs in Kibana </p> <p>Note</p> <p>In addition, in the top-right corner of the <code>Discover</code> window, there is a button called <code>Inspect</code>. Clicking on it will reveal the query that Kibana is sending to Elasticsearch. These queries can be used in Dev Tools.</p> </li> <li> <p>Monitor the created indices:</p> <pre><code>GET _cat/indices/fluent-bit-kube-*\n</code></pre> <p>Note</p> <p>Physically, the indices are located on the <code>elasticsearch</code> Kubernetes pod in <code>/usr/share/elasticsearch/data/nodes/0/indices</code>. It is recommended to backup indices only via Snapshots.</p> </li> </ol> <p>We've configured the index rollover process. Now the index will be rolled over to a new one once it reaches the indicated size or time in the policy, and old indices will be removed according to the policy as well.</p> <p>When you create an empty index that corresponds to the pattern indicated in the index template, the index template attaches <code>rollover_alias</code> with the <code>fluent-bit-kube</code> name, policy and other configured data. Then the Fluent Bit Elasticsearch output plugin sends logs to the <code>Index fluent-bit-kube</code> rollover alias. The index rollover process is managed by ILM that increments our indices united by the <code>rollover_alias</code> and distributes the log data to the latest index.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#ilm-without-rollover-policy","title":"ILM Without Rollover Policy","text":"<p>It is also possible to manage index lifecycle without rollover indicated in the policy. If this is the case, this section will explain how to refactor the index to make it look that way: <code>fluent-bit-kube-2023.03.18</code>.</p> <p>Note</p> <p>The main drawback of this method is that the indices can be managed only by their creation date.</p> <p>To manage index lifecycle without rollover policy, follow the steps below:</p> <ol> <li> <p>Create a Policy without <code>rollover</code> but with indices deletion:</p> Index Lifecycle Policy <pre><code>PUT _ilm/policy/fluent-bit-policy\n{\n\"policy\": {\n\"phases\": {\n\"hot\": {\n\"min_age\": \"0ms\",\n\"actions\": {\n\"set_priority\": {\n\"priority\": 100\n}\n}\n},\n\"delete\": {\n\"min_age\": \"7d\",\n\"actions\": {\n\"delete\": {\n\"delete_searchable_snapshot\": true\n}\n}\n}\n}\n}\n}\n</code></pre> </li> <li> <p>Create an index template with the <code>rollover_alias</code> parameter:</p> Index Template <pre><code>PUT /_index_template/fluent-bit\n{\n\"index_patterns\": [\"fluent-bit-kube-*\"],\n\"template\": {\n\"settings\": {\n\"index\": {\n\"lifecycle\": {\n\"name\": \"fluent-bit-policy\",\n\"rollover_alias\": \"fluent-bit-kube\"\n},\n\"number_of_shards\": \"1\",\n\"number_of_replicas\": \"0\"\n}\n}\n}\n}\n</code></pre> </li> <li> <p>Change the Fluent Bit <code>[OUTPUT]</code> config to this one:</p> ConfigMap fluent-bit <pre><code>[OUTPUT]\nName            es\nMatch           kube.*\nHost            elasticsearch-master\nPort            9200\nHTTP_User       ${ES_USER}\nHTTP_Passwd     ${ES_PASSWORD}\nLogstash_Format On\nLogstash_Prefix fluent-bit-kube\nLogstash_DateFormat %Y.%m.%d\nTime_Key        @timestamp\nType            flb_type\nReplace_Dots    On\nRetry_Limit     False\nTrace_Error     On\n</code></pre> </li> <li> <p>Restart Fluent Bit pods.</p> </li> </ol> <p>Fluent Bit will be producing a new index every day with the new date in its name like in the <code>fluent-bit-kube-2023.03.18</code> name. Index deleting will be performed according to the policy.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#tips-on-fluent-bit-debugging","title":"Tips on Fluent Bit Debugging","text":"<p>If you experience a lot of difficulties when dealing with Fluent Bit, this section may help you.</p> <p>Fluent Bit has docker images labelled <code>-debug</code>, e.g., <code>cr.fluentbit.io/fluent/fluent-bit:2.0.9-debug</code>.</p> <p>Change that image in the Kubernetes Fluent Bit DaemonSet and add the <code>Trace_Error On</code> parameter to the <code>[OUTPUT]</code> section in the Fluent Bit configmap:</p> <pre><code>[OUTPUT]\nTrace_Error On\n</code></pre> <p>After adding the parameter above, you will start seeing more informative logs that will probably help you find out the reason of the problem.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#related-articles","title":"Related Articles","text":"<ul> <li>Index Lifecycle Management</li> <li>Elasticsearch Output</li> </ul>"},{"location":"operator-guide/kubernetes-cluster-settings/","title":"Set Up Kubernetes","text":"<p>Make sure the cluster meets the following conditions:</p> <ol> <li> <p>Kubernetes cluster is installed with minimum 2 worker nodes with total capacity 8 Cores and 32Gb RAM.</p> </li> <li> <p>Machine with kubectl is installed with a cluster-admin access to the Kubernetes cluster.</p> </li> <li> <p>Ingress controller is installed in a cluster, for example ingress-nginx.</p> </li> <li> <p>Ingress controller is configured with the disabled HTTP/2 protocol and header size of 64k support.</p> <p>Find below an example of the Config Map for the NGINX Ingress controller:</p> <pre><code>kind: ConfigMap\napiVersion: v1\nmetadata:\nname: nginx-configuration\nnamespace: ingress-nginx\nlabels:\napp.kubernetes.io/name: ingress-nginx\napp.kubernetes.io/part-of: ingress-nginx\ndata:\nclient-header-buffer-size: 64k\nlarge-client-header-buffers: 4 64k\nuse-http2: \"false\"\n</code></pre> </li> <li> <p>Load balancer (if any exists in front of the Ingress controller) is configured with session stickiness, disabled HTTP/2 protocol and header size of 32k support.</p> </li> <li> <p>Cluster nodes and pods have access to the cluster via external URLs. For instance, add in AWS the VPC NAT gateway elastic IP to the cluster external load balancers security group).</p> </li> <li> <p>Keycloak instance is installed. To get accurate information on how to install Keycloak, please refer to the Install Keycloak instruction.</p> </li> <li> <p>Helm 3.10 or higher is installed on the installation machine with the help of the Installing Helm instruction.</p> </li> <li> <p>Storage classes are used with the Retain Reclaim Policy and Delete Reclaim Policy.</p> </li> <li> <p>We recommended using our storage class as default storage class.</p> <p>Info</p> <p>By default, EDP uses the default Storage Class in a cluster. The EDP development team recommends using the following Storage Classes. See an example below.</p> <p>Storage class templates with the Retain and Delete Reclaim Policies:</p> ebs-scgp3gp3-retain <pre><code>apiVersion: storage.k8s.io/v1\nkind: StorageClass\nmetadata:\nname: ebs-sc\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: Immediate\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Delete\nvolumeBindingMode: Immediate\nallowVolumeExpansion: true\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3-retain\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: Immediate\nallowVolumeExpansion: true\n</code></pre> </li> </ol>"},{"location":"operator-guide/kubernetes-cluster-settings/#related-articles","title":"Related Articles","text":"<ul> <li>Install Amazon EBS CSI Driver</li> <li>Install NGINX Ingress Controller</li> <li>Install Keycloak</li> </ul>"},{"location":"operator-guide/logsight-integration/","title":"Logsight Integration","text":"<p>Logsight can be integrated with the CI/CD pipeline. It connects to log data sources, analyses collected logs, and evaluates deployment risk scores.</p>"},{"location":"operator-guide/logsight-integration/#overview","title":"Overview","text":"<p>In order to understand if a microservice or a component is ready for the deployment, EDP suggests analyzing logs via Logsight to decide if the deployment is risky or not.</p> <p>Please find more about Logsight in the official documentation:</p> <ul> <li>Logsight key features and workflow</li> <li>Log analysis</li> <li>Stage verification</li> </ul>"},{"location":"operator-guide/logsight-integration/#logsight-as-a-quality-gate","title":"Logsight as a Quality Gate","text":"<p>Integration with Logsight allows enhancing and optimizing software releases by creating an additional quality gate.</p> <p>Logsight can be configured in two ways:</p> <ul> <li>SAAS - online system; for this solution a connection string is required.</li> <li>Self-deployment - local installation.</li> </ul> <p>To work with Logsight, a new Deployment Risk stage must be added to the pipeline. On this stage, the logs are analyzed with the help of Logsight mechanisms.</p> <p>On the verification screen of Logsight, continuous verification of the application deployment can be monitored, and tests can be compared for detecting test flakiness.</p> <p>For example, two versions of a microservice can be compared in order to detect critical differences. Risk score will be calculated for the state reached by version A and version B. Afterwards, the deployment risk will be calculated based on individual risk scores.</p> <p>If the deployment failure risk is greater than a predefined threshold, the verification gate blocks the deployment from going to the target environment. In such case, the Deployment Risk stage of the pipeline is not passed, and additional attention is required. The exact log messages can be displayed in the Logsight verification screen, to help debug the problem.</p>"},{"location":"operator-guide/logsight-integration/#use-logsight-for-edp-development","title":"Use Logsight for EDP Development","text":"<p>Please find below the detailed description of Logsight integration with EDP.</p>"},{"location":"operator-guide/logsight-integration/#deployment-approach","title":"Deployment Approach","text":"<p>EDP uses Logsight in a self-deploying mode.</p> <p>Logsight provides a deployment approach using Helm charts. Please find below the stack of components that must be deployed:</p> <ul> <li><code>logsight</code>\u00a0- the core component.</li> <li><code>logsight-backend</code>\u00a0- the backend that provides all necessary APIs and user management.</li> <li><code>logsight-frontend</code>\u00a0- the frontend that provides the user interface.</li> <li><code>logsight-result-api</code>\u00a0- responsible for obtaining results, for example, during the verification.</li> </ul> <p>Below is a diagram of interaction when integrating the components:</p> <p> Logsight Structure </p>"},{"location":"operator-guide/logsight-integration/#configure-fluentbit-for-sending-log-data","title":"Configure FluentBit for Sending Log Data","text":"<p>Logsight is integrated with the EDP logging stack. The integration is based on top of the EFK (ElasticSearch-FluentBit-Kibana) stack. It is necessary to deploy a stack with the security support, namely, enable the certificate support.</p> <p>A FluentBit config indicates the namespace from which the logs will be received for further analysis. Below is an example of the FluentBit config for getting logs from the <code>edp-delivery-edp-delivery-sit</code> namespace:</p> View: fluent-bit.conf <pre><code>[INPUT]\nName              tail\nTag               kube.sit.*\nPath              /var/log/containers/*edp-delivery-edp-delivery-sit*.log\nParser            docker\nMem_Buf_Limit     5MB\nSkip_Long_Lines   Off\nRefresh_Interval  10\n\n[FILTER]\nName                kubernetes\nMatch               kube.sit.*\nKube_URL            https://kubernetes.default.svc:443\nKube_CA_File        /var/run/secrets/kubernetes.io/serviceaccount/ca.crt\nKube_Token_File     /var/run/secrets/kubernetes.io/serviceaccount/token\nKube_Tag_Prefix     kube.sit.var.log.containers.\nMerge_Log           Off\nK8S-Logging.Parser  On\nK8S-Logging.Exclude On\n\n[FILTER]\nName nest\nMatch kube.sit.*\nOperation lift\nNested_under kubernetes\nAdd_prefix kubernetes.\n\n[FILTER]\nName modify\nMatch kube.sit.*\nCopy kubernetes.container_name tags.container\nCopy log message\nCopy kubernetes.container_image tags.image\nCopy kubernetes.namespace_name tags.namespace\n\n[FILTER]\nName nest\nMatch kube.sit.*\nOperation nest\nWildcard kubernetes.*\nNested_under kubernetes\nRemove_prefix kubernetes.\n\n[OUTPUT]\nName            es\nMatch           kube.sit.*\nHost            elasticsearch-master\nPort            9200\nHTTP_User elastic\nHTTP_Passwd *****\nLogstash_Format On\nLogstash_Prefix sit\nTime_Key        @timestamp\nType            flb_type\nReplace_Dots    On\nRetry_Limit     False\n\n[OUTPUT]\nMatch kube.sit.*\nName  http\nHost logsight-backend\nPort 8080\nhttp_User logsight@example.com\nhttp_Passwd *****\nuri /api/v1/logs/singles\nFormat json\njson_date_format iso8601\njson_date_key timestamp\n</code></pre>"},{"location":"operator-guide/logsight-integration/#deployment-risk-analysis","title":"Deployment Risk Analysis","text":"<p>A <code>deployment-risk</code> stage is added to the EDP CD pipeline.</p> <p> Deployment Risk </p> <p>If the deployment risk is above 70%, the red state of the pipeline is expected.</p> <p>EDP consists of a set of containerized components. For the convenience of tracking the risk deployment trend for each component, this data is stored as Jenkins artifacts.</p> <p>If the deployment risk is higher than the threshold of 70%, the EDP promotion of artifacts for the next environments does not pass. The deployment risk report can be analyzed in order to avoid the potential problems with updating the components.</p> <p>To study the report in detail, use the link from the Jenkins pipeline to the Logsight verification screen:</p> <p> Logsight Insights Logsight Insights </p> <p>In this example, logs from different versions of the <code>gerrit-operator</code> were analyzed. As can be seen from the report, a large number of new messages appeared in the logs, and the output frequency of other notifications has also changed, which led to the high deployment risk.</p> <p>The environment on which the analysis is performed can exist for different time periods. Logsight only processes the minimum total number of logs since the creating of the environment.</p>"},{"location":"operator-guide/logsight-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CD Pipeline</li> <li>Adjust Jira Integration</li> </ul>"},{"location":"operator-guide/loki-irsa/","title":"IAM Roles for Loki Service Accounts","text":"<p>Note</p> <p>Make sure that IRSA is enabled and amazon-eks-pod-identity-webhook is deployed according to the Associate IAM Roles With Service Accounts documentation.</p> <p>It is possible to use Amazon Simple Storage Service Amazon S3 as object storage for Loki. In this case Loki requires access to AWS resources. Follow the steps below to create a required role:</p> <ol> <li> <p>Create AWS IAM Policy \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki_policy\":</p> <pre><code>{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"s3:ListObjects\",\n                \"s3:ListBucket\",\n                \"s3:PutObject\",\n                \"s3:GetObject\",\n                \"s3:DeleteObject\"\n            ],\n            \"Resource\": [\n                \"arn:aws:s3:::loki-*\"\n            ]\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"s3:ListBucket\"\n            ],\n            \"Resource\": [\n                \"arn:aws:s3:::loki-*\"\n            ]\n        }\n    ]\n}\n</code></pre> </li> <li> <p>Create AWS IAM Role \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\" with trust relationships:</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:&lt;LOKI_NAMESPACE&gt;:edp-loki\"\n       }\n     }\n   }\n ]\n}\n</code></pre> </li> <li> <p>Attach the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki_policy\" policy to the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\" role.</p> </li> <li> <p>Make sure that Amazon S3 bucket with name loki-\u2039CLUSTER_NAME\u203a exists.</p> </li> <li> <p>Provide key value eks.amazonaws.com/role-arn: \"arn:aws:iam:::role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\" into the serviceAccount.annotations parameter in values.yaml during the Loki Installation."},{"location":"operator-guide/loki-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Associate IAM Roles With Service Accounts</li> <li>Install Grafana Loki</li> </ul>"},{"location":"operator-guide/manage-custom-certificate/","title":"Manage Custom Certificates","text":"<p>Familiarize yourself with the detailed instructions on adding certificates to EDP resources as well as with the respective setup for Keycloak.</p> <p>EDP components that support custom certificates can be found in the table below:</p> Helm Chart Sub Resources admin-console-operator admin-console gerrit-operator edp-gerrit jenkins-operator jenkins-operator, edp-jenkins, jenkins agents sonar-operator sonar-operator, edp-sonar keycloak-operator keycloak-operator nexus-operator oauth2-proxy edp-install oauth2-proxy edp-headlamp edp-headlamp"},{"location":"operator-guide/manage-custom-certificate/#prerequisites","title":"Prerequisites","text":"<ul> <li>The certificate in the <code>*.crt</code> format is used;</li> <li>Kubectl version 1.23.0 is installed;</li> <li>Helm version 3.10.2 is installed;</li> <li>Java with the <code>keytool</code> command inside;</li> <li>jq is installed.</li> </ul>"},{"location":"operator-guide/manage-custom-certificate/#enable-the-spi-truststore-of-keycloak","title":"Enable the SPI Truststore of Keycloak","text":"<p>To import custom certificates to Keycloak, follow the steps below:</p> <ol> <li> <p>Generate the <code>cacerts</code> local keystore and import the certificate there using the keytool tool:</p> <pre><code>keytool -importcert -file CA.crt \\\n-alias CA.crt -keystore ./cacerts \\\n-storepass changeit -trustcacerts \\\n-noprompt\n</code></pre> </li> <li> <p>Create the <code>custom-keycloak-keystore</code> keystore secret from the <code>cacerts</code> file in the <code>security</code> namespace:</p> <pre><code>kubectl -n security create secret generic custom-keycloak-keystore \\\n--from-file=./cacerts\n</code></pre> </li> <li> <p>Create the <code>spi-truststore-data</code> SPI truststore secret in the <code>security</code> namespace:</p> <pre><code>kubectl -n security create secret generic spi-truststore-data \\\n--from-literal=KC_SPI_TRUSTSTORE_FILE_FILE=/opt/keycloak/spi-certs/cacerts \\\n--from-literal=KC_SPI_TRUSTSTORE_FILE_PASSWORD=changeit\n</code></pre> </li> <li> <p>Update the Keycloak <code>values.yaml</code> file from the Install Keycloak page.</p> View: values.yaml <pre><code>...\nextraVolumeMounts: |\n...\n# Use the Keycloak truststore for SPI connection over HTTPS/TLS\n- name: spi-certificates\nmountPath: /opt/keycloak/spi-certs\nreadOnly: true\n...\n\nextraVolumes: |\n...\n# Use the Keycloak truststore for SPI connection over HTTPS/TLS\n- name: spi-certificates\nsecret:\nsecretName: custom-keycloak-keystore\ndefaultMode: 420\n...\n\n...\nextraEnvFrom: |\n- secretRef:\nname: spi-truststore-data\n...\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-custom-certificate/#enable-custom-certificates-in-edp-components","title":"Enable Custom Certificates in EDP Components","text":"<p>Creating custom certificates is a necessary but not sufficient condition for applying, therefore, certificates should be enabled as well.</p> <ol> <li> <p>Create the <code>custom-ca-certificates</code> secret in the EDP namespace.</p> <pre><code>kubectl -n edp create secret generic custom-ca-certificates \\\n--from-file=CA.crt\n</code></pre> </li> <li> <p>Add the certificate by mounting the <code>custom-ca-certificates</code> secret to the operator pod as a volume.</p> <p>Example of specifying custom certificates for the <code>keycloak-operator</code>:</p> <pre><code>...\nkeycloak-operator:\nenabled: true\n\n# -- Additional volumes to be added to the pod\nextraVolumes:\n- name: custom-ca\nsecret:\ndefaultMode: 420\nsecretName: custom-ca-certificates\n\n# -- Additional volumeMounts to be added to the container\nextraVolumeMounts:\n- name: custom-ca\nmountPath: /etc/ssl/certs/CA.crt\nreadOnly: true\nsubPath: CA.crt\n...\n</code></pre> </li> <li> <p>For Sonar, Jenkins and Gerrit, change the flag in the <code>caCerts.enabled</code> field to <code>true</code>. Also, change the name of the secret in the <code>caCerts.secret</code> field to <code>custom-ca-certificates</code>.</p> <p>Example of specifying custom certificates for <code>Gerrit</code> via the <code>gerrit-operator</code> helm chart values:</p> <pre><code>...\ngerrit-operator:\nenabled: true\ngerrit:\ncaCerts:\n# -- Flag for enabling additional CA certificates\nenabled: true\n# -- Change init CA certificates container image\nimage: adoptopenjdk/openjdk11:alpine\n# -- Name of the secret containing additional CA certificates\nsecret: custom-ca-certificates\n...\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-custom-certificate/#integrate-custom-certificates-into-jenkins-agents","title":"Integrate Custom Certificates Into Jenkins Agents","text":"<p>This section describes how to add custom certificates to Jenkins agents to use them from Java applications.</p> <p>Info</p> <p>For example, <code>curl</code> doesn't use keystore files specified in this part of the documentation.</p> <p>EDP Jenkins agents keep keystore files in two places:</p> <ul> <li><code>/etc/ssl/certs/java</code> folder with the <code>cacerts</code> file;</li> <li><code>/opt/java/openjdk/lib/security</code> folder with the <code>blocked.certs</code>, <code>cacerts</code>, <code>default.policy</code> and <code>public_suffix_list.dat</code> files.</li> </ul> <ol> <li> <p>Copy the files in <code>/etc/ssl/certs/java</code> and <code>/opt/java/openjdk/lib/security</code> directories from Jenkins agent pod to the local <code>tmp</code> folder. There is a <code>copy_certs.sh</code> script below that can manage this. It copies the files in <code>/etc/ssl/certs/java</code> and <code>/opt/java/openjdk/lib/security</code> directories from Jenkins agent pod to the local <code>tmp</code> folder and imports the custom certificate into the keystore files, after which it creates the  <code>jenkins-agent-opt-java-openjdk-lib-security-cacerts</code> and <code>jenkins-agent-etc-ssl-certs-java-cacerts</code> secrets from updated keystore files in EDP namespace. Also, the <code>jenkins-agent-opt-java-openjdk-lib-security-cacerts</code> secret contains three additional files: <code>blocked.certs</code>, <code>default.policy</code> and <code>public_suffix_list.dat</code> which managed by the <code>copy_certs.sh</code> script as well. Expand the drop-down button below to see the contents of the <code>copy_certs.sh</code> script.</p> View: copy_certs.sh <pre><code># Fill in the variables `ns` and `ca_file`\nns=\"edp-project\"\nca_file=\"/tmp/CA.crt\"\n\nimages=$(kubectl get -n \"${ns}\" cm jenkins-slaves -ojson | jq -r \".data[]\" | grep image\\&gt; | sed 's/\\s*&lt;.*&gt;\\(.*\\)&lt;.*&gt;/\\1/')\n\nimage=$(for i in ${images[@]}; do echo $i; done | grep maven-java8)\npod_name=$(echo \"${image}\" | tr '.:/' '-')\n\noverrides=\"{\\\"apiVersion\\\":\\\"v1\\\",\\\"kind\\\":\\\"Pod\\\",\\\"metadata\\\":{\\\"name\\\":\\\"${pod_name}\\\", \\\"namespace\\\": \\\"${ns}\\\"},\n\\\"spec\\\":{\\\"containers\\\":[{\\\"name\\\":\\\"${pod_name}\\\",\\\"image\\\":\\\"${image}\\\",\n\\\"command\\\":[\\\"sh\\\",\\\"-c\\\",\\\"while true;do sleep 30;done;\\\"]}]}}\"\n\nkubectl run -n \"${ns}\" \"${pod_name}\" --image \"${image}\" --overrides=\"${overrides}\"\n\nkubectl wait --for=condition=ready pod \"${pod_name}\" -n \"${ns}\"\n\ncacerts_location=$(kubectl exec -n \"${ns}\" \"${pod_name}\" \\\n-- find / -name cacerts -exec ls -la \"{}\" \\; 2&gt;/dev/null | grep -v ^l | awk '{print $9}')\n\nfor cacerts in ${cacerts_location[@]}; do echo $(dirname \"${cacerts}\"); kubectl exec -n \"${ns}\" \"${pod_name}\" -- ls $(dirname \"${cacerts}\"); done\n\nfor cacerts in ${cacerts_location[@]}; do \\\necho $(dirname \"${cacerts}\"); \\\nmkdir -p \"/tmp$(dirname \"${cacerts}\")\"; \\\nfrom_files=''; \\\nfor file in $(kubectl exec -n \"${ns}\" \"${pod_name}\" -- ls $(dirname \"${cacerts}\")); do \\\nkubectl exec -n \"${ns}\" \"${pod_name}\" -- cat \"$(dirname \"${cacerts}\")/${file}\" &gt; \"/tmp$(dirname \"${cacerts}\")/${file}\"; \\\nfrom_files=\"${from_files} --from-file=/tmp$(dirname \"${cacerts}\")/${file}\"\ndone ; \\\nkeytool -import -storepass changeit -alias kubernetes -file ${ca_file} -noprompt -keystore \"/tmp${cacerts}\"; \\\nkubectl -n \"${ns}\" create secret generic \"jenkins-agent${cacerts//\\//-}\" $from_files \\\ndone\n\nkubectl delete -n \"${ns}\" pod \"${pod_name}\" --force --grace-period=0\n</code></pre> <p>Before using the <code>copy_certs.sh</code> script, keep in mind the following:</p> <ul> <li>assign actual values to the variables <code>ns</code> and <code>ca_file</code>;</li> <li>the script collects all the images from the <code>jenkins-slaves</code> ConfigMap and uses the image of   the <code>maven-java8</code> agent as the base image of the temporary pod to get the keystore files;</li> <li>custom certificate is imported using the <code>keytool</code> application;</li> <li>the <code>jenkins-agent-opt-java-openjdk-lib-security-cacerts</code> and <code>jenkins-agent-etc-ssl-certs-java-cacerts</code> secrets will be created   in the EDP namespace.</li> </ul> </li> <li> <p>Run the <code>copy_certs.sh</code> script from the previous point after the requirements are met.</p> </li> <li> <p>Update manually the <code>jenkins-slaves</code> ConfigMap.</p> <p>Add this block with the mount of secrets to the <code>&lt;volumes&gt;&lt;/volumes&gt;</code> block of each Jenkins agent:</p> <pre><code>...\n        &lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/etc/ssl/certs/java&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-etc-ssl-certs-java-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/opt/java/openjdk/lib/security&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-opt-java-openjdk-lib-security-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n...\n</code></pre> <p>As an example, the template of <code>gradle-java11-template</code> is shown below:</p> <pre><code>...\n      &lt;/workspaceVolume&gt;\n&lt;volumes&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/etc/ssl/certs/java&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-etc-ssl-certs-java-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/opt/java/openjdk/lib/security&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-opt-java-openjdk-lib-security-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;/volumes&gt;\n&lt;containers&gt;\n...\n</code></pre> </li> <li> <p>Reload the Jenkins pod:</p> <pre><code>ns=\"edp\"\nkubectl rollout restart -n \"${ns}\" deployment/jenkins\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-custom-certificate/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Keycloak</li> </ul>"},{"location":"operator-guide/manage-jenkins-cd-job-provision/","title":"Manage Jenkins CD Pipeline Job Provisioner","text":"<p>The Jenkins CD job provisioner (or seed-job) is used to create and manage the cd-pipeline folder, and its Deploy pipelines. There is a special job-provisions/cd folder in Jenkins for these provisioners. Explore the steps for managing different provisioner types below.</p>"},{"location":"operator-guide/manage-jenkins-cd-job-provision/#default","title":"Default","text":"<p>During the EDP deployment, a default provisioner is created to deploy application with container and custom deployment type.</p> <ol> <li> <p>Find the configuration in job-provisions/cd/default.</p> </li> <li> <p>Default template is presented below:</p> View: Default template <pre><code>/* Copyright 2022 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\n\ndef pipelineName = \"${PIPELINE_NAME}-cd-pipeline\"\ndef stageName = \"${STAGE_NAME}\"\ndef qgStages = \"${QG_STAGES}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID}\"\ndef sourceType = \"${SOURCE_TYPE}\"\ndef libraryURL = \"${LIBRARY_URL}\"\ndef libraryBranch = \"${LIBRARY_BRANCH}\"\ndef isAutoDeploy = \"${AUTODEPLOY}\"\ndef scriptPath = \"Jenkinsfile\"\ndef containerDeploymentType = \"container\"\ndef deploymentType = \"${DEPLOYMENT_TYPE}\"\ndef codebaseFolder = jenkins.getItem(pipelineName)\n\ndef autoDeploy = '{\"name\":\"auto-deploy-input\",\"step_name\":\"auto-deploy-input\"}'\ndef manualDeploy = '{\"name\":\"manual-deploy-input\",\"step_name\":\"manual-deploy-input\"}'\ndef runType = isAutoDeploy.toBoolean() ? autoDeploy : manualDeploy\n\ndef stages = buildStages(deploymentType, containerDeploymentType, qgStages, runType)\n\nif (codebaseFolder == null) {\nfolder(pipelineName)\n}\n\nif (deploymentType == containerDeploymentType) {\ncreateContainerizedCdPipeline(pipelineName, stageName, stages, scriptPath, sourceType,\nlibraryURL, libraryBranch, gitCredentialsId, gitServerCrVersion,\nisAutoDeploy)\n} else {\ncreateCustomCdPipeline(pipelineName, stageName)\n}\n\ndef buildStages(deploymentType, containerDeploymentType, qgStages, runType) {\nreturn deploymentType == containerDeploymentType\n? '[{\"name\":\"init\",\"step_name\":\"init\"},' + runType + ',{\"name\":\"deploy\",\"step_name\":\"deploy\"},' + qgStages + ',{\"name\":\"promote-images\",\"step_name\":\"promote-images\"}]'\n: ''\n}\n\ndef createContainerizedCdPipeline(pipelineName, stageName, stages, pipelineScript, sourceType, libraryURL, libraryBranch, libraryCredId, gitServerCrVersion, isAutoDeploy) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nif (sourceType == \"library\") {\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(libraryURL)\ncredentials(libraryCredId)\n}\nbranches(\"${libraryBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\n}\n}\n} else {\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\nDeploy()\")\nsandbox(true)\n}\n}\n}\nproperties {\ndisableConcurrentBuilds()\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${stages}\", \"Consequence of stages in JSON format to be run during execution\")\n\nif (isAutoDeploy?.trim() &amp;&amp; isAutoDeploy.toBoolean()) {\nstringParam(\"CODEBASE_VERSION\", null, \"Codebase versions to deploy.\")\n}\n}\n}\n}\n\ndef createCustomCdPipeline(pipelineName, stageName) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nproperties {\ndisableConcurrentBuilds()\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\n}\n}\n}\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-jenkins-cd-job-provision/#custom","title":"Custom","text":"<p>In some cases, it is necessary to modify or update the job provisioner logic. For example, when adding a new stage requires a custom job provisioner created on the basis of an existing one out of the box. Take the steps below to add a custom job provision.</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/cd folder, click New Item and type the name of job provisions, for example - custom.</p> <p> CD provisioner name </p> <p>Scroll down to the Copy from field, enter \"/job-provisions/cd/default\", and click OK:   Copy CD provisioner </p> </li> <li> <p>Update the required parameters in the new provisioner. For example, if it is necessary to implement a new stage clean, add the following code to the provisioner:</p> <pre><code>   def buildStages(deploymentType, containerDeploymentType, qgStages) {\n       return deploymentType == containerDeploymentType\n? '[{\"name\":\"init\",\"step_name\":\"init\"},{\"name\":\"clean\",\"step_name\":\"clean\"},{\"name\":\"deploy\",\"step_name\":\"deploy\"},' + qgStages + ',{\"name\":\"promote-images-ecr\",\"step_name\":\"promote-images\"}]'\n: ''\n}\n</code></pre> <p>Note</p> <p>Make sure the support for the above mentioned logic is implemented. Please refer to the How to Redefine or Extend the EDP Pipeline Stages Library section of the guide.</p> <p>After the steps above are performed, the new custom job-provision will be available in Adding Stage during the CD pipeline creation in Admin Console.</p> <p> Custom CD provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/","title":"Manage Jenkins CI Pipeline Job Provisioner","text":"<p>The Jenkins CI job provisioner (or seed-job) is used to create and manage the application folder, and its Code Review, Build and Create Release pipelines. Depending on the version control system, different job provisioners are used. EDP supports integration with the following version control systems:</p> <ul> <li>Gerrit (default)</li> <li>GitHub (github)</li> <li>GitLab (gitlab)</li> </ul> <p>By default, the Jenkins operator creates a pipeline for several types of application and libraries. There is a special job-provisions/ci folder in Jenkins for these provisioners. During the EDP deployment, a default provisioner is created for integration with Gerrit version control system. To configure integration with other version control systems, you need to add the required job provisioners to job-provisions/ci folder in Jenkins.</p>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#create-custom-provisioner-custom-defaultgithubgitlab","title":"Create Custom Provisioner (custom-default/github/gitlab)","text":"<p>In some cases it is necessary to modify or update the job provisioner logic, for example when an added other code language needs to create a custom job provisioner on the basis of an existing one out of the box. Take the steps below to add a custom job provision:</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/ci folder, click New Item and type the name of job-provisions, for example - custom-github.</p> <p> CI provisioner name </p> <p>Scroll down to the Copy from field and enter \"/job-provisions/ci/github\", and click OK:   Copy ci provisioner </p> </li> <li> <p>Update the required parameters in the new provisioner. For example, if it is necessary to implement a new build tool docker, several parameters are to be updated. Add the following stages to the docker Code Review and Build pipelines for docker application:</p> <pre><code>stages['Code-review-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"lint\"},{\"name\": \"build\"}]'\n...\nstages['Build-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"lint\"},{\"name\": \"build\"},{\"name\": \"push\"},{\"name\": \"git-tag\"}]'\n...\ndef getStageKeyName(buildTool) {\n    ...\n    if (buildTool.toString().equalsIgnoreCase('docker')) {\n    return \"Code-review-application-docker\"\n}\n    ...\n}\n</code></pre> <p>Note</p> <p>Make sure the support for the above mentioned logic is implemented. Please refer to the How to Redefine or Extend the EDP Pipeline Stages Library section of the guide.</p> <p>Note</p> <p>The default template should be changed if there is another creation logic for the Code Review, Build and Create Release pipelines. Furthermore, all pipeline types should have the necessary stages as well.</p> <p>After the steps above are performed, the new custom job provision will be available in Advanced Settings during the application creation in the EDP Portal UI:</p> <p> Custom ci provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#gerrit-default","title":"Gerrit (default)","text":"<p>During the EDP deployment, a default provisioner is created for integration with Gerrit version control system.</p> <ol> <li> <p>Find the configuration in job-provisions/ci/default.</p> </li> <li> <p>Default template is presented below:</p> View: Default template <pre><code>/* Copyright 2022 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef platformType = \"${PLATFORM_TYPE}\"\ndef buildStage = platformType.toString() == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"}' : ',{\"name\": \"build-image-from-dockerfile\"}'\ndef buildTool = \"${BUILD_TOOL}\"\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + ']'\nstages['Code-review-default'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\nstages['Code-review-library-kaniko'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"dockerbuild-verify\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-autotests-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-autotests-gradle'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"tests\"}' +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' +\n\"${buildStage}\" + ',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef defaultBuild = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef repositoryPath = \"${REPOSITORY_PATH}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\nfolder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"CreateRelease\",\nrepositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch)\n\nif (buildTool.toString().equalsIgnoreCase('none')) {\nreturn true\n}\n\nif (BRANCH) {\ndef branch = \"${BRANCH}\"\ndef formattedBranch = \"${branch.toUpperCase().replaceAll(/\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef crKey = getStageKeyName(buildTool)\ncreateCiPipeline(\"Code-review-${codebaseName}\", codebaseName, stages[crKey], \"CodeReview\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library') || type.equalsIgnoreCase('autotests')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name})\njobExists = true\n\ncreateCiPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultBuild), \"Build\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\nif(!jobExists)\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n\ndef createCiPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, watchBranch, gitServerCrName, gitServerCrVersion) {\npipelineJob(\"${codebaseName}/${watchBranch.toUpperCase().replaceAll(/\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ntriggers {\ngerrit {\nevents {\nif (pipelineName.contains(\"Build\"))\nchangeMerged()\nelse\npatchsetCreated()\n}\nproject(\"plain:${codebaseName}\", [\"plain:${watchBranch}\"])\n}\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nstringParam(\"BRANCH\", \"${watchBranch}\", \"Branch to build artifact from\")\n}\n}\n}\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\nif (buildTool.toString().equalsIgnoreCase('kaniko')) {\nreturn \"Code-review-library-kaniko\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"PLATFORM_TYPE\", \"${platformType}\", \"Platform type\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, DEFAULT_BRANCH will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n</code></pre> <p>Job Provision Pipeline Parameters</p> <p>The job-provisions pipeline consists of the following parameters of type string:</p> </li> </ol> <ul> <li>NAME - the application name;</li> </ul> <ul> <li>TYPE - the codebase type (the application / library / autotest);</li> </ul> <ul> <li>BUILD_TOOL - a tool that is used to build the application;</li> </ul> <ul> <li>BRANCH - a branch name;</li> </ul> <ul> <li>GIT_SERVER_CR_NAME - the name of the application Git server custom resource;</li> </ul> <ul> <li>GIT_SERVER_CR_VERSION - the version of the application Git server custom resource;</li> </ul> <ul> <li>GIT_CREDENTIALS_ID - the secret name where Git server credentials are stored (default 'gerrit-ciuser-sshkey');</li> </ul> <ul> <li>REPOSITORY_PATH - the full repository path;</li> </ul> <ul> <li>JIRA_INTEGRATION_ENABLED - the Jira integration is enabled or not;</li> </ul> <ul> <li>PLATFORM_TYPE - the type of platform (kubernetes or openshift);</li> </ul> <ul> <li>DEFAULT_BRANCH - the default repository branch.</li> </ul>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#github-github","title":"GitHub (github)","text":"<p>To create a new job provision for work with GitHub, take the following steps:</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/ci folder.</p> </li> <li> <p>Click New Item and type the name of job-provisions - github.</p> </li> <li> <p>Select the Freestyle project option and click OK.</p> </li> <li> <p>Select the Discard old builds check box and configure a few parameters:</p> <p>Strategy: Log Rotation</p> <p>Days to keep builds: 10</p> <p>Max # of builds to keep: 10</p> </li> <li> <p>Select the This project is parameterized check box and add a few input parameters (the type of the variables is string):</p> <ul> <li>NAME;</li> </ul> <ul> <li>TYPE;</li> </ul> <ul> <li>BUILD_TOOL;</li> </ul> <ul> <li>BRANCH;</li> </ul> <ul> <li>GIT_SERVER_CR_NAME;</li> </ul> <ul> <li>GIT_SERVER_CR_VERSION;</li> </ul> <ul> <li>GIT_CREDENTIALS_ID;</li> </ul> <ul> <li>REPOSITORY_PATH;</li> </ul> <ul> <li>JIRA_INTEGRATION_ENABLED;</li> </ul> <ul> <li>PLATFORM_TYPE;</li> </ul> <ul> <li>DEFAULT_BRANCH.</li> </ul> </li> <li> <p>Check the Execute concurrent builds if necessary option.</p> </li> <li> <p>Check the Restrict where this project can be run option.</p> </li> <li> <p>Fill in the Label Expression field by typing master to ensure job runs on Jenkins Master.</p> </li> <li> <p>In the Build section, perform the following:</p> <ul> <li>Select DSL Script;</li> </ul> <ul> <li>Select the Use the provided DSL script check box:</li> </ul> <p> DSL script check box </p> </li> <li> <p>As soon as all the steps above are performed, insert the code:</p> View: Template <pre><code>import groovy.json.*\nimport jenkins.model.Jenkins\nimport javaposse.jobdsl.plugin.*\nimport com.cloudbees.hudson.plugins.folder.*\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef platformType = \"${PLATFORM_TYPE}\"\ndef buildStage = platformType == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"}' : ',{\"name\": \"build-image-from-dockerfile\"}'\ndef buildTool = \"${BUILD_TOOL}\"\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},' +\n'{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + ']'\nstages['Code-review-default'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\nstages['Code-review-library-kaniko'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"dockerbuild-verify\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-autotests-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-autotests-gradle'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build\"}' + \"${buildStage}\" + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},{\"name\": \"tests\"},{\"name\": \"sonar\"}' +\n\"${buildStage}\" + ',{\"name\":\"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef defaultStages = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef repositoryPath = \"${REPOSITORY_PATH.replaceAll(~/:\\d+\\\\//,\"/\")}\"\ndef githubRepository = \"https://${repositoryPath.split(\"@\")[1]}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\n    folder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"CreateRelease\",\n        repositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch)\n\nif (buildTool.toString().equalsIgnoreCase('none')) {\n    return true\n}\n\nif (BRANCH) {\n    def branch = \"${BRANCH}\"\n    def formattedBranch = \"${branch.toUpperCase().replaceAll(/\\\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\ndef crKey = getStageKeyName(buildTool).toString()\ncreateCodeReviewPipeline(\"Code-review-${codebaseName}\", codebaseName, stages.get(crKey, defaultStages), \"CodeReview\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion, githubRepository)\nregisterWebHook(repositoryPath)\n\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\n\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library') || type.equalsIgnoreCase('autotests')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name})\njobExists = true\ncreateBuildPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultStages), \"Build\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion, githubRepository)\nregisterWebHook(repositoryPath, 'build')\n\nif(!jobExists)\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\nif (buildTool.toString().equalsIgnoreCase('kaniko')) {\nreturn \"Code-review-library-kaniko\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createCodeReviewPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, defaultBranch, gitServerCrName, gitServerCrVersion, githubRepository) {\npipelineJob(\"${codebaseName}/${defaultBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nif (pipelineName.contains(\"Build\"))\nstringParam(\"BRANCH\", \"${defaultBranch}\", \"Branch to build artifact from\")\nelse\nstringParam(\"BRANCH\", \"\\${ghprbActualCommit}\", \"Branch to build artifact from\")\n}\n}\ntriggers {\ngithubPullRequest {\ncron('')\nonlyTriggerPhrase(false)\nuseGitHubHooks(true)\npermitAll(true)\nautoCloseFailedPullRequests(false)\ndisplayBuildErrorsOnDownstreamBuilds(false)\nwhiteListTargetBranches([defaultBranch.toString()])\nextensions {\ncommitStatus {\ncontext('Jenkins Code-Review')\ntriggeredStatus('Build is Triggered')\nstartedStatus('Build is Started')\naddTestResults(true)\ncompletedStatus('SUCCESS', 'Verified')\ncompletedStatus('FAILURE', 'Failed')\ncompletedStatus('PENDING', 'Penging')\ncompletedStatus('ERROR', 'Error')\n}\n}\n}\n}\nproperties {\ngithubProjectProperty {\nprojectUrlStr(\"${githubRepository}\")\n}\n}\n}\n}\n\ndef createBuildPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, defaultBranch, gitServerCrName, gitServerCrVersion, githubRepository) {\npipelineJob(\"${codebaseName}/${defaultBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\nnode {\\n    git credentialsId: \\'${credId}\\', url: \\'${repository}\\', branch: \\'${BRANCH}\\'\\n}\\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nstringParam(\"BRANCH\", \"${defaultBranch}\", \"Branch to run from\")\n}\n}\ntriggers {\ngitHubPushTrigger()\n}\nproperties {\ngithubProjectProperty {\nprojectUrlStr(\"${githubRepository}\")\n}\n}\n}\n}\n\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"PLATFORM_TYPE\", \"${platformType}\", \"Platform type\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, DEFAULT_BRANCH will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n\ndef registerWebHook(repositoryPath, type = 'code-review') {\ndef url = repositoryPath.split('@')[1].split('/')[0]\ndef owner = repositoryPath.split('@')[1].split('/')[1]\ndef repo = repositoryPath.split('@')[1].split('/')[2]\ndef apiUrl = 'https://api.' + url + '/repos/' + owner + '/' + repo + '/hooks'\ndef webhookUrl = ''\ndef webhookConfig = [:]\ndef config = [:]\ndef events = []\n\nif (type.equalsIgnoreCase('build')) {\nwebhookUrl = System.getenv('JENKINS_UI_URL') + \"/github-webhook/\"\nevents = [\"push\"]\nconfig[\"url\"] = webhookUrl\nconfig[\"content_type\"] = \"json\"\nconfig[\"insecure_ssl\"] = 0\nwebhookConfig[\"name\"] = \"web\"\nwebhookConfig[\"config\"] = config\nwebhookConfig[\"events\"] = events\nwebhookConfig[\"active\"] = true\n\n} else {\nwebhookUrl = System.getenv('JENKINS_UI_URL') + \"/ghprbhook/\"\nevents = [\"issue_comment\",\"pull_request\"]\nconfig[\"url\"] = webhookUrl\nconfig[\"content_type\"] = \"form\"\nconfig[\"insecure_ssl\"] = 0\nwebhookConfig[\"name\"] = \"web\"\nwebhookConfig[\"config\"] = config\nwebhookConfig[\"events\"] = events\nwebhookConfig[\"active\"] = true\n}\n\ndef requestBody = JsonOutput.toJson(webhookConfig)\ndef http = new URL(apiUrl).openConnection() as HttpURLConnection\nhttp.setRequestMethod('POST')\nhttp.setDoOutput(true)\nprintln(apiUrl)\nhttp.setRequestProperty(\"Accept\", 'application/json')\nhttp.setRequestProperty(\"Content-Type\", 'application/json')\nhttp.setRequestProperty(\"Authorization\", \"token ${getSecretValue('github-access-token')}\")\nhttp.outputStream.write(requestBody.getBytes(\"UTF-8\"))\nhttp.connect()\nprintln(http.responseCode)\n\nif (http.responseCode == 201) {\nresponse = new JsonSlurper().parseText(http.inputStream.getText('UTF-8'))\n} else {\nresponse = new JsonSlurper().parseText(http.errorStream.getText('UTF-8'))\n}\n\nprintln \"response: ${response}\"\n}\n\ndef getSecretValue(name) {\ndef creds = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(\ncom.cloudbees.plugins.credentials.common.StandardCredentials.class,\nJenkins.instance,\nnull,\nnull\n)\n\ndef secret = creds.find { it.properties['id'] == name }\nreturn secret != null ? secret['secret'] : null\n}\n</code></pre> <p>After the steps above are performed, the new custom job-provision will be available in Advanced Settings during the application creation in the EDP Portal UI:</p> <p> Github job provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#gitlab-gitlab","title":"GitLab (gitlab)","text":"<p>To create a new job provision for work with GitLab, take the following steps:</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/ci folder.</p> </li> <li> <p>Click New Item and type the name of job-provisions - gitlab.</p> </li> <li> <p>Select the Freestyle project option and click OK.</p> </li> <li> <p>Select the Discard old builds check box and configure a few parameters:</p> <p>Strategy: Log Rotation</p> <p>Days to keep builds: 10</p> <p>Max # of builds to keep: 10</p> </li> <li> <p>Select the This project is parameterized check box and add a few input parameters as the following strings (the type of the variables is string):</p> <ul> <li>NAME;</li> </ul> <ul> <li>TYPE;</li> </ul> <ul> <li>BUILD_TOOL;</li> </ul> <ul> <li>BRANCH;</li> </ul> <ul> <li>GIT_SERVER_CR_NAME;</li> </ul> <ul> <li>GIT_SERVER_CR_VERSION;</li> </ul> <ul> <li>GIT_SERVER;</li> </ul> <ul> <li>GIT_SSH_PORT;</li> </ul> <ul> <li>GIT_USERNAME;</li> </ul> <ul> <li>GIT_CREDENTIALS_ID;</li> </ul> <ul> <li>REPOSITORY_PATH;</li> </ul> <ul> <li>JIRA_INTEGRATION_ENABLED;</li> </ul> <ul> <li>PLATFORM_TYPE;</li> </ul> <ul> <li>DEFAULT_BRANCH;</li> </ul> </li> <li> <p>Check the Execute concurrent builds if necessary option.</p> </li> <li> <p>Check the Restrict where this project can be run option.</p> </li> <li> <p>Fill in the Label Expression field by typing master to ensure job runs on Jenkins Master.</p> </li> <li> <p>In the Build Steps section, perform the following:</p> <ul> <li>Select Add build step;</li> </ul> <ul> <li>Choose Process Job DSLs; </li> </ul> <ul> <li>Select the Use the provided DSL script check box:</li> </ul> <p> DSL script check box </p> </li> <li> <p>As soon as all the steps above are performed, insert the code:</p> View: Template <pre><code>import groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef platformType = \"${PLATFORM_TYPE}\"\ndef buildTool = \"${BUILD_TOOL}\"\ndef buildImageStage = platformType == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"},' : ',{\"name\": \"build-image-from-dockerfile\"},'\ndef goBuildImageStage = platformType == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"}' : ',{\"name\": \"build-image-from-dockerfile\"}'\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},' +\n'{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + ']'\nstages['Code-review-default'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\nstages['Code-review-library-kaniko'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"dockerbuild-verify\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-autotests-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-autotests-gradle'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildImageStage}\" +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},{\"name\": \"tests\"},{\"name\": \"sonar\"}' +\n\"${buildImageStage}\" + '{\"name\":\"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildImageStage}\" +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${buildImageStage}\" +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"tool-init\"},' +\n'{\"name\": \"lint\"},{\"name\": \"git-tag\"}]'\nstages['Build-application-helm'] = '[{\"name\": \"checkout\"},{\"name\": \"lint\"}]'\nstages['Build-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"lint\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build\"}' + \"${goBuildImageStage}\" + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef defaultStages = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitServer = \"${GIT_SERVER ? GIT_SERVER : 'gerrit'}\"\ndef gitSshPort = \"${GIT_SSH_PORT ? GIT_SSH_PORT : '29418'}\"\ndef gitUsername = \"${GIT_USERNAME ? GIT_USERNAME : 'jenkins'}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef defaultRepoPath = \"ssh://${gitUsername}@${gitServer}:${gitSshPort}/${codebaseName}\"\ndef repositoryPath = \"${REPOSITORY_PATH ? REPOSITORY_PATH : defaultRepoPath}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\nfolder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"CreateRelease\",\nrepositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch)\n\nif (BRANCH) {\ndef branch = \"${BRANCH}\"\ndef formattedBranch = \"${branch.toUpperCase().replaceAll(/\\\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef crKey = getStageKeyName(buildTool).toString()\ncreateCiPipeline(\"Code-review-${codebaseName}\", codebaseName, stages.get(crKey, defaultStages), \"CodeReview\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\n\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library') || type.equalsIgnoreCase('autotests')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name}) {\njobExists = true\n}\ncreateCiPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultStages), \"Build\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\nif(!jobExists) {\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n}\n\n\ndef createCiPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, defaultBranch, gitServerCrName, gitServerCrVersion) {\ndef jobName = \"${defaultBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\"\ndef existingJob = Jenkins.getInstance().getItemByFullName(\"${codebaseName}/${jobName}\")\ndef webhookToken = null\nif (existingJob) {\ndef triggersMap = existingJob.getTriggers()\ntriggersMap.each { key, value -&gt;\nwebhookToken = value.getSecretToken()\n}\n} else {\ndef random = new byte[16]\nnew java.security.SecureRandom().nextBytes(random)\nwebhookToken = random.encodeHex().toString()\n}\npipelineJob(\"${codebaseName}/${jobName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\nproperties {\ngitLabConnection {\ngitLabConnection('gitlab')\n}\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nif (pipelineName.contains(\"Build\"))\nstringParam(\"BRANCH\", \"${defaultBranch}\", \"Branch to build artifact from\")\nelse\nstringParam(\"BRANCH\", \"\\${gitlabMergeRequestLastCommit}\", \"Branch to build artifact from\")\n}\n}\ntriggers {\ngitlabPush {\nbuildOnMergeRequestEvents(pipelineName.contains(\"Build\") ? false : true)\nbuildOnPushEvents(pipelineName.contains(\"Build\") ? true : false)\nenableCiSkip(false)\nsetBuildDescription(true)\nrebuildOpenMergeRequest(pipelineName.contains(\"Build\") ? 'never' : 'source')\ncommentTrigger(\"Build it please\")\nskipWorkInProgressMergeRequest(true)\ntargetBranchRegex(\"${defaultBranch}\")\n}\n}\nconfigure {\nit / triggers / 'com.dabsquared.gitlabjenkins.GitLabPushTrigger' &lt;&lt; secretToken(webhookToken)\nit / triggers / 'com.dabsquared.gitlabjenkins.GitLabPushTrigger' &lt;&lt; triggerOnApprovedMergeRequest(pipelineName.contains(\"Build\") ? false : true)\nit / triggers / 'com.dabsquared.gitlabjenkins.GitLabPushTrigger' &lt;&lt; pendingBuildName(pipelineName.contains(\"Build\") ? \"\" : \"Jenkins\")\n}\n}\nregisterWebHook(repository, codebaseName, jobName, webhookToken)\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\nif (buildTool.toString().equalsIgnoreCase('kaniko')) {\nreturn \"Code-review-library-kaniko\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"PLATFORM_TYPE\", \"${platformType}\", \"Platform type\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, DEFAULT_BRANCH will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n\ndef registerWebHook(repositoryPath, codebaseName, jobName, webhookToken) {\ndef apiUrl = 'https://' + repositoryPath.replaceAll(\"ssh://\", \"\").split('@')[1].replace('/', \"%2F\").replaceAll(~/:\\d+%2F/, '/api/v4/projects/') + '/hooks'\ndef jobWebhookUrl = \"${System.getenv('JENKINS_UI_URL')}/project/${codebaseName}/${jobName}\"\ndef gitlabToken = getSecretValue('gitlab-access-token')\n\nif (checkWebHookExist(apiUrl, jobWebhookUrl, gitlabToken)) {\nprintln(\"[JENKINS][DEBUG] Webhook for job ${jobName} is already exist\\r\\n\")\nreturn\n}\n\nprintln(\"[JENKINS][DEBUG] Creating webhook for job ${jobName}\")\ndef webhookConfig = [:]\nwebhookConfig[\"url\"] = jobWebhookUrl\nwebhookConfig[\"push_events\"] = jobName.contains(\"Build\") ? \"true\" : \"false\"\nwebhookConfig[\"merge_requests_events\"] = jobName.contains(\"Build\") ? \"false\" : \"true\"\nwebhookConfig[\"issues_events\"] = \"false\"\nwebhookConfig[\"confidential_issues_events\"] = \"false\"\nwebhookConfig[\"tag_push_events\"] = \"false\"\nwebhookConfig[\"note_events\"] = \"true\"\nwebhookConfig[\"job_events\"] = \"false\"\nwebhookConfig[\"pipeline_events\"] = \"false\"\nwebhookConfig[\"wiki_page_events\"] = \"false\"\nwebhookConfig[\"enable_ssl_verification\"] = \"true\"\nwebhookConfig[\"token\"] = webhookToken\ndef requestBody = JsonOutput.toJson(webhookConfig)\ndef httpConnector = new URL(apiUrl).openConnection() as HttpURLConnection\nhttpConnector.setRequestMethod('POST')\nhttpConnector.setDoOutput(true)\n\nhttpConnector.setRequestProperty(\"Accept\", 'application/json')\nhttpConnector.setRequestProperty(\"Content-Type\", 'application/json')\nhttpConnector.setRequestProperty(\"PRIVATE-TOKEN\", \"${gitlabToken}\")\nhttpConnector.outputStream.write(requestBody.getBytes(\"UTF-8\"))\nhttpConnector.connect()\n\nif (httpConnector.responseCode == 201)\nprintln(\"[JENKINS][DEBUG] Webhook for job ${jobName} has been created\\r\\n\")\nelse {\nprintln(\"[JENKINS][ERROR] Responce code - ${httpConnector.responseCode}\")\ndef response = new JsonSlurper().parseText(httpConnector.errorStream.getText('UTF-8'))\nprintln(\"[JENKINS][ERROR] Failed to create webhook for job ${jobName}. Response - ${response}\")\n}\n}\n\ndef checkWebHookExist(apiUrl, jobWebhookUrl, gitlabToken) {\nprintln(\"[JENKINS][DEBUG] Checking if webhook ${jobWebhookUrl} exists\")\ndef httpConnector = new URL(apiUrl).openConnection() as HttpURLConnection\nhttpConnector.setRequestMethod('GET')\nhttpConnector.setDoOutput(true)\n\nhttpConnector.setRequestProperty(\"Accept\", 'application/json')\nhttpConnector.setRequestProperty(\"Content-Type\", 'application/json')\nhttpConnector.setRequestProperty(\"PRIVATE-TOKEN\", \"${gitlabToken}\")\nhttpConnector.connect()\n\nif (httpConnector.responseCode == 200) {\ndef response = new JsonSlurper().parseText(httpConnector.inputStream.getText('UTF-8'))\nreturn response.find { it.url == jobWebhookUrl } ? true : false\n}\n}\n\ndef getSecretValue(name) {\ndef creds = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(\ncom.cloudbees.plugins.credentials.common.StandardCredentials.class,\nJenkins.instance,\nnull,\nnull\n)\n\ndef secret = creds.find { it.properties['id'] == name }\nreturn secret != null ? secret['secret'] : null\n}\n</code></pre> <p>After the steps above are performed, the new custom job-provision will be available in Advanced Settings during the application creation in the EDP Portal UI:</p> <p> Gitlab job provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#related-articles","title":"Related Articles","text":"<ul> <li>CI Pipeline for Container</li> <li>GitLab Webhook Configuration</li> <li>GitHub Webhook Configuration</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> </ul>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/","title":"Migrate CI Pipelines From Jenkins to Tekton","text":"<p>To migrate the CI pipelines for a codebase from Jenkins to Tekton, follow the steps below:</p> <ul> <li>Migrate CI Pipelines From Jenkins to Tekton</li> <li>Deploy a Custom EDP Scenario With Tekton and Jenkins CI Tools</li> <li>Disable Jenkins Triggers</li> <li>Manage Tekton Triggers the Codebase(s)</li> <li>Switch CI Tool for Codebase(s)</li> </ul>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#deploy-a-custom-edp-scenario-with-tekton-and-jenkins-ci-tools","title":"Deploy a Custom EDP Scenario With Tekton and Jenkins CI Tools","text":"<p>Make sure that Tekton stack is deployed according to the documentation. Enable Tekton as an EDP subcomponent:</p> values.yaml<pre><code>edp-tekton:\nenabled: true\n</code></pre>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#disable-jenkins-triggers","title":"Disable Jenkins Triggers","text":"<p>To disable Jenkins Triggers for the codebase, add the following code to the provisioner:</p> job-provisioner<pre><code>def tektonCodebaseList = [\"&lt;codebase_name&gt;\"]\nif (!tektonCodebaseList.contains(codebaseName.toString())){\ntriggers {\ngerrit {\nevents {\nif (pipelineName.contains(\"Build\"))\nchangeMerged()\nelse\npatchsetCreated()\n}\nproject(\"plain:${codebaseName}\", [\"plain:${watchBranch}\"])\n}\n}\n}\n</code></pre> <p>Note</p> <p>The sample above shows the usage of Gerrit VCS where the <code>&lt;codebase_name&gt;</code> value is your codebase name.</p> <ul> <li>If using GitHub or GitLab, additionally remove the webhook from the relevant repository.</li> <li>If webhooks generation for new codebase(s) is not required, correct the code above so that it creates a webhook in the job-provisioner.</li> <li>To recreate the pipeline in Jenkins, trigger the job-provisioner.</li> <li>Check that the new pipeline is created without triggering Gerrit events.</li> </ul>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#manage-tekton-triggers-the-codebases","title":"Manage Tekton Triggers the Codebase(s)","text":"<p>By default, each Gerrit project inherits configuration from the All-Projects repository.</p> <p>To exclude triggering in Jenkins and Tekton CI tools simultaneously, edit the configuration in the All-Projects repository or in the project which inherits rights from your project.</p> <p>Edit the webhooks.config file in the refs/meta/config and remove all context from this configuration.</p> <p>Warning</p> <p>The clearance of the webhooks.config file will disable the pipeline trigger in Tekton.</p> <p>To use Tekton pipelines, add the configuration to the corresponding Gerrit project (webhooks.config file in the refs/meta/config):</p> webhooks.config<pre><code>[remote \"changemerged\"]\nurl = http://el-gerrit-listener:8080\nevent = change-merged\n[remote \"patchsetcreated\"]\nurl = http://el-gerrit-listener:8080\nevent = patchset-created\n</code></pre>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#switch-ci-tool-for-codebases","title":"Switch CI Tool for Codebase(s)","text":"<p>Go to the codebase Custom Resource and change the <code>spec.ciTool</code> field from <code>jenkins</code> to <code>tekton</code>.</p>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Tekton</li> </ul>"},{"location":"operator-guide/multitenant-logging/","title":"Multitenant Logging","text":"<p>Get acquainted with the multitenant logging components and the project logs location in the Shared cluster.</p>"},{"location":"operator-guide/multitenant-logging/#logging-components","title":"Logging Components","text":"<p>To configure the multitenant logging, it is necessary to deploy the following components:</p> <ul> <li>Grafana</li> <li>Loki</li> <li>Logging-operator</li> <li>Logging-operator stack-fluentbit</li> </ul> <p>In Grafana, every tenant represents an organization, i.e. it is necessary to create an organization for every namespace in the cluster. To get more details regarding the architecture of the Logging Operator, please review the Diagram 1.</p> <p> Logging operator scheme </p> <p>Note</p> <p>It is necessary to deploy Loki with the <code>auth_enabled: true</code> flag with the aim to ensure that the logs are separated for each tenant. For the authentication, Loki requires the HTTP header X-Scope-OrgID.</p>"},{"location":"operator-guide/multitenant-logging/#review-project-logs-in-grafana","title":"Review Project Logs in Grafana","text":"<p>To find the project logs, navigate to Grafana and follow the steps below:</p> <p>Note</p> <p>Grafana is a common service for different customers where each customer works in its own separated Grafana Organization and doesn't have any access to another project.</p> <ol> <li> <p>Choose the organization by clicking the Current Organization drop-down list. If a user is assigned to several organizations, switch easily by using the Switch button.</p> <p> Current organization </p> </li> <li> <p>Navigate to the left-side menu and click the Explore button to see the Log Browser:</p> <p> Grafana explore </p> </li> <li> <p>Click the Log Browser button to see the labels that can be used to filter logs (e.g., hostname, namespace, application name, pod, etc.):</p> <p>Note</p> <p>Enable the correct data source, select the relevant logging data from the top left-side corner, and pay attention that the data source name always follows the \u2039project_name\u203a-logging pattern.</p> <p> Log browser </p> </li> <li> <p>Filter out logs by clicking the Show logs button or write the query and click the Run query button.</p> </li> <li> <p>Review the results with the quantity of logs per time, see the example below:</p> <p> Logs example </p> <ul> <li>Expand the logs to get detailed information about the object entry:</li> </ul> <p> Expand logs </p> <ul> <li>Use the following buttons to include or remove the labels from the query:</li> </ul> <p> Addition button </p> <ul> <li>See the ad-hoc statistics for a particular label:</li> </ul> <p> Ad-hoc stat example </p> </li> </ol>"},{"location":"operator-guide/multitenant-logging/#related-articles","title":"Related Articles","text":"<ul> <li>Grafana Documentation</li> </ul>"},{"location":"operator-guide/namespace-management/","title":"Manage Namespace","text":"<p>EDP provides the ability to deploy services to namespaces. By default, EDP creates these namespaces automatically. This chapter describes the alternative way of namespace creation and management.</p>"},{"location":"operator-guide/namespace-management/#overview","title":"Overview","text":"<p>Namespaces are typically created by the platform when running CD Pipelines. The operator creates them according to the specific format: <code>edp-&lt;application-name&gt;-&lt;stage-name&gt;</code>. The <code>cd-pipeline-operator</code> should have the permissions to automatically create namespaces when deploying applications and delete them when uninstalling applications.</p>"},{"location":"operator-guide/namespace-management/#disable-automatic-namespace-creation","title":"Disable Automatic Namespace Creation","text":"<p>Occasionally, there are cases when automatic creation of namespaces is not allowed. For example, due to security reasons of the project, EDP user may need to disable this setting. This option is manipulated by the <code>manageNamespace</code> parameter which is located in the values.yaml file. The <code>manageNamespace</code> parameter is set to <code>true</code> by default, but it can be changed to false. As an aftermath, after setting the <code>manageNamespace</code> parameter users are supposed to face the problem that they can not deploy their application in EDP Portal UI because of permission restrictions:</p> <p> Namespace creation error </p> <p>The error message shown above says that user needs to create the namespace in the <code>edp-&lt;application-name&gt;-&lt;stage-name&gt;</code> format first before creating stages. In addition to it, the <code>cd-pipeline-operator</code> must be granted with the administrator permissions to have the ability to manage this namespace. The manual namespace creation procedure does not depend on the deployment scenario whether Jenkins or Tekton is used. To create namespace manually, follow the steps below:</p> <ol> <li> <p>Create the namespace by running the command below:</p> <pre><code> kubectl create namespace edp-&lt;pipelineName&gt;-&lt;stageName&gt;\n</code></pre> </li> <li> <p>Create the administrator RoleBinding resource by applying the file below with the <code>kubectl apply -f grant_admin_permissions.yaml</code> command:</p> View: grant_admin_permissions.yaml <pre><code> kind: RoleBinding\napiVersion: rbac.authorization.k8s.io/v1\nmetadata:\nname: edp-cd-pipeline-operator-admin\nnamespace: edp-&lt;pipelineName&gt;-&lt;stageName&gt;\nsubjects:\n- kind: ServiceAccount\nname: edp-cd-pipeline-operator\nnamespace: edp\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: ClusterRole\nname: admin\n</code></pre> </li> <li> <p>Restart the cd-pipeline-operator pod, in order not to wait for the operator reconciliation.</p> </li> </ol>"},{"location":"operator-guide/namespace-management/#cd-pipeline-operator-rbac-model","title":"CD Pipeline Operator RBAC Model","text":"<p>The <code>manageNamespace</code> parameter also defines the resources that will be created depending on the cluster deployed whether it is OpenShift or Kubernetes. This scheme displays the nesting of operator input parameters:</p> <p> CD Pipeline Operator Input Parameter Scheme </p> <p>Note</p> <p>When deploying application on the OpenShift cluster, the <code>registry-view</code> RoleBinding is created in the main namespace.</p>"},{"location":"operator-guide/namespace-management/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Access Model</li> <li>EKS OIDC With Keycloak</li> </ul>"},{"location":"operator-guide/nexus-sonatype/","title":"Nexus Sonatype Integration","text":"<p>This documentation guide provides comprehensive instructions for integrating Nexus with the EPAM Delivery Platform.</p> <p></p> <p>Info</p> <p>In EDP release 3.5, we have changed the deployment strategy for the nexus-operator component, now it is not installed by default. The <code>nexusURL</code> parameter management has been transferred from the values.yaml file to Kubernetes secrets.</p>"},{"location":"operator-guide/nexus-sonatype/#prerequisites","title":"Prerequisites","text":"<p>Before proceeding, ensure that you have the following prerequisites:</p> <ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/nexus-sonatype/#installation","title":"Installation","text":"<p>To install Nexus with pre-defined templates, use the nexus-operator installed via Cluster Add-Ons approach.</p>"},{"location":"operator-guide/nexus-sonatype/#configuration","title":"Configuration","text":"<p>To ensure strong authentication and accurate access control, creating a Nexus Sonatype service account with the name  ci.user  is crucial. This user serves as a unique identifier, facilitating connection with the EDP ecosystem.</p> <p>To create the Nexus <code>ci.user</code>and define repository parameters follow the steps below: </p> <ol> <li> <p>Open the Nexus UI and navigate to <code>Server administration and configuration</code> -&gt; <code>Security</code> -&gt; <code>User</code>. Click the <code>Create local user</code> button to create a new user:</p> <p> Nexus user settings </p> </li> <li> <p>Type the <code>ci-user</code> username, define an expiration period, and click the <code>Generate</code> button to create the token:</p> <p> Nexus create user </p> </li> <li> <p>EDP relies on a predetermined repository naming convention all repository names are predefined. Navigate to <code>Server administration and configuration</code> -&gt; <code>Repository</code> -&gt; <code>Repositories</code> in Nexus. You can only create a repository with the required language.</p> <p> Nexus repository list </p> JavaJavaScriptDotnetPython <p>a) Click Create a repository by selecting \"maven2(proxy)\" and set the name as \"edp-maven-proxy\". Enter the remote storage URL as \"https://repo1.maven.org/maven2/\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"maven2(hosted)\" and set the name as \"edp-maven-snapshot\". Change the Version policy to \"snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"maven2(hosted)\" and set the name as \"edp-maven-releases\". Change the Version policy to \"release\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"maven2(group)\" and set the name as \"edp-maven-group\". Change the Version policy to \"release\". Add repository to group. Save the configuration.</p> <p>a) Click Create a repository by selecting \"npm(proxy)\" and set the name as \"edp-npm-proxy\". Enter the remote storage URL as \"https://registry.npmjs.org\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"npm(hosted)\" and set the name as \"edp-npm-snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"npm(hosted)\" and set the name as \"edp-npm-releases\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"npm(hosted)\" and set the name as \"edp-npm-hosted\". Save the configuration.</p> <p>e) Click Create a repository by selecting \"npm(group)\" and set the name as \"edp-npm-group\". Add repository to group. Save the configuration.</p> <p>a) Click Create a repository by selecting \"nuget(proxy)\" and set the name as \"edp-dotnet-proxy\". Select Protocol version NuGet V3. Enter the remote storage URL as \"https://api.nuget.org/v3/index.json\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"nuget(hosted)\" and set the name as \"edp-dotnet-snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"nuget(hosted)\" and set the name as \"edp-dotnet-releases\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"nuget(hosted)\" and set the name as \"edp-dotnet-hosted\". Save the configuration.</p> <p>e) Click Create a repository by selecting \"nuget(group)\" and set the name as \"edp-dotnet-group\". Add repository to group. Save the configuration.</p> <p>a) Click Create a repository by selecting \"pypi(proxy)\" and set the name as \"edp-python-proxy\". Enter the remote storage URL as \"https://pypi.org\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"pypi(hosted)\" and set the name as \"edp-python-snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"pypi(hosted)\" and set the name as \"edp-python-releases\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"pypi(group)\" and set the name as \"edp-python-group\". Add repository to group. Save the configuration.</p> </li> <li> <p>Provision secrets using manifest, EDP Portal or with the externalSecrets operator</p> </li> </ol> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; Nexus. Update or fill in the URL, nexus-user-id, nexus-user-password and click the Save button:</p> <p> Nexus update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-nexus\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: nexus\ntype: Opaque\nstringData:\nurl: https://nexus.example.com\nusername: &lt;nexus-user-id&gt;\npassword: &lt;nexus-user-password&gt;\n</code></pre> <pre><code>\"ci-nexus\":\n{\n\"url\": \"https://nexus.example.com\",\n\"username\": \"XXXXXXX\",\n\"password\": \"XXXXXXX\"\n},\n</code></pre> <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; Nexus and see <code>Managed by External Secret</code> message.</p> <p> Nexus managed by external secret operator </p> <p>More detail of External Secrets Operator Integration can found on the following page</p>"},{"location":"operator-guide/nexus-sonatype/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP With Values File</li> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Cluster Add-Ons Overview</li> </ul>"},{"location":"operator-guide/notification-msteams/","title":"Microsoft Teams Notification","text":"<p>This section describes how to set up and add notification status to Tekton pipelines by sending pipeline status to the Microsoft Teams channel.</p>"},{"location":"operator-guide/notification-msteams/#create-incoming-webhook","title":"Create Incoming WebHook","text":"<p>To create a link to Incoming Webhook for the Microsoft Teams channel, follow the steps below:</p> <p>1. Open the channel which will be receiving notifications and click the <code>\u2022\u2022\u2022</code> button from the upper-right corner. Select <code>Connectors</code> in the dropdown menu:      Microsoft Teams menu </p> <p>2. In the search field, type <code>Incoming Webhook</code> and click <code>Configure</code>:      Connectors </p> <p>3. Provide a name and upload an image for the webhook if necessary. Click <code>Create</code>:      Connectors setup </p> <p>4. Copy and save the unique <code>WebHookURL</code> presented in the dialog. Click <code>Done</code>:      WebHookURL </p> <p>5. Create a secret with the  within the edp namespace. <pre><code>  kubectl -n edp create secret generic microsoft-teams-webhook-url \\\n--from-literal=url=&lt;webhookURL&gt;\n</code></pre> <p>6. Add the notification task to the pipeline and add the code below in <code>final-block</code> in the pipeline and save:</p> <pre><code>{{ include \"send-to-microsoft-teams-build\" . | nindent 4 }}\n</code></pre>"},{"location":"operator-guide/notification-msteams/#customize-notification-message","title":"Customize Notification Message","text":"<p>To make notification message informative, relevant text should be added to the message. Here are the steps to implement it:</p> <ol> <li> <p>Create a new pipeline with a unique name or modify your custom pipeline created before.</p> </li> <li> <p>Add the task below in the <code>finally</code> block with a unique name. Edit the <code>params.message</code> value if necessary:</p> </li> </ol> View: Task send-to-microsoft-teams <pre><code>- name: 'microsoft-teams-pipeline-status-notification-failed\nparams:\n- name: webhook-url-secret\nvalue: microsoft-teams-webhook-url\n- name: webhook-url-secret-key\nvalue: url\n- name: message\nvalue: &gt;-\nBuild Failed project: $(params.CODEBASE_NAME)&lt;br&gt; branch: $(params.git-source-revision)&lt;br&gt; pipeline: &lt;a href=$(params.pipelineUrl)&gt;$(context.pipelineRun.name)&lt;/a&gt;&lt;br&gt; commit message: $(params.COMMIT_MESSAGE)\ntaskRef:\nkind: Task\nname: send-to-microsoft-teams\nwhen:\n- input: $(tasks.status)\noperator: in\nvalues:\n- Failed\n- PipelineRunTimeout\n</code></pre> <p>After customization, the following message is supposed to appear in the channel when failing pipelines:</p> <p> Notification example </p>"},{"location":"operator-guide/notification-msteams/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Tekton</li> </ul>"},{"location":"operator-guide/oauth2-proxy/","title":"Protect Endpoints","text":"<p>OAuth2-Proxy is a versatile tool that serves as a reverse proxy, utilizing the OAuth 2.0 protocol with various providers like Google, GitHub, and Keycloak to provide both authentication and authorization. This guide instructs readers on how to protect their applications' endpoints using OAuth2-Proxy. By following these steps, users can strengthen their endpoints' security without modifying their current application code. In the context of EDP, it has integration with the Keycloak OIDC provider, enabling it to link with any component that lacks built-in authentication.</p> <p>Note</p> <p>OAuth2-Proxy is disabled by default when installing EDP.</p>"},{"location":"operator-guide/oauth2-proxy/#prerequisites","title":"Prerequisites","text":"<ul> <li>Keycloak with OIDC authentication is installed.</li> </ul>"},{"location":"operator-guide/oauth2-proxy/#enable-oauth2-proxy","title":"Enable OAuth2-Proxy","text":"<p>Enabling OAuth2-Proxy implies the following general steps:</p> <ol> <li>Update your EDP deployment using command <code>--set 'oauth2_proxy.enabled=true'</code> or the <code>--values</code> file by enabling the oauth2_proxy parameter.</li> <li>Check that OAuth2-Proxy is deployed successfully.</li> <li>Enable authentication for your Ingress by adding <code>auth-signin</code> and <code>auth-url</code> of OAuth2-Proxy to its annotation.</li> </ol> <p>This will deploy and connect OAuth2-Proxy to your application endpoint.</p>"},{"location":"operator-guide/oauth2-proxy/#enable-oauth2-proxy-on-tekton-dashboard","title":"Enable OAuth2-Proxy on Tekton Dashboard","text":"<p>The example below illustrates how to use OAuth2-Proxy in practice when using the Tekton dashboard:</p> KubernetesOpenshift <ol> <li>Run <code>helm upgrade</code> to update edp-install release: <pre><code>helm upgrade --version &lt;version&gt; --set 'oauth2_proxy.enabled=true' edp-install --namespace edp\n</code></pre></li> <li>Check that OAuth2-Proxy is deployed successfully.</li> <li>Edit the Tekton dashboard Ingress annotation by adding <code>auth-signin</code> and <code>auth-url</code> of oauth2-proxy by <code>kubectl</code> command: <pre><code>kubectl annotate ingress &lt;application-ingress-name&gt; nginx.ingress.kubernetes.io/auth-signin='https://&lt;oauth-ingress-host&gt;/oauth2/start?rd=https://$host$request_uri' nginx.ingress.kubernetes.io/auth-url='http://oauth2-proxy.edp.svc.cluster.local:8080/oauth2/auth'\n</code></pre></li> </ol> <ol> <li>Generate a cookie-secret for proxy with the following command: <pre><code>tekton_dashboard_cookie_secret=$(openssl rand -base64 32 | head -c 32)\n</code></pre></li> <li>Create <code>tekton-dashboard-proxy-cookie-secret</code> in the edp namespace: <pre><code>kubectl -n edp create secret generic tekton-dashboard-proxy-cookie-secret \\\n--from-literal=cookie-secret=${tekton_dashboard_cookie_secret}\n</code></pre></li> <li>Run <code>helm upgrade</code> to update edp-install release: <pre><code>helm upgrade --version &lt;version&gt; --set 'edp-tekton.dashboard.openshift_proxy.enabled=true' edp-install --namespace edp\n</code></pre></li> </ol>"},{"location":"operator-guide/oauth2-proxy/#related-articles","title":"Related Articles","text":"<p>Keycloak Installation Keycloak OIDC Installation Tekton Installation</p>"},{"location":"operator-guide/openshift-cluster-settings/","title":"Set Up OpenShift","text":"<p>Make sure the cluster meets the following conditions:</p> <ol> <li> <p>OpenShift cluster is installed with minimum 2 worker nodes with total capacity 8 Cores and 32Gb RAM.</p> </li> <li> <p>Load balancer (if any exists in front of OpenShift router or ingress controller) is configured with session stickiness, disabled HTTP/2 protocol and header size of 64k support.</p> <p>Find below an example of the Config Map for the NGINX Ingress Controller:</p> <pre><code>kind: ConfigMap\napiVersion: v1\nmetadata:\nname: nginx-configuration\nnamespace: ingress-nginx\nlabels:\napp.kubernetes.io/name: ingress-nginx\napp.kubernetes.io/part-of: ingress-nginx\ndata:\nclient-header-buffer-size: 64k\nlarge-client-header-buffers: 4 64k\nuse-http2: \"false\"\n</code></pre> </li> <li> <p>Cluster nodes and pods have access to the cluster via external URLs. For instance, add in AWS the VPC NAT gateway elastic IP to the cluster external load balancers security group).</p> </li> <li> <p>Keycloak instance is installed. To get accurate information on how to install Keycloak, please refer to the Install Keycloak instruction.</p> </li> <li> <p>The installation machine with oc is installed with the cluster-admin access to the OpenShift cluster.</p> </li> <li> <p>Helm 3.10 is installed on the installation machine with the help of the Installing Helm instruction.</p> </li> <li> <p>Storage classes are used with the Retain Reclaim Policy and Delete Reclaim Policy.</p> </li> <li> <p>We recommended using our storage class as default storage class.</p> <p>Info</p> <p>By default, EDP uses the default Storage Class in a cluster. The EDP development team recommends using the following Storage Classes. See an example below.</p> <p>Storage class templates with the Retain and Delete Reclaim Policies:</p> ebs-scgp3gp3-retain <pre><code>apiVersion: storage.k8s.io/v1\nkind: StorageClass\nmetadata:\nname: ebs-sc\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: Immediate\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Delete\nvolumeBindingMode: Immediate\nallowVolumeExpansion: true\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3-retain\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: WaitForFirstConsumer\nallowVolumeExpansion: true\n</code></pre> </li> </ol>"},{"location":"operator-guide/openshift-cluster-settings/#related-articles","title":"Related Articles","text":"<ul> <li>Install Amazon EBS CSI Driver</li> <li>Install Keycloak</li> </ul>"},{"location":"operator-guide/overview-devsecops/","title":"Secure Delivery on the Platform","text":"<p>The EPAM Delivery Platform emphasizes the importance of incorporating security practices into the software development lifecycle through the DevSecOps approach. By integrating a diverse range of open-source and enterprise security tools tailored to specific functionalities, organizations can ensure efficient and secure software development. These tools, combined with fundamental DevSecOps principles such as collaboration, continuous security, and automation, contribute to the identification and remediation of vulnerabilities early in the process, minimizes risks, and fosters a security-first culture across the organization.</p> <p>The EPAM Delivery Platform enabling seamless integration with various security tools and vulnerability management systems, enhancing the security of source code and ensuring compliance.</p>"},{"location":"operator-guide/overview-devsecops/#supported-solutions","title":"Supported Solutions","text":"<p>The below table categorizes various open-source and enterprise security tools based on their specific functionalities. It provides a comprehensive view of the available options for each security aspect. This classification facilitates informed decision-making when selecting and integrating security tools into a development pipeline, ensuring an efficient and robust security stance. EDP supports the integration of both open-source and enterprise security tools, providing a flexible and versatile solution for security automation. See table below for more details.</p> Functionality Open-Source Tools (integrated in Pipelines) Enterprise Tools (available for Integration) Hardcoded Credentials Scanner TruffleHog, GitLeaks, GitSecrets GitGuardian, SpectralOps, Bridgecrew Static Application Security Testing SonarQube, Semgrep CLI Veracode, Checkmarx, Coverity Software Composition Analysis OWASP Dependency-Check, cdxgen, Nancy Black Duck Hub, Mend, Snyk Container Security Trivy, Grype, Clair Aqua Security, Sysdig Secure, Snyk Infrastructure as Code Security Checkov, Tfsec Bridgecrew, Prisma Cloud, Snyk Dynamic Application Security Testing OWASP Zed Attack Proxy Fortify WebInspect, Rapid7 InsightAppSec, Checkmarx Continuous Monitoring and Logging ELK Stack, OpenSearch, Loki Splunk, Datadog Security Audits and Assessments OpenVAS Tenable Nessus, QualysGuard, BurpSuite Professional Vulnerability Management and Reporting DefectDojo, OWASP Dependency-Track - <p>For obtaining and managing report post scanning, deployment of various vulnerability management systems and security tools is required. These include:</p>"},{"location":"operator-guide/overview-devsecops/#defectdojo","title":"DefectDojo","text":"<p>DefectDojo is a comprehensive vulnerability management and security orchestration platform facilitating the handling of uploaded security reports. Examine the prerequisites and fundamental instructions for installing DefectDojo on Kubernetes or OpenShift platforms.</p>"},{"location":"operator-guide/overview-devsecops/#owasp-dependency-track","title":"OWASP Dependency Track","text":"<p>Dependency Track is an intelligent Software Composition Analysis (SCA) platform that provides a comprehensive solution for managing vulnerabilities in third-party and open-source components.</p>"},{"location":"operator-guide/overview-devsecops/#gitleaks","title":"Gitleaks","text":"<p>Gitleaks is a versatile SAST tool used to scan Git repositories for hardcoded secrets, such as passwords and API keys, to prevent potential data leaks and unauthorized access.</p>"},{"location":"operator-guide/overview-devsecops/#trivy","title":"Trivy","text":"<p>Trivy is a simple and comprehensive vulnerability scanner for containers and other artifacts, providing insight into potential security issues across multiple ecosystems.</p>"},{"location":"operator-guide/overview-devsecops/#grype","title":"Grype","text":"<p>Grype is a fast and reliable vulnerability scanner for container images and filesystems, maintaining an up-to-date vulnerability database for efficient and accurate scanning.</p>"},{"location":"operator-guide/overview-devsecops/#tfsec","title":"Tfsec","text":"<p>Tfsec is an effective Infrastructure as Code (IaC) security scanner, tailored specifically for reviewing Terraform templates. It helps identify potential security issues related to misconfigurations and non-compliant practices, enabling developers to address vulnerabilities and ensure secure infrastructure deployment.</p>"},{"location":"operator-guide/overview-devsecops/#checkov","title":"Checkov","text":"<p>Checkov is a robust static code analysis tool designed for IaC security, supporting various IaC frameworks such as Terraform, CloudFormation, and Kubernetes. It assists in detecting and mitigating security and compliance misconfigurations, promoting best practices and adherence to industry standards across the infrastructure.</p>"},{"location":"operator-guide/overview-devsecops/#cdxgen","title":"Cdxgen","text":"<p>Cdxgen is a lightweight and efficient tool for generating Software Bill of Materials (SBOM) using CycloneDX, a standard format for managing component inventory. It helps organizations maintain an up-to-date record of all software components, their versions, and related vulnerabilities, streamlining monitoring and compliance within the software supply chain.</p>"},{"location":"operator-guide/overview-devsecops/#semgrep-cli","title":"Semgrep CLI","text":"<p>Semgrep CLI is a versatile and user-friendly command-line interface for the Semgrep security scanner, enabling developers to perform Static Application Security Testing (SAST) for various programming languages. It focuses on detecting and preventing potential security vulnerabilities, code quality issues, and custom anti-patterns, ensuring secure and efficient code development.</p>"},{"location":"operator-guide/overview-manage-jenkins-pipelines/","title":"Overview","text":"<p>Jenkins job provisioners are responsible for creating and managing pipelines in Jenkins. In other words, provisioners configure all Jenkins pipelines and bring them to the state described in the provisioners code. Two types of provisioners are available in EDP:</p> <ul> <li>CI-provisioner - manages the application folder, and its Code Review, Build and Create Release pipelines.</li> </ul> <ul> <li>CD-provisioner - manages the Deploy pipelines.</li> </ul> <p>The subsections describe the creation/update process of provisioners and their content depending on EDP customization.</p>"},{"location":"operator-guide/overview-sast/","title":"Static Application Security Testing Overview","text":"<p>EPAM Delivery Platform provides the implemented Static Application Security Testing support allowing to work with the Semgrep security scanner and the DefectDojo vulnerability management system to check the source code for known vulnerabilities.</p>"},{"location":"operator-guide/overview-sast/#supported-languages","title":"Supported Languages","text":"<p>EDP SAST supports a number of languages and package managers.</p> Language (Package Managers) Scan Tool Build Tool Java Semgrep Maven, Gradle Go Semgrep Go React Semgrep Npm"},{"location":"operator-guide/overview-sast/#supported-vulnerability-management-system","title":"Supported Vulnerability Management System","text":"<p>To get and then manage a SAST report after scanning, it is necessary to deploy the vulnerability management system, for instance, DefectDojo.</p>"},{"location":"operator-guide/overview-sast/#defectdojo","title":"DefectDojo","text":"<p>DefectDojo is a vulnerability management and security orchestration platform that allows managing the uploaded security reports.</p> <p>Inspect the prerequisites and the main steps for installing DefectDojo on Kubernetes or OpenShift platforms.</p>"},{"location":"operator-guide/overview-sast/#related-articles","title":"Related Articles","text":"<ul> <li>Add Security Scanner</li> <li>Semgrep</li> </ul>"},{"location":"operator-guide/perf-integration/","title":"Perf Server Integration","text":"<p>Integration with Perf Server allows connecting to the PERF Board (Project Performance Board) and monitoring the overall team performance as well as setting up necessary metrics.</p> <p>Note</p> <p>To adjust the PERF Server integration, make sure that PERF Operator is deployed. To get more information about the PERF Operator installation and architecture, please refer to the PERF Operator page.</p> <p>For integration, take the following steps:</p> <ol> <li> <p>Create Secret in the OpenShift/Kubernetes namespace for Perf Server account with the username and password fields:</p> <pre><code>apiVersion: v1\ndata:\npassword: passwordInBase64\nusername: usernameInBase64\nkind: Secret\nmetadata:\nname: epam-perf-user\ntype: kubernetes.io/basic-auth\n</code></pre> </li> <li> <p>In the edp-config config map, enable the perf_integration flag and click Save:</p> <pre><code> perf_integration_enabled: 'true'\n</code></pre> </li> <li> <p>Being in Admin Console, navigate to the Advanced Settings menu to check that the Integrate with Perf Server check box appeared:</p> <p> Advanced settings </p> </li> </ol>"},{"location":"operator-guide/perf-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> </ul>"},{"location":"operator-guide/prerequisites/","title":"EDP Installation Prerequisites Overview","text":"<p>Before installing EDP:</p> <ul> <li>Install and configure Kubernetes or OpenShift cluster.</li> <li>Install EDP components for the selected EDP installation scenario.</li> </ul>"},{"location":"operator-guide/prerequisites/#edp-installation-scenarios","title":"EDP Installation Scenarios","text":"<p>There are two EDP installation scenarios based on the selected CI tool: Tekton (default) or Jenkins.</p> <p>Scenario 1: Tekton CI tool. By default, EDP uses Tekton as a CI tool and EDP Portal as a UI tool.</p> <p>Scenario 2: Jenkins CI tool. To use Jenkins as a CI tool, it is required to install the deprecated Admin Console UI tool. Admin Console is used only as a dependency for Jenkins, and Portal will still be used as a UI tool.</p> <p>Note</p> <p>Starting from version 3.0.0, all the new enhancements and functionalities will be introduced only for Tekton deploy scenario. Jenkins deploy scenario will be supported at the bug fix and security breach level only. We understand that some users may need additional functionality in Jenkins, so if any, please create your request here. To stay up-to-date with all the updates, please check the Release Notes page.</p> <p>Find below the list of the components to be installed for each scenario:</p> Component Tekton CI tool Jenkins CI tool Cluster Tekton Mandatory - NGINX Ingress Controller1 Mandatory Mandatory Keycloak Mandatory Mandatory DefectDojo Mandatory Mandatory Argo CD Mandatory Optional ReportPortal Optional Optional Kiosk Optional Optional External Secrets Optional Optional Harbor Optional Optional <p>Note</p> <p>Alternatively, use Helmfiles to install the EDP components.</p> <p>After setting up the cluster and installing EDP components according to the selected scenario, proceed to the EDP installation.</p>"},{"location":"operator-guide/prerequisites/#related-articles","title":"Related Articles","text":"<ul> <li>Set Up Kubernetes</li> <li>Set Up OpenShift</li> <li>Install EDP</li> </ul> <ol> <li> <p>OpenShift cluster uses Routes to provide access to pods from external resources.\u00a0\u21a9</p> </li> </ol>"},{"location":"operator-guide/report-portal-integration-tekton/","title":"Integration With Tekton","text":"<p>ReportPortal integration with Tekton allows managing all automation results and reports in one place, visualizing metrics and analytics, team collaborating to associate statistics results.</p> <p>For integration, take the following steps:</p> <ol> <li> <p>Log in to the ReportPortal console and navigate to the User Profile menu:</p> <p> ReportPortal profile </p> </li> <li> <p>Copy the Access token and use it as a value while creating a kubernetes secret for the ReportPortal credentials:</p> <pre><code>apiVersion: v1\nkind: Secret\ntype: Opaque\nmetadata:\nname: rp-credentials\nnamespace: edp\nstringData:\nrp_uuid: &lt;access-token&gt;\n</code></pre> </li> <li> <p>In the Configuration examples section of the ReportPortal User Profile menu, copy the following <code>REQUIRED</code> fields: <code>rp.endpoint</code>, <code>rp.launch</code> and <code>rp.project</code>. Insert these fields to the <code>pytest.ini</code> file in root directory of your project:</p> <pre><code>[pytest]\naddopts = -rsxX -l --tb=short --junitxml test-report.xml\nrp_endpoint = &lt;endpoint&gt;\nrp_launch = &lt;launch&gt;\nrp_project = &lt;project&gt;\n</code></pre> </li> <li> <p>In root directory of the project create/update requirements.txt file and fill with following. it's mandatory to install report-portal python library (version may vary):   <pre><code>pytest-reportportal == 5.1.2\n</code></pre></p> </li> <li> <p>Create a custom Tekton task:</p> View: Custom Tekton task <pre><code>apiVersion: tekton.dev/v1beta1\nkind: Task\nmetadata:\nlabels:\napp.kubernetes.io/version: '0.1'\nname: pytest-reportportal\nnamespace: edp\nspec:\ndescription: |-\nThis task can be used to run pytest integrated with report portal.\nparams:\n- default: .\ndescription: The path where package.json of the project is defined.\nname: PATH_CONTEXT\ntype: string\n- name: EXTRA_COMMANDS\ntype: string\n- default: python:3.8-alpine3.16\ndescription: The python image you want to use.\nname: BASE_IMAGE\ntype: string\n- default: rp-credentials\ndescription: name of the secret holding the rp token\nname: rp-secret\ntype: string\nsteps:\n- env:\n- name: HOME\nvalue: $(workspaces.source.path)\n- name: RP_UUID\nvalueFrom:\nsecretKeyRef:\nkey: rp_uuid\nname: $(params.rp-secret)\nimage: $(params.BASE_IMAGE)\nname: pytest\nresources: {}\nscript: &gt;\n#!/usr/bin/env sh\nset -e\nexport PATH=$PATH:$HOME/.local/bin\n$(params.EXTRA_COMMANDS)\n# tests are being run from ./test directory in the project\npytest ./tests --reportportal\nworkingDir: $(workspaces.source.path)/$(params.PATH_CONTEXT)\nworkspaces:\n- name: source\n</code></pre> </li> <li> <p>Add this task ref to your Tekton pipeline after tasks:</p> View: Tekton pipeline <pre><code>- name: pytest\nparams:\n- name: BASE_IMAGE\nvalue: $(params.image)\n- name: EXTRA_COMMANDS\nvalue: |\nset -ex\npip3 install -r requirements.txt\n[ -f run_service.py ] &amp;&amp; python run_service.py &amp;\nrunAfter:\n- compile\ntaskRef:\nkind: Task\nname: pytest-reportportal\nworkspaces:\n- name: source\nworkspace: shared-workspace\n</code></pre> </li> <li> <p>Launch your Tekton pipeline and check that the custom task has been successfully executed:</p> <p> Tekton task successfully executed </p> </li> <li> <p>Test reports will be displayed in the Launches section of the ReportPortal:</p> <p> Test report results </p> </li> </ol>"},{"location":"operator-guide/report-portal-integration-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>ReportPortal Installation</li> <li>Keycloak Integration</li> <li>Pytest Integration With ReportPortal</li> </ul>"},{"location":"operator-guide/reportportal-keycloak/","title":"Keycloak Integration","text":"<p>Follow the steps below to integrate the ReportPortal with Keycloak.</p>"},{"location":"operator-guide/reportportal-keycloak/#prerequisites","title":"Prerequisites","text":"<ul> <li>Installed Keycloak. Please follow the instruction for details.</li> <li>Installed ReportPortal. Please follow the instruction to install it from Helmfile or using the Helm Chart.</li> </ul>"},{"location":"operator-guide/reportportal-keycloak/#keycloak-configuration","title":"Keycloak Configuration","text":"<ol> <li> <p>Navigate to Client Scopes &gt; Create client scope and create a new scope with the SAML protocol type.</p> </li> <li> <p>Navigate to Client Scopes &gt; your_scope_name &gt; Mappers &gt; Configure a new mapper &gt; select the User Attribute mapper type. Add three mappers for the email, first name, and last name by typing <code>lastName</code>, <code>firstName</code>, and <code>email</code> in the User Attribute field:</p> <ul> <li>Name is a display name in Keycloak.</li> <li>User Attribute is a user property for mapping.</li> <li>SAML Attribute Name is an attribute used for requesting information in the ReportPortal configuration.</li> <li>SAML Attribute NameFormat: <code>Basic</code>.</li> <li>Aggregate attribute values: <code>Off</code>.</li> </ul> <p> User mapper sample Scope mappers </p> </li> <li> <p>Navigate to Clients &gt; Create client and fill in the following fields:</p> <ul> <li>Client type: <code>SAML</code>.</li> <li>Client ID: <code>report.portal.sp.id</code>.</li> </ul> <p>Warning</p> <p>The <code>report.portal.sp.id</code> Client ID is a constant value.</p> </li> <li> <p>Navigate to Client &gt; your_client &gt; Settings and add <code>https://&lt;report-portal-url\\&gt;/*</code> to the Valid redirect URIs.</p> </li> <li> <p>Navigate to Client &gt; your_client &gt; Keys and disable Client signature required.</p> <p> Client keys </p> </li> <li> <p>Navigate to Client &gt; your_client &gt; Client scopes and add the scope created on step 3 with the default Assigned type.</p> <p> Client scopes </p> </li> </ol>"},{"location":"operator-guide/reportportal-keycloak/#reportportal-configuration","title":"ReportPortal Configuration","text":"<ol> <li> <p>Log in to the ReportPortal with the admin permissions.</p> </li> <li> <p>Navigate to Client &gt; Administrate &gt; Plugins and select the SAML plugin.</p> <p> Plugins menu </p> </li> <li> <p>To add a new integration, fill in the following fields:</p> <p> Add SAML configuration </p> <ul> <li>Provider name is the display name in the ReportPortal login page.</li> <li>Metadata URL: <code>https://&lt;keycloak_url\\&gt;/auth/realms/&lt;realm\\&gt;/protocol/saml/descriptor</code>.</li> <li>Email is the value from the SAML Attribute Name field in the Keycloak mapper.</li> <li>RP callback URL: <code>https://&lt;report_portal_url\\&gt;/uat</code>.</li> <li>Name attributes mode is the first &amp; last name (type based on your mapper).</li> <li>First name is the value from the SAML Attribute Name field in the Keycloak mapper.</li> <li>Last name is the value from the SAML Attribute Name field in the Keycloak mapper.</li> </ul> </li> <li> <p>Log in to the ReportPortal.</p> <p>Note</p> <p>By default, after the first login, ReportPortal creates the &lt;your_email&gt;_personal project and adds an account with the <code>Project manager</code> role.</p> <p> Report portal login page </p> </li> </ol>"},{"location":"operator-guide/reportportal-keycloak/#related-articles","title":"Related Articles","text":"<ul> <li>ReportPortal Installation</li> <li>Integration With Tekton</li> </ul>"},{"location":"operator-guide/restore-edp-with-velero/","title":"Restore EDP Tenant With Velero","text":"<p>You can use the Velero tool to restore a EDP tenant. Explore the main steps for backup and restoring below.</p> <ol> <li> <p>Delete all related entities in Keycloak: realm and clients from master/openshift realms. Navigate to the entities list in the Keycloak, select the necessary ones, and click the deletion icon on the entity overview page.    If there are customized configs in Keycloak, save them before making backup.</p> <p> Remove keycloak realm </p> </li> <li> <p>To restore EDP, install and configure the Velero tool. Please refer to the Install Velero documentation for details.</p> </li> <li> <p>Remove all locks for operators. Delete all config maps that have \u2039OPERATOR_NAME\u203a-operator-lock names. Then restart all pods with operators, or simply run the following command:</p> <pre><code>     kubectl -n edp delete cm $(kubectl -n edp get cm | grep 'operator-lock' | awk '{print $1}')\n</code></pre> </li> <li> <p>Recreate the admin password and delete the Jenkins pod. Or change the script to update the admin password in Jenkins every time when the pod is updated.</p> </li> </ol>"},{"location":"operator-guide/sast-scaner-semgrep/","title":"Semgrep","text":"<p>Semgrep is an open-source static source code analyzer for finding bugs and enforcing code standards.</p> <p>Semgrep scanner is installed on the EDP Jenkins SAST agent and runs on the <code>sast</code> pipeline stage. For details, please refer to the edp-library-stages repository.</p>"},{"location":"operator-guide/sast-scaner-semgrep/#supported-languages","title":"Supported Languages","text":"<p>Semgrep supports more than 20 languages, see the full list in the official documentation. EDP uses Semgrep to scan Java, JavaScript and Go languages.</p>"},{"location":"operator-guide/sast-scaner-semgrep/#related-articles","title":"Related Articles","text":"<ul> <li>Add Security Scanner</li> </ul>"},{"location":"operator-guide/schedule-pods-restart/","title":"Schedule Pods Restart","text":"<p>In case it is necessary to restart pods, use a CronJob according to the following template:</p> View: template <pre><code>---\nkind: Role\napiVersion: rbac.authorization.k8s.io/v1\nmetadata:\nnamespace: &lt;NAMESPACE&gt;\nname: apps-restart\nrules:\n- apiGroups: [\"apps\"]\nresources:\n- deployments\n- statefulsets\nverbs:\n- 'get'\n- 'list'\n- 'patch'\n---\nkind: RoleBinding\napiVersion: rbac.authorization.k8s.io/v1\nmetadata:\nname: apps-restart\nnamespace: &lt;NAMESPACE&gt;\nsubjects:\n- kind: ServiceAccount\nname: apps-restart-sa\nnamespace: &lt;NAMESPACE&gt;\nroleRef:\nkind: Role\nname: apps-restart\napiGroup: \"\"\n---\napiVersion: v1\nkind: ServiceAccount\nmetadata:\nname: apps-restart-sa\nnamespace: &lt;NAMESPACE&gt;\n---\napiVersion: batch/v1beta1\nkind: CronJob\nmetadata:\nname: apps-rollout-restart\nnamespace: &lt;NAMESPACE&gt;\nspec:\nschedule: \"0 9 * * MON-FRI\"\njobTemplate:\nspec:\ntemplate:\nspec:\nserviceAccountName: apps-restart-sa\ncontainers:\n- name: kubectl-runner\nimage: bitnami/kubectl\ncommand:\n- /bin/sh\n- -c\n- kubectl get -n &lt;NAMESPACE&gt; -o name deployment,statefulset | grep &lt;NAME_PATTERN&gt;| xargs kubectl -n &lt;NAMESPACE&gt; rollout restart\nrestartPolicy: Never\n</code></pre> <p>Modify the Cron expression in the CronJob manifest if needed.</p>"},{"location":"operator-guide/sonarqube/","title":"SonarQube Integration","text":"<p>This documentation guide provides comprehensive instructions for integrating SonarQube with the EPAM Delivery Platform.</p> <p></p> <p>Info</p> <p>In EDP release 3.5, we have changed the deployment strategy for the sonarqube-operator component, now it is not installed by default. The <code>sonarURL</code> parameter management has been transferred from the values.yaml file to Kubernetes secrets.</p>"},{"location":"operator-guide/sonarqube/#prerequisites","title":"Prerequisites","text":"<p>Before proceeding, ensure that you have the following prerequisites:</p> <ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/sonarqube/#installation","title":"Installation","text":"<p>To install SonarQube with pre-defined templates, use the sonar-operator installed via Cluster Add-Ons approach.</p>"},{"location":"operator-guide/sonarqube/#configuration","title":"Configuration","text":"<p>To establish robust authentication and precise access control, generating a SonarQube token is essential. This token is a distinct identifier, enabling effortless integration between SonarQube and EDP. To generate the SonarQube token, proceed with the following steps:</p> <ol> <li> <p>Open the SonarQube UI and navigate to <code>Administration</code> -&gt; <code>Security</code> -&gt; <code>User</code>. Create a new user or select an existing one. Click the <code>Options List</code> icon to create a token:</p> <p> SonarQube user settings </p> </li> <li> <p>Type the <code>ci-user</code> username, define an expiration period, and click the <code>Generate</code> button to create the token:</p> <p> SonarQube create token </p> </li> <li> <p>Click the <code>Copy</code> button to copy the generated <code>&lt;Sonarqube-token&gt;</code>:</p> <p> SonarQube token </p> </li> <li> <p>Provision secrets using Manifest, EDP Portal or with the externalSecrets operator:</p> </li> </ol> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; SonarQube. Update or fill in the URL and Token fields and click the Save button:</p> <p> SonarQube update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-sonarqube\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: sonar\ntype: Opaque\nstringData:\nurl: https://sonarqube.example.com\ntoken: &lt;sonarqube-token&gt;\n</code></pre> <pre><code>\"ci-sonarqube\":\n{\n\"url\": \"https://sonarqube.example.com\",\n\"token\": \"XXXXXXXXXXXX\"\n},\n</code></pre> <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; SonarQube and see the <code>Managed by External Secret</code> message:</p> <p> SonarQube managed by external secret operator </p> <p>More details about External Secrets Operator integration can be found in the External Secrets Operator Integration page.</p>"},{"location":"operator-guide/sonarqube/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP With Values File</li> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Cluster Add-Ons Overview</li> </ul>"},{"location":"operator-guide/ssl-automation-okd/","title":"Use Cert-Manager in OpenShift","text":"<p>The following material covers Let's Encrypt certificate automation with cert-manager using AWS Route53.</p> <p>The cert-manager is a Kubernetes/OpenShift operator that allows to issue and automatically renew SSL certificates. In this tutorial, the steps to secure DNS Name will be demonstrated.</p> <p>Below is an instruction on how to automatically issue and install wildcard certificates on OpenShift Ingress Controller and API Server covering all cluster Routes. To secure separate OpenShift Routes, please refer to the OpenShift Route Support project for <code>cert-manager</code>.</p>"},{"location":"operator-guide/ssl-automation-okd/#prerequisites","title":"Prerequisites","text":"<ul> <li>The cert-manager;</li> <li>OpenShift v4.7 - v4.11;</li> <li>Connection to the OpenShift Cluster;</li> <li>Enabled AWS IRSA;</li> <li>The latest <code>oc</code> utility. The <code>kubectl</code> tool can also be used for most of the commands.</li> </ul>"},{"location":"operator-guide/ssl-automation-okd/#install-cert-manager-operator","title":"Install Cert-Manager Operator","text":"<p>Install the <code>cert-manager</code> operator via OpenShift OperatorHub that uses Operator Lifecycle Manager (OLM):</p> <ol> <li> <p>Go to the OpenShift Admin Console \u2192 OperatorHub, search for the <code>cert-manager</code>, and click Install:</p> <p> Cert-Manager Installation </p> </li> <li> <p>Modify the <code>ClusterServiceVersion</code> OLM resource, by selecting the Update approval \u2192 Manual. If selecting Update approval \u2192 Automatic after the automatic operator update, the parameters in the <code>ClusterServiceVersion</code> will be reset to default.</p> <p>Note</p> <p>Installing an operator with Manual approval causes all operators installed in namespace <code>openshift-operators</code> to function as manual approval strategy. In case the Manual approval is chosen, review the manual installation plan and approve it.</p> <p> Cert-Manager Installation </p> </li> <li> <p>Navigate to Operators \u2192 Installed Operators and check the operator status to be Succeeded:</p> <p> Cert-Manager Installation </p> </li> <li> <p>In case of errors, troubleshoot the Operator issues:</p> <pre><code>oc describe operator cert-manager -n openshift-operators\noc describe sub cert-manager -n openshift-operators\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#create-aws-role-for-route53","title":"Create AWS Role for Route53","text":"<p>The <code>cert-manager</code> should be configured to validate Wildcard certificates using the DNS-based method.</p> <ol> <li> <p>Check the DNS Hosted zone ID in AWS Route53 for your domain.</p> <p> Hosted Zone ID </p> </li> <li> <p>Create Route53 Permissions policy in AWS for <code>cert-manager</code> to be able to create DNS TXT records for the certificate validation. In this example, <code>cert-manager</code> permissions are given for a particular DNS zone only. Replace Hosted zone ID XXXXXXXX in the \"Resource\": \"arn:aws:route53:::hostedzone/XXXXXXXXXXXX\".</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Action\": \"route53:GetChange\",\n\"Resource\": \"arn:aws:route53:::change/*\"\n},\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"route53:ChangeResourceRecordSets\",\n\"route53:ListResourceRecordSets\"\n],\n\"Resource\": \"arn:aws:route53:::hostedzone/XXXXXXXXXXXX\"\n}\n]\n}\n</code></pre> </li> <li> <p>Create an AWS Role with Custom trust policy for the <code>cert-manager</code> service account to use the AWS IRSA feature and then attach the created policy. Replace the following:</p> <ul> <li><code>${aws-account-id}</code> with the AWS account ID of the EKS cluster.</li> <li><code>${aws-region}</code> with the region where the EKS cluster is located.</li> <li><code>${eks-hash}</code> with the hash in the EKS API URL; this will be a random 32 character hex string, for example, 45DABD88EEE3A227AF0FA468BE4EF0B5.</li> <li><code>${namespace}</code> with the namespace where cert-manager is running.</li> <li><code>${service-account-name}</code> with the name of the ServiceAccount object created by cert-manager.</li> <li>By default, it is \"system:serviceaccount:openshift-operators:cert-manager\" if <code>cert-manager</code> is installed via OperatorHub.</li> <li>Attach the created Permission policy for Route53 to the Role.</li> <li> <p>Optionally, add Permissions boundary to the Role.</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Action\": \"sts:AssumeRoleWithWebIdentity\",\n\"Principal\": {\n\"Federated\": \"arn:aws:iam::* ${aws-account-id}:oidc-provider/oidc.eks.${aws-region}.amazonaws.com/id/${eks-hash}\"\n},\n\"Condition\": {\n\"StringEquals\": {\n\"oidc.eks.${aws-region}.amazonaws.com/id/${eks-hash}:sub\": \"system:serviceaccount:${namespace}:${service-account-name}\"\n}\n}\n}\n]\n}\n</code></pre> </li> </ul> </li> <li> <p>Copy the created Role ARN.</p> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#configure-cert-manager-integration-with-aws-route53","title":"Configure Cert-Manager Integration With AWS Route53","text":"<ol> <li> <p>Annotate the <code>ServiceAccount</code> created by <code>cert-manager</code> (required for AWS IRSA), and restart the <code>cert-manager</code> pod.</p> </li> <li> <p>Replace the <code>eks.amazonaws.com/role-arn</code> annotation value with your own Role ARN.</p> <pre><code>oc edit sa cert-manager -n openshift-operators\n</code></pre> <pre><code>apiVersion: v1\nkind: ServiceAccount\nmetadata:\nannotations:\neks.amazonaws.com/role-arn: arn:aws:iam::XXXXXXXXXXXX:role/cert-manager\n</code></pre> </li> <li> <p>Modify the <code>cert-manager</code> <code>Deployment</code> with the correct file system permissions <code>fsGroup: 1001</code>, so that the <code>ServiceAccount</code> token can be read.</p> <p>Note</p> <p>In case the <code>ServiceAccount</code> token cannot be read and the operator is installed using the OperatorHub, add <code>fsGroup: 1001</code> via OpenShift ClusterServiceVersion OLM resource. It should be a <code>cert-manager</code> controller spec. These actions are not required for OpenShift v4.10.</p> <pre><code>oc get csv\noc edit csv cert-manager.${VERSION}\n</code></pre> <pre><code>spec:\ntemplate:\nspec:\nsecurityContext:\nfsGroup: 1001\nserviceAccountName: cert-manager\n</code></pre> <p> Cert-Manager System Permissions </p> <p>Info</p> <p>A mutating admission controller will automatically modify all pods running with the service account:</p> <p> cert-manager controller pod <pre><code>apiVersion: apps/v1\nkind: Pod\n# ...\nspec:\n# ...\nserviceAccountName: cert-manager\nserviceAccount: cert-manager\ncontainers:\n- name: ...\n# ...\nenv:\n- name: AWS_ROLE_ARN\nvalue: &gt;-\narn:aws:iam::XXXXXXXXXXX:role/cert-manager\n- name: AWS_WEB_IDENTITY_TOKEN_FILE\nvalue: /var/run/secrets/eks.amazonaws.com/serviceaccount/token\nvolumeMounts:\n- name: aws-iam-token\nreadOnly: true\nmountPath: /var/run/secrets/eks.amazonaws.com/serviceaccount\nvolumes:\n- name: aws-iam-token\nprojected:\nsources:\n- serviceAccountToken:\naudience: sts.amazonaws.com\nexpirationSeconds: 86400\npath: token\ndefaultMode: 420\n</code></pre> </p> </li> <li> <p>If you have separate public and private DNS zones for the same domain (split-horizon DNS), modify the <code>cert-manager</code> <code>Deployment</code> in order to validate DNS TXT records via public recursive nameservers.</p> <p>Note</p> <p>Otherwise, you will be getting an error during a record validation:</p> <p><pre><code>Waiting for DNS-01 challenge propagation: NS ns-123.awsdns-00.net.:53 returned REFUSED for _acme-challenge.\n</code></pre> To avoid the error, add <code>--dns01-recursive-nameservers-only --dns01-recursive-nameservers=8.8.8.8:53,1.1.1.1:53</code> as ARGs to the <code>cert-manager</code> controller <code>Deployment</code>.</p> <pre><code>oc get csv\noc edit csv cert-manager.${VERSION}\n</code></pre> <pre><code>  labels:\napp: cert-manager\napp.kubernetes.io/component: controller\napp.kubernetes.io/instance: cert-manager\napp.kubernetes.io/name: cert-manager\napp.kubernetes.io/version: v1.9.1\nspec:\ncontainers:\n- args:\n- '--v=2'\n- '--cluster-resource-namespace=$(POD_NAMESPACE)'\n- '--leader-election-namespace=kube-system'\n- '--dns01-recursive-nameservers-only'\n- '--dns01-recursive-nameservers=8.8.8.8:53,1.1.1.1:53'\n</code></pre> <p>Note</p> <p>The <code>Deployment</code> must be modified via OpenShift ClusterServiceVersion OLM resource if the operator was installed using the OperatorHub. The OpenShift <code>ClusterServiceVersion</code> OLM resource includes several Deployments, and the ARGs must be modified only for the <code>cert-manager</code> controller.</p> <ul> <li>Save the resource. After that, OLM will try to reload the resource automatically and save it to the YAML file. If OLM resets the config file, double-check the entered values.</li> </ul> <p> Cert-Manager Nameservers </p> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#configure-clusterissuers","title":"Configure ClusterIssuers","text":"<p><code>ClusterIssuer</code> is available on the whole cluster.</p> <ol> <li> <p>Create the ClusterIssuer resource for Let's Encrypt Staging and Prod environments that signs a Certificate using <code>cert-manager</code>.</p> <p>Note</p> <p>Let's Encrypt has a limit of duplicate certificates in the Prod environment. Therefore, a <code>ClusterIssuer</code> has been created for Let's Encrypt Staging environment. By default, Let's Encrypt Staging certificates will not be trusted in your browser. The certificate validation cannot be tested in the Let's Encrypt Staging environment.</p> <ul> <li>Change <code>user@example.com</code> with your contact email.</li> <li>Replace <code>hostedZoneID</code> XXXXXXXXXXX with the DNS Hosted zone ID in AWS for your domain.</li> <li>Replace the region value <code>${region}</code>.</li> <li>The secret under <code>privateKeySecretRef</code> will be created automatically by the <code>cert-manager</code> operator.</li> </ul> <pre><code>apiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\nname: letsencrypt-staging\nspec:\nacme:\nemail: user@example.com\nserver: https://acme-staging-v02.api.letsencrypt.org/directory\nprivateKeySecretRef:\nname: letsencrypt-staging-issuer-account-key\nsolvers:\n- dns01:\nroute53:\nregion: ${region}\nhostedZoneID: XXXXXXXXXXX\n</code></pre> <pre><code>apiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\nname: letsencrypt-prod\nspec:\nacme:\nemail: user@example.com\nserver: https://acme-v02.api.letsencrypt.org/directory\nprivateKeySecretRef:\nname: letsencrypt-prod-issuer-account-key\nsolvers:\n- dns01:\nroute53:\nregion: ${region}\nhostedZoneID: XXXXXXXXXXX\n</code></pre> <p> Cert-Manager ClusterIssuer </p> </li> <li> <p>Check the <code>ClusterIssuer</code> status:</p> <p> Cert-Manager ClusterIssuer </p> <pre><code>oc describe clusterissuer letsencrypt-prod\noc describe clusterissuer letsencrypt-staging\n</code></pre> </li> <li> <p>If the <code>ClusterIssuer</code> state is not ready, investigate <code>cert-manager</code> controller pod logs:</p> <pre><code>oc get pod -n openshift-operators | grep 'cert-manager'\noc logs -f cert-manager-${replica_set}-${random_string} -n openshift-operators\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#configure-certificates","title":"Configure Certificates","text":"<ol> <li> <p>In two different namespaces, create a Certificate resource for the OpenShift Router (Ingress controller for OpenShift) and for the OpenShift APIServer.</p> <ul> <li>OpenShift Router supports a single wildcard certificate for Ingress/Route resources in different namespaces (so called, default SSL certificate). The Ingress controller expects the certificates in a <code>Secret</code> to be created in the <code>openshift-ingress</code> namespace; the API Server, in the <code>openshift-config</code> namespace. The <code>cert-manager</code> operator will automatically create these secrets from the <code>Certificate</code> resource.</li> <li>Replace <code>${DOMAIN}</code> with your domain name. It can be checked with <code>oc whoami --show-server</code>. Put domain names in quotes.</li> </ul> The certificate for OpenShift Router in the `openshift-ingress` namespace <pre><code>apiVersion: cert-manager.io/v1\nkind: Certificate\nmetadata:\nname: router-certs\nnamespace: openshift-ingress\nlabels:\napp: cert-manager\nspec:\nsecretName: router-certs\nsecretTemplate:\nlabels:\napp: cert-manager\nduration: 2160h # 90d\nrenewBefore: 360h # 15d\nsubject:\norganizations:\n- Org Name\ncommonName: '*.${DOMAIN}'\nprivateKey:\nalgorithm: RSA\nencoding: PKCS1\nsize: 2048\nrotationPolicy: Always\nusages:\n- server auth\n- client auth\ndnsNames:\n- '*.${DOMAIN}'\n- '*.apps.${DOMAIN}'\nissuerRef:\nname: letsencrypt-staging\nkind: ClusterIssuer\n</code></pre> The certificate for OpenShift APIServer in the `openshift-config` namespace <pre><code>apiVersion: cert-manager.io/v1\nkind: Certificate\nmetadata:\nname: api-certs\nnamespace: openshift-config\nlabels:\napp: cert-manager\nspec:\nsecretName: api-certs\nsecretTemplate:\nlabels:\napp: cert-manager\nduration: 2160h # 90d\nrenewBefore: 360h # 15d\nsubject:\norganizations:\n- Org Name\ncommonName: '*.${DOMAIN}'\nprivateKey:\nalgorithm: RSA\nencoding: PKCS1\nsize: 2048\nrotationPolicy: Always\nusages:\n- server auth\n- client auth\ndnsNames:\n- '*.${DOMAIN}'\n- '*.apps.${DOMAIN}'\nissuerRef:\nname: letsencrypt-staging\nkind: ClusterIssuer\n</code></pre> <p>Info</p> <ul> <li> <p><code>cert-manager</code> supports ECDSA key pairs in the <code>Certificate</code> resource. To use it, change RSA <code>privateKey</code> to ECDSA:</p> <pre><code>privateKey:\nalgorithm: ECDSA\nencoding: PKCS1\nsize: 256\nrotationPolicy: Always\n</code></pre> </li> </ul> <ul> <li><code>rotationPolicy: Always</code> is highly recommended since <code>cert-manager</code> does not rotate private keys by default.</li> <li>Full <code>Certificate</code> spec is described in the <code>cert-manager</code> API documentation.</li> </ul> </li> <li> <p>Check that the certificates in the namespaces are ready:</p> <p> Cert-Manager Certificate Status </p> <p> Cert-Manager Certificate Status </p> </li> <li> <p>Check the details of the certificates via CLI:</p> <pre><code>oc describe certificate api-certs -n openshift-config\noc describe certificate router-certs -n openshift-ingress\n</code></pre> </li> <li> <p>Check the cert-manager controller pod logs if the Staging Certificate condition is not ready for more than 7 minutes:</p> <pre><code>oc get pod -n openshift-operators | grep 'cert-manager'\noc logs -f cert-manager-${replica_set}-${random_string} -n openshift-operators\n</code></pre> </li> <li> <p>When the certificate is ready, its private key will be put into the OpenShift <code>Secret</code> in the namespace indicated in the <code>Certificate</code> resource:</p> <pre><code>oc describe secret api-certs -n openshift-config\noc describe secret router-certs -n openshift-ingress\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#modify-openshift-router-and-api-server-custom-resources","title":"Modify OpenShift Router and API Server Custom Resources","text":"<ol> <li> <p>Update the Custom Resource of your Router (Ingress controller). Patch the <code>defaultCertificate</code> object value with <code>{ \"name\": \"router-certs\" }</code>:</p> <pre><code>oc patch ingresscontroller default -n openshift-ingress-operator --type=merge --patch='{\"spec\": { \"defaultCertificate\": { \"name\": \"router-certs\" }}}' --insecure-skip-tls-verify\n</code></pre> <p>Info</p> <p>After updating the <code>IngressController</code> object, the OpenShift Ingress operator redeploys the router.</p> </li> <li> <p>Update the Custom Resource for the OpenShift API Server:</p> <ul> <li> <p>Export the name of <code>APIServer</code>:</p> <pre><code>export OKD_API=$(oc whoami --show-server --insecure-skip-tls-verify | cut -f 2 -d ':' | cut -f 3 -d '/' | sed 's/-api././')\n</code></pre> </li> </ul> <ul> <li> <p>Patch the <code>servingCertificate</code> object value with <code>{ \"name\": \"api-certs\" }</code>:</p> <pre><code>oc patch apiserver cluster --type merge --patch=\"{\\\"spec\\\": {\\\"servingCerts\\\": {\\\"namedCertificates\\\": [ { \\\"names\\\": [  \\\"$OKD_API\\\"  ], \\\"servingCertificate\\\": {\\\"name\\\": \\\"api-certs\\\" }}]}}}\" --insecure-skip-tls-verify\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#move-from-lets-encrypt-staging-environment-to-prod","title":"Move From Let's Encrypt Staging Environment to Prod","text":"<ol> <li> <p>Test the Staging certificate on the OpenShift Admin Console. The <code>--insecure</code> flag is used because Let's Encrypt Staging certificates are not trusted in browsers by default:</p> <pre><code>curl -v --insecure https://console-openshift-console.apps.${DOMAIN}\n</code></pre> </li> <li> <p>Change <code>issuerRef</code> to <code>letsencrypt-prod</code> in both <code>Certificate</code> resources:</p> <pre><code>oc edit certificate api-certs -n openshift-config\noc edit certificate router-certs -n openshift-ingress\n</code></pre> <pre><code>issuerRef:\nname: letsencrypt-prod\nkind: ClusterIssuer\n</code></pre> <p>Note</p> <p>In case the certificate reissue is not triggered after that, try to force the certificate renewal with cmctl:</p> <pre><code>cmctl renew router-certs -n openshift-ingress\ncmctl renew api-certs -n openshift-config\n</code></pre> <p>If this won't work, delete the <code>api-certs</code> and <code>router-certs</code> secrets. It should trigger the Prod certificates issuance:</p> <pre><code>oc delete secret router-certs -n openshift-ingress\noc delete secret api-certs -n openshift-config\n</code></pre> <p>Please note that these actions will lead to logging your account out of the OpenShift Admin Console, since certificates will be deleted. Accept the certificate warning in the browser and log in again after that.</p> </li> <li> <p>Check the status of the Prod certificates:</p> <pre><code>oc describe certificate api-certs -n openshift-config\noc describe certificate router-certs -n openshift-ingress\n</code></pre> <pre><code>cmctl status certificate api-certs -n openshift-config\ncmctl status certificate router-certs -n openshift-ingress\n</code></pre> </li> <li> <p>Check the web console and make sure it has secure connection:</p> <pre><code>curl -v https://console-openshift-console.apps.${DOMAIN}\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#troubleshoot-certificates","title":"Troubleshoot Certificates","text":"<p>Below is an example of the DNS TXT <code>challenge</code> record created by the <code>cert-manager</code> operator:</p> <p> DNS Validation </p> <p>Use <code>nslookup</code> or <code>dig</code> tools to check if the DNS propagation for the TXT record is complete:</p> <pre><code>nslookup -type=txt _acme-challenge.${DOMAIN}\ndig txt _acme-challenge.${DOMAIN}\n</code></pre> <p>Otherwise, use web tools like Google Admin Toolbox:</p> <p> DNS Validation </p> <p>If the correct TXT value is shown (the value corresponds to the current TXT value in the DNS zone), it means that the DNS propagation is complete and Let's Encrypt is able to access the record in order to validate it and issue a trusted certificate.</p> <p>Note</p> <p>If the DNS validation challenge self check fails, <code>cert-manager</code> will retry the self check with a fixed 10-second retry interval. Challenges that do not ever complete the self check will continue retrying until the user intervenes by either retrying the <code>Order</code> (by deleting the <code>Order</code> resource) or amending the associated <code>Certificate</code> resource to resolve any configuration errors.</p> <p>As soon as the domain ownership has been verified, any <code>cert-manager</code> affected validation TXT records in the AWS Route53 DNS zone will be cleaned up.</p> <p>Please find below the issues that may occur and their troubleshooting:</p> <ul> <li>When certificates are not issued for a long time, or a <code>cert-manager</code> resource is not in a Ready state, describing a resource may show the reason for the error.</li> </ul> <ul> <li>Basically, the <code>cert-manager</code> creates the following resources during a <code>Certificate</code> issuance: <code>CertificateRequest</code>, <code>Order</code>, and <code>Challenge</code>. Investigate each of them in case of errors.</li> </ul> <ul> <li>Use the cmctl tool to show the state of a <code>Certificate</code> and its associated resources.</li> </ul> <ul> <li> <p>Check the <code>cert-manager</code> controller pod logs:</p> <pre><code>oc get pod -n openshift-operators | grep 'cert-manager'\noc logs -f cert-manager-${replica_set}-${random_string} -n openshift-operators\n</code></pre> </li> </ul> <ul> <li> <p>Certificate error debugging:   a. Decode certificate chain located in the secrets:</p> <pre><code>oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | while openssl x509 -noout -text; do :; done 2&gt;/dev/null\noc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | while openssl x509 -noout -text; do :; done 2&gt;/dev/null\n</code></pre> <pre><code>cmctl inspect secret router-certs -n openshift-ingress\ncmctl inspect secret api-certs -n openshift-config\n</code></pre> <p>b. Check the SSL RSA private key consistency:</p> <pre><code>oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -check -noout\noc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -check -noout\n</code></pre> <p>c. Match the SSL certificate public key against its RSA private key. Their modulus must be identical:</p> <pre><code>diff &lt;(oc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | openssl x509 -noout -modulus | openssl md5) &lt;(oc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -noout -modulus | openssl md5)\ndiff &lt;(oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | openssl x509 -noout -modulus | openssl md5) &lt;(oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -noout -modulus | openssl md5)\n</code></pre> </li> </ul>"},{"location":"operator-guide/ssl-automation-okd/#remove-obsolete-certificate-authority-data-from-kubeconfig","title":"Remove Obsolete Certificate Authority Data From Kubeconfig","text":"<p>After updating the certificates, the access to the cluster via Lens or CLI will be denied because of the untrusted certificate errors:</p> <pre><code>$ oc whoami\nUnable to connect to the server: x509: certificate signed by unknown authority\n</code></pre> <p>Such behavior appears because the <code>oc</code> tool references an old CA data in the kubeconfig file.</p> <p>Note</p> <p>Examine the Certificate Authority data using the following command:</p> <pre><code>oc config view --minify --raw -o jsonpath='{.clusters[].cluster.certificate-authority-data}' | base64 -d | openssl x509 -text\n</code></pre> <p>This certificate has the <code>CA:TRUE</code> parameter, which means that this is a self-signed root CA certificate.</p> <p>To fix the error, remove the old CA data from your OpenShift kubeconfig file:</p> <pre><code>sed -i \"/certificate-authority-data/d\" $KUBECONFIG\n</code></pre> <p>Since this field will be absent in the kubeconfig file, system root SSL certificate will be used to validate the cluster certificate trust chain. On Ubuntu, Let's Encrypt OpenShift cluster certificates will be validated against <code>Internet Security Research Group</code> root in <code>/etc/ssl/certs/ca-certificates.crt</code>.</p>"},{"location":"operator-guide/ssl-automation-okd/#certificate-renewals","title":"Certificate Renewals","text":"<p>The <code>cert-manager</code> automatically renews the certificates based on the X.509 certificate's duration and the <code>renewBefore</code> value. The minimum value for the <code>spec.duration</code> is 1 hour; for <code>spec.renewBefore</code>, 5 minutes. It is also required that <code>spec.duration</code> &gt; <code>spec.renewBefore</code>.</p> <p>Use the cmctl tool to manually trigger a single instant certificate renewal:</p> <pre><code>cmctl renew router-certs -n openshift-ingress\ncmctl renew api-certs -n openshift-config\n</code></pre> <p>Otherwise, manually renew all certificates in all namespaces with the <code>app=cert-manager</code> label:</p> <pre><code>cmctl renew --all-namespaces -l app=cert-manager\n</code></pre> <p>Run the <code>cmctl renew --help</code> command to get more details.</p>"},{"location":"operator-guide/ssl-automation-okd/#related-articles","title":"Related Articles","text":"<ul> <li>Cert-Manager Official Documentation</li> <li>Installing the Cert-Manager Operator for Red Hat OpenShift</li> <li>Checking Issued Certificate Details</li> </ul>"},{"location":"operator-guide/tekton-monitoring/","title":"Monitoring","text":"<p>This documentation describes how to integrate tekton-pipelines metrics with Prometheus and Grafana monitoring stack.</p>"},{"location":"operator-guide/tekton-monitoring/#prerequisites","title":"Prerequisites","text":"<p>Ensure the following requirements are met first before moving ahead:</p> <ul> <li>Kube prometheus stack is installed;</li> <li>Tekton pipeline is installed.</li> </ul>"},{"location":"operator-guide/tekton-monitoring/#create-and-apply-the-additional-scrape-config","title":"Create and Apply the Additional Scrape Config","text":"<p>To create and apply the additional scrape config, follow the steps below:</p> <ol> <li> <p>Create the kubernetes secret file with the additional scrape config:</p> additional-scrape-configs.yaml file<pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: additional-scrape-configs\nstringData:\n  prometheus-additional-job.yaml: |\n    - job_name: \"tekton-pipelines\"\n      scrape_interval: 30s\n      static_configs:\n      - targets: [\"tekton-pipelines-controller.&lt;tekton-pipelines-namespace&gt;.svc.cluster.local:9090\"]\n</code></pre> </li> <li> <p>Apply the created secret:</p> <pre><code>kubectl apply -f additional-scrape-configs.yaml -n &lt;monitoring-namespace&gt;\n</code></pre> </li> <li> <p>Update the prometheus stack:</p> <pre><code>helm update --install prometheus prometheus-community/kube-prometheus-stack --values values.yaml -n &lt;monitoring-namespace&gt;\n</code></pre> <p>The <code>values.yaml</code> file should have the following contents:</p> values.yaml file<pre><code>prometheus:\nprometheusSpec:\nadditionalScrapeConfigsSecret:\nenabled: true\nname: additional-scrape-configs\nkey: prometheus-additional-job.yaml\n</code></pre> </li> <li> <p>Download the EDP Tekton Pipeline dashboard:</p> <p> Import Grafana dashboard </p> <p>a. Click on the dashboard menu;</p> <p>b. In the dropdown menu, click the <code>+ Import</code> button;</p> <p>c. Select the created <code>edp-tekton-overview_rev1.json</code> file;</p> <p> Import Grafana dashboard: Options </p> <p>d. Type the name of the dashboard;</p> <p>e. Select the folder for the dashboard;</p> <p>f. Type the UID (set of eight numbers or letters and symbols);</p> <p>g. Click the <code>Import</code> button.</p> </li> </ol> <p>As soon as the dashboard procedure is completed, you can track the newcoming metrics in the dashboard menu:</p> <p> Tekton dashboard </p>"},{"location":"operator-guide/tekton-monitoring/#related-articles","title":"Related Articles","text":"<ul> <li>Install Tekton</li> <li>Install EDP</li> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/tekton-overview/","title":"Tekton Overview","text":"<p>EPAM Delivery Platform provides Continuous Integration based on Tekton.</p> <p>Tekton is an open-source Kubernetes native framework for creating CI pipelines, allowing a user to compile, build and test applications.</p> <p>The edp-tekton GitHub repository provides all Tekton implementation logic on the platform. The Helm charts are used to deploy the resources inside the Kubernetes cluster. Tekton logic is decoupled into separate components:</p> <p> Edp-tekton components diagram </p> <p>The diagram above describes the following:</p> <ul> <li><code>Common-library</code> is the Helm chart of Library type which stores the common logic shareable across all Tekton pipelines. This library contains Helm templates that generate common Tekton resources.</li> </ul> <ul> <li><code>Pipelines-library</code> is the Helm chart of the Application type which stores the core logic for the EDP pipelines. Tekton CRs like Pipelines, Tasks, EventListeners, Triggers, TriggerTemplates, and other resources are delivered with this chart.</li> </ul> <ul> <li><code>Custom-pipelines</code> is the Helm chart of the Application type which implements custom logic running specifically for internal EDP development, for example, CI and Release. It also demonstrates the customization flow on the platform.</li> </ul> <ul> <li><code>Tekton-dashboard</code> is a multitenancy-adopted implementation of the upstream Tekton Dashboard. It is configured to share Tekton resources across a single namespace.</li> </ul> <ul> <li><code>EDP Interceptor</code> is the custom Tekton Interceptor which enriches the payload from the VCSs events with EDP data from the Codebase CR specification. These data are used to define the Pipeline logic.</li> </ul> <p>Inspect the schema below that describes the logic behind the Tekton functionality on the platform:</p> <p> Component view for the Tekton on EDP </p> <p>The platform logic consists of the following:</p> <ol> <li> <p>The <code>EventListener</code> exposes a dedicated Pod that runs the sink logic and receives incoming events from the VCSs (Gerrit, GitHub, GitLab) through the Ingress. It contains triggers with filtering and routing rules for incoming requests.</p> </li> <li> <p>Upon the Event Payload arrival, the <code>EventListener</code> runs triggers to process information or validate it via different interceptors.</p> </li> <li> <p>The <code>EDP Interceptor</code> extracts information from the codebases.v2.edp.epam.com CR and injects the received data into top-level 'extensions' field of the Event Payload. The Interceptor consists of running Pod and Service.</p> </li> <li> <p>The <code>Tekton Cel Interceptor</code> does simple transformations of the resulting data and prepares them for the Pipeline parameters substitution.</p> </li> <li> <p>The <code>TriggerTemplate</code> creates a PipelineRun instance with the required parameters extracted from the Event Payload by Interceptors. These parameters are mandatory for Pipelines.</p> </li> <li> <p>The <code>PipelineRun</code> has a mapping to the EDP Tekton Pipelines using a template approach which reduces code duplication. Each Pipeline is designed for a specific VCS (Gerrit, GitLab, GitHub), technology stack (such as Java or Python), and type (code-review, build).</p> </li> <li> <p>A <code>Pipeline</code> consists of separate EDP Tekton or open-source Tasks. They are arranged in a specific order of execution in the Pipeline.</p> </li> <li> <p>Each <code>Task</code> is executed as a Pod on the Kubernetes cluster. Also, Tasks can have a different number of steps that are executed as a Container in Pod.</p> </li> <li> <p>The Kubernetes native approach allows the creation of PipelineRun either with the kubectl tool or using the EDP Portal UI.</p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.10/","title":"Upgrade EDP v2.9 to 2.10","text":"<p>This section provides the details on the EDP upgrade to 2.10.2. Explore the actions and requirements below.</p> <p>Note</p> <p>Kiosk is optional for EDP v.2.9.0 and higher, and is enabled by default. To disable it, add the following parameter to the <code>values.yaml</code> file: <code>global.kioskEnabled: false</code>. Please refer to the Set Up Kiosk documentation for the details.</p> <p>Note</p> <p>In the process of updating the EDP, it is necessary to migrate the database for SonarQube, before performing the update procedure, please carefully read section 4 of this guide.</p> <ol> <li> <p>Before updating EDP to 2.10.2, delete SonarQube plugins by executing the following command in SonarQube pod:</p> <pre><code>rm -r /opt/sonarqube/extensions/plugins/*\n</code></pre> </li> <li> <p>Update Custom Resource Definitions. Run the following command to apply all the necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.10/deploy-templates/crds/v2_v1alpha1_jenkins_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakclient_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmcomponent_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmidentityprovider_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmrole_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmuser_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloak_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.10/deploy-templates/crds/edp_v1alpha1_nexus_crd.yaml\n</code></pre> </li> <li> <p>To upgrade EDP to the v.2.10.2, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.10.2\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.10.2  --dry-run</code></p> </li> <li> <p>Migrate the database for SonarQube according to the official documentation.</p> <p>Note</p> <p>Please be aware of possible tables duplication for speeding up the migration process during the upgrade. Due to the duplication, the database disk usage can be temporarily increased to twice as the normal usage. Therefore, the recommended database disk usage is below 50% before the migration start.</p> <ul> <li> <p>Navigate to the project http://SonarQubeServerURL/setup link and follow the setup instructions:</p> <p> Migrate SonarQube database </p> </li> </ul> <ul> <li>Click the Upgrade button and wait for the end of the migration process.</li> </ul> </li> <li> <p>Remove the resources related to the deprecated Sonar Gerrit Plugin that is deleted in EDP 2.10.2:</p> <ul> <li>Remove Sonar Gerrit Plugin from Jenkins (go to Manage Jenkins -&gt; Manage Plugins -&gt; Installed -&gt; Uninstall Sonar Gerrit Plugin).</li> <li>In Gerrit, clone the All-Projects repository.</li> <li>Edit the project.config file in the All-Projects repository and remove the Sonar-Verified label declaration:<pre><code>[label \"Sonar-Verified\"]\nfunction = MaxWithBlock\nvalue = -1 Issues found\nvalue = 0 No score\nvalue = +1 Verified\ndefaultValue = 0\n</code></pre> </li> </ul> <ul> <li>Also, remove the following permissions for the Sonar-Verified label in the project.config file:<pre><code>label-Sonar-Verified = -1..+1 group Administrators\nlabel-Sonar-Verified = -1..+1 group Project Owners\nlabel-Sonar-Verified = -1..+1 group Service Users\n</code></pre> </li> </ul> <ul> <li>Save the changes, and commit and push the repository to HEAD:refs/meta/config bypassing the Gerrit code review:<pre><code>git push origin HEAD:refs/meta/config\n</code></pre> </li> </ul> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-codenarc-agent:1.0.1\nepamedp/edp-jenkins-dotnet-21-agent:1.0.5\nepamedp/edp-jenkins-dotnet-31-agent:1.0.4\nepamedp/edp-jenkins-go-agent:1.0.6\nepamedp/edp-jenkins-gradle-java8-agent:1.0.3\nepamedp/edp-jenkins-gradle-java11-agent:2.0.3\nepamedp/edp-jenkins-helm-agent:1.0.10\nepamedp/edp-jenkins-maven-java8-agent:1.0.3\nepamedp/edp-jenkins-maven-java11-agent:2.0.4\nepamedp/edp-jenkins-npm-agent:2.0.3\nepamedp/edp-jenkins-opa-agent:1.0.2\nepamedp/edp-jenkins-python-38-agent:2.0.4\nepamedp/edp-jenkins-terraform-agent:2.0.5\n</code></pre> </li> </ul> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Since EDP version v.2.10.x, the create-release.groovy, code-review.groovy, and build.groovy files are deprecated (<code>pipeline script from SCM</code> is replaced with <code>pipeline script</code>, see below).</p> <ul> <li>Pipeline script from SCM:    Pipeline script from scm example </li> </ul> <ul> <li>Pipeline script:     Pipeline script example </li> </ul> <ul> <li>Update the job-provisioner code and restart the codebase-operator pod. Consult the default job-provisioners code section.</li> </ul> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.10/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Set Up Kiosk</li> <li>SonarQube Upgrade Guide</li> </ul>"},{"location":"operator-guide/upgrade-edp-2.11/","title":"Upgrade EDP v2.10 to 2.11","text":"<p>This section provides the details on the EDP upgrade to 2.11. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions. Run the following command to apply all the necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.12/deploy-templates/crds/edp_v1alpha1_cd_stage_deploy_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.11/deploy-templates/crds/v2_v1alpha1_merge_request_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_user_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_cdpipeline_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.11/deploy-templates/crds/v2_v1alpha1_jenkinssharedlibrary_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.11/deploy-templates/crds/v2_v1alpha1_cdstagejenkinsdeployment_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.11/deploy-templates/crds/v1_v1alpha1_keycloakauthflow_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.11/deploy-templates/crds/v1_v1alpha1_keycloakrealmuser_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.12/deploy-templates/crds/edp_v1alpha1_codebaseimagestream_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.12/deploy-templates/crds/edp_v1alpha1_codebase_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_sonar_group_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_permission_template_crd.yaml\n</code></pre> </li> <li> <p>Backup kaniko-template config-map and then remove it. This component will be delivered during upgrade.</p> </li> <li> <p>Set required awsRegion parameter. Pay attention that the nesting of the kanikoRoleArn parameter has been changed to the kaniko.roleArn parameter. Check the parameters in the EDP installation chart. For details, please refer to the values.yaml file. To upgrade EDP to the v.2.11.x, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.11.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.11.x  --dry-run</code></p> </li> <li> <p>Update Sonar Project Key:</p> <p>Note</p> <p>Avoid using special characters when creating projects in SonarQube. Allowed characters are: <code>letters</code>, <code>numbers</code>, <code>-</code>, <code>_</code>, <code>.</code> and <code>:</code>, with at least one non-digit. For details, please refer to the SonarQube documentation. As the result, the project name will be: <code>project-name-release-0.0</code> or <code>project-name-branchName</code>.</p> <p>Such actions are required to be followed with the aim to store the SonarQube statistics from the previous EDP version:</p> <p>Warning</p> <p>Do not run any pipeline with the updated sonar stage on any existing application before the completion of the first step.</p> <p>4.1. Update the project key in SonarQube from old to new format by adding the default branch name.</p> <p>- Navigate to Project Settings -&gt; Update Key:   Update SonarQube project key    - Enter the default branch name and click Update:   Update SonarQube project key </p> <p>4.2. As the result, after the first run, the project name will be changed to a new format containing all previous statistics:</p> <p> SonarQube project history activity </p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>  kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-codenarc-agent:3.0.4\nepamedp/edp-jenkins-dotnet-21-agent:3.0.4\nepamedp/edp-jenkins-dotnet-31-agent:3.0.3\nepamedp/edp-jenkins-go-agent:3.0.5\nepamedp/edp-jenkins-gradle-java11-agent:3.0.2\nepamedp/edp-jenkins-gradle-java8-agent:3.0.2\nepamedp/edp-jenkins-helm-agent:3.0.3\nepamedp/edp-jenkins-maven-java11-agent:3.0.3\nepamedp/edp-jenkins-maven-java8-agent:3.0.3\nepamedp/edp-jenkins-npm-agent:3.0.4\nepamedp/edp-jenkins-opa-agent:3.0.2\nepamedp/edp-jenkins-python-38-agent:3.0.2\nepamedp/edp-jenkins-terraform-agent:3.0.3\n</code></pre> </li> </ul> <ul> <li> <p>Add Jenkins agent by following the template:</p> <p> View: values.yaml <pre><code>kaniko-docker-template: |-\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;kaniko-docker&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;kaniko-docker&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-kaniko-docker-agent:1.0.4&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <ul> <li>Restart the Jenkins pod.</li> </ul> <li> <p>Update the Jenkins plugins with the 'pipeline' name and 'HTTP Request Plugin'.</p> </li> <li> <p>Update Jenkins provisioners according to the Manage Jenkins CI Pipeline Job Provisioner and Manage Jenkins CD Pipeline Job Provisioner documentation.</p> </li> <li> <p>Restart the codebase-operator to recreate the Code-review and Build pipelines for codebases.</p> </li> <li>Run the CD job-provisioners for every CD pipeline to align the CD stages.</li>"},{"location":"operator-guide/upgrade-edp-2.12/","title":"Upgrade EDP v2.11 to 2.12","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to 2.12. Explore the actions and requirements below.</p> <p>Notes</p> <ul> <li>EDP now supports Kubernetes 1.22: Ingress Resources use <code>networking.k8s.io/v1</code>, and Ingress Operators use CustomResourceDefinition <code>apiextensions.k8s.io/v1</code>.</li> <li>EDP Team now delivers its own Gerrit Docker image: epamedp/edp-gerrit. It is based on the openfrontier Gerrit Docker image.</li> </ul> <ol> <li> <p>EDP now uses DefectDojo as a SAST tool. It is mandatory to deploy DefectDojo before updating EDP to v.2.12.x.</p> </li> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-admin-console-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_adminconsoles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_cdpipelines.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_cdstagedeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_cdstagejenkinsdeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-component-operator/release/0.12/deploy-templates/crds/v1.edp.epam.com_edpcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritgroupmembers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritmergerequests.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritprojectaccesses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritprojects.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritreplicationconfigs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_gittags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_imagestreamtags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsagents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationrolemappings.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsfolders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsjobbuildruns.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsjobs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsscripts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsserviceaccounts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinssharedlibraries.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_jiraissuemetadatas.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakauthflows.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakclients.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakclientscopes.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmidentityproviders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmrolebatches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmusers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloaks.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_nexuses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_nexususers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfdatasourcegitlabs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfdatasourcejenkinses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfdatasourcesonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_sonargroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_sonarpermissiontemplates.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_sonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_stages.yaml\n</code></pre> </li> <li> <p>Set the required parameters. For details, please refer to the values.yaml file.</p> <ul> <li>In version v.2.12.x, EDP contains Gerrit <code>v3.6.1</code>. According to the Official Gerrit Upgrade flow, a user must initially upgrade to Gerrit <code>v3.5.2</code>, and then upgrade to <code>v3.6.1</code>. Therefore, define the <code>gerrit-operator.gerrit.version=3.5.2</code> value in the edp-install <code>values.yaml</code> file.</li> </ul> <ul> <li> <p>Two more components are available with the new functionality:</p> <ul> <li><code>edp-argocd-operator</code></li> <li><code>external-secrets</code></li> </ul> </li> </ul> <ul> <li>If there is no need to use these new operators, define <code>false</code> values for them in the existing <code>value.yaml</code> file:<p> View: values.yaml <pre><code>gerrit-operator:\ngerrit:\nversion: \"3.5.2\"\nexternalSecrets:\nenabled: false\nargocd:\nenabled: false\n</code></pre> <li> <p>The <code>edp-jenkins-role</code> is renamed to the <code>jenkins-resources-role</code>. Delete the <code>edp-jenkins-role</code> with the following command:</p> <pre><code>  kubectl delete role edp-jenkins-role -n &lt;edp-namespace&gt;\n</code></pre> <p>The <code>jenkins-resources-role</code> role will be created automatically while EDP upgrade.</p> </li> <li> <p>Recreate the <code>edp-jenkins-resources-permissions</code> RoleBinding according to the following template:</p> <p> View: jenkins-resources-role <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\nname: edp-jenkins-resources-permissions\nnamespace: &lt;edp-namespace&gt;\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: Role\nname: jenkins-resources-role\n</code></pre> <li> <p>To upgrade EDP to the v.2.12.x, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x  --dry-run</code></p> </li> <li> <p>After the update, please remove the <code>gerrit-operator.gerrit.version</code> value. In this case, the default value will be used, and Gerrit will be updated to the <code>v3.6.1</code> version. Run the following command:</p> <pre><code>  helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x  --dry-run</code></p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>  kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images must be the following:<pre><code>epamedp/edp-jenkins-codenarc-agent:3.0.8\nepamedp/edp-jenkins-dotnet-21-agent:3.0.7\nepamedp/edp-jenkins-dotnet-31-agent:3.0.7\nepamedp/edp-jenkins-go-agent:3.0.11\nepamedp/edp-jenkins-gradle-java11-agent:3.0.5\nepamedp/edp-jenkins-gradle-java8-agent:3.0.7\nepamedp/edp-jenkins-helm-agent:3.0.8\nepamedp/edp-jenkins-maven-java11-agent:3.0.6\nepamedp/edp-jenkins-maven-java8-agent:3.0.8\nepamedp/edp-jenkins-npm-agent:3.0.7\nepamedp/edp-jenkins-opa-agent:3.0.5\nepamedp/edp-jenkins-python-38-agent:3.0.5\nepamedp/edp-jenkins-terraform-agent:3.0.6\n</code></pre> </li> </ul> <ul> <li> <p>Add Jenkins agents by following the template:</p> <p> View: jenkins-slaves <pre><code>  sast-template: |\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;sast&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;sast&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-sast-agent:0.1.3&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <ul> <li> <p>If required, update the requests and limits for the following Jenkins agents:</p> <ul> <li><code>edp-jenkins-codenarc-agent</code></li> <li><code>edp-jenkins-go-agent</code></li> <li><code>edp-jenkins-gradle-java11-agent</code></li> <li><code>edp-jenkins-gradle-java8-agent</code></li> <li><code>edp-jenkins-maven-java11-agent</code></li> <li><code>edp-jenkins-maven-java8-agent</code></li> <li><code>edp-jenkins-npm-agent</code></li> <li><code>edp-jenkins-dotnet-21-agent</code></li> <li><code>edp-jenkins-dotnet-31-agent</code></li> </ul> <p>EDP requires to start with the following values:</p> <p> View: jenkins-slaves <pre><code>  &lt;resourceRequestCpu&gt;500m&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;1Gi&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;2&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;5Gi&lt;/resourceLimitMemory&gt;\n</code></pre> <ul> <li>Restart the Jenkins pod.</li> </ul> <li> <p>Update Jenkins provisioners according to the Manage Jenkins CI Pipeline Job Provisioner instruction.</p> </li> <li> <p>Restart the <code>codebase-operator</code>, to recreate the Code Review and Build pipelines for the codebases.</p> </li> <p>Warning</p> <p>In case there are different EDP versions on one cluster, the following error may occur on the <code>init</code> stage of Jenkins Groovy pipeline: <code>java.lang.NumberFormatException: For input string: \"\"</code>. To fix this issue, please run the following command using <code>kubectl</code> v1.24.4+:</p> <pre><code>kubectl patch codebasebranches.v2.edp.epam.com &lt;codebase-branch-name&gt;  -n &lt;edp-namespace&gt;  '--subresource=status' '--type=merge' -p '{\"status\": {\"build\": \"0\"}}'\n</code></pre>"},{"location":"operator-guide/upgrade-edp-2.12/#upgrade-edp-to-2122","title":"Upgrade EDP to 2.12.2","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to 2.12.2. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.12.2/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.12.1/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\n</code></pre> </li> <li> <p>To upgrade EDP to 2.12.2, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.2\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.2  --dry-run</code></p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.8/","title":"Upgrade EDP v2.7 to 2.8","text":"<p>This section provides the details on the EDP upgrade to 2.8.4. Explore the actions and requirements below.</p> <p>Note</p> <p>Kiosk is implemented and mandatory for EDP v.2.8.4 and is optional for EDP v.2.9.0 and higher.</p> <p>To upgrade EDP to 2.8.4, take the following steps:</p> <ol> <li> <p>Deploy and configure Kiosk (create a Service Account, Account, and ClusterRoleBinging) according to the Set Up Kiosk documentation.</p> <ul> <li>Update the spec field in the Kiosk space:<pre><code>apiVersion: tenancy.kiosk.sh/v1alpha1\nkind: Space\nmetadata:\nname: &lt;edp-project&gt;\nspec:\naccount: &lt;edp-project&gt;-admin\n</code></pre> </li> </ul> <ul> <li> <p>Create RoleBinding (required for namespaces created before using Kiosk):</p> <p>Note</p> <p>In the uid field under the ownerReferences in the Kubernetes manifest, indicate the Account Custom Resource ID from accounts.config.kiosk.sh <code>kubectl get account &lt;edp-project&gt;-admin -o=custom-columns=NAME:.metadata.uid --no-headers=true</code></p> <p> View: rolebinding-kiosk.yaml <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\ngenerateName: &lt;edp-project&gt;-admin-\nnamespace: &lt;edp-project&gt;\nownerReferences:\n- apiVersion: config.kiosk.sh/v1alpha1\nblockOwnerDeletion: true\ncontroller: true\nkind: Account\nname: &lt;edp-project&gt;-admin\nuid: ''\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: ClusterRole\nname: kiosk-space-admin\nsubjects:\n- kind: ServiceAccount\nname: &lt;edp-project&gt;\nnamespace: security\n</code></pre> <pre><code>kubectl create -f rolebinding-kiosk.yaml\n</code></pre> <li> <p>With Amazon Elastic Container Registry to store the images, there are two options:</p> <ul> <li>Enable IRSA and create AWS IAM Role for Kaniko image builder. Please refer to the IAM Roles for Kaniko Service Accounts section for the details.</li> <li>The Amazon Elastic Container Registry Roles can be stored in an instance profile.</li> </ul> </li> <li> <p>Update Custom Resource Definitions by applying all the necessary CRD to the cluster with the command below:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_cdpipeline_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_codebase_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_cd_stage_deploy_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.8/deploy-templates/crds/v2_v1alpha1_jenkinsjobbuildrun_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.8/deploy-templates/crds/v2_v1alpha1_cdstagejenkinsdeployment_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.8/deploy-templates/crds/v2_v1alpha1_jenkinsjob_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_nexus_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.8/deploy-templates/crds/v1_v1alpha1_keycloakauthflow_crd.yaml\n</code></pre> </li> <li> <p>With Amazon Elastic Container Registry to store and Kaniko to build the images, add the kanikoRoleArn parameter to the values before starting the update process. This parameter is indicated in AWS Roles once IRSA is enabled and AWS IAM Role is created for Kaniko. The value should look as follows:</p> <pre><code>kanikoRoleArn: arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\n</code></pre> </li> <li> <p>To upgrade EDP to the v.2.8.4, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.8.4\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.8.4  --dry-run</code></p> </li> <li> <p>Remove the following Kubernetes resources left from the previous EDP installation (it is optional):</p> <pre><code>kubectl delete cm luminatesec-conf -n &lt;edp-namespace&gt;\nkubectl delete sa edp edp-perf-operator -n &lt;edp-namespace&gt;\nkubectl delete deployment perf-operator -n &lt;edp-namespace&gt;\nkubectl delete clusterrole edp-&lt;edp-namespace&gt; edp-perf-operator-&lt;edp-namespace&gt;\nkubectl delete clusterrolebinding edp-&lt;edp-namespace&gt; edp-perf-operator-&lt;edp-namespace&gt;\nkubectl delete rolebinding edp-&lt;edp-namespace&gt; edp-perf-operator-&lt;edp-namespace&gt;-admin -n &lt;edp-namespace&gt;\nkubectl delete perfserver epam-perf -n &lt;edp-namespace&gt;\nkubectl delete services.v2.edp.epam.com postgres rabbit-mq -n &lt;edp-namespace&gt;\n</code></pre> </li> <li> <p>Update the CI and CD Jenkins job provisioners:</p> <p>Note</p> <p>Please refer to the Manage Jenkins CI Pipeline Job Provisioner section for the details.</p> View: Default CI provisioner template for EDP 2.8.4 <pre><code>/* Copyright 2021 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\nimport hudson.model.*\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef buildTool = \"${BUILD_TOOL}\"\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},' +\n'{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"gerrit-checkout\"},{\"name\": \"get-version\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${createJIMStage}\" + ']'\nstages['Code-review-default'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},[{\"name\": \"sonar\"}],{\"name\": \"build\"},{\"name\": \"build-image-kaniko\"},' +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = stages['Build-application-maven']\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},[{\"name\": \"sonar\"}],{\"name\": \"build-image-kaniko\"},' +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build\"},{\"name\": \"build-image-kaniko\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build-image-kaniko\"},{\"name\": \"push\"}' + \"${createJIMStage}\" +\n',{\"name\": \"git-tag\"}]'\n\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef defaultBuild = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef repositoryPath = \"${REPOSITORY_PATH}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\nfolder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"create-release.groovy\",\nrepositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, defaultBranch)\n\nif (buildTool.toString().equalsIgnoreCase('none')) {\nreturn true\n}\n\nif (BRANCH) {\ndef branch = \"${BRANCH}\"\ndef formattedBranch = \"${branch.toUpperCase().replaceAll(/\\\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef crKey = getStageKeyName(buildTool)\ncreateCiPipeline(\"Code-review-${codebaseName}\", codebaseName, stages[crKey], \"code-review.groovy\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name})\njobExists = true\n\ncreateCiPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultBuild), \"build.groovy\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\nif(!jobExists)\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n\ndef createCiPipeline(pipelineName, codebaseName, codebaseStages, pipelineScript, repository, credId, watchBranch, gitServerCrName, gitServerCrVersion) {\npipelineJob(\"${codebaseName}/${watchBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ntriggers {\ngerrit {\nevents {\nif (pipelineName.contains(\"Build\"))\nchangeMerged()\nelse\npatchsetCreated()\n}\nproject(\"plain:${codebaseName}\", [\"plain:${watchBranch}\"])\n}\n}\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(repository)\ncredentials(credId)\n}\nbranches(\"${watchBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nstringParam(\"BRANCH\", \"${watchBranch}\", \"Branch to build artifact from\")\n}\n}\n}\n}\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineScript, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(repository)\ncredentials(credId)\n}\nbranches(\"${defaultBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, HEAD of master will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n}\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n</code></pre> <p>Note</p> <p>Please refer to the Manage Jenkins CD Pipeline Job Provisioner page for the details.</p> View: Default CD provisioner template for EDP 2.8.4 <pre><code>/* Copyright 2021 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\n\ndef pipelineName = \"${PIPELINE_NAME}-cd-pipeline\"\ndef stageName = \"${STAGE_NAME}\"\ndef qgStages = \"${QG_STAGES}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID}\"\ndef sourceType = \"${SOURCE_TYPE}\"\ndef libraryURL = \"${LIBRARY_URL}\"\ndef libraryBranch = \"${LIBRARY_BRANCH}\"\ndef autodeploy = \"${AUTODEPLOY}\"\ndef scriptPath = \"Jenkinsfile\"\ndef containerDeploymentType = \"container\"\ndef deploymentType = \"${DEPLOYMENT_TYPE}\"\n\ndef stages = buildStages(deploymentType, containerDeploymentType, qgStages)\n\ndef codebaseFolder = jenkins.getItem(pipelineName)\nif (codebaseFolder == null) {\nfolder(pipelineName)\n}\n\nif (deploymentType == containerDeploymentType) {\ncreateContainerizedCdPipeline(pipelineName, stageName, stages, scriptPath, sourceType,\nlibraryURL, libraryBranch, gitCredentialsId, gitServerCrVersion,\nautodeploy)\n} else {\ncreateCustomCdPipeline(pipelineName, stageName)\n}\n\ndef buildStages(deploymentType, containerDeploymentType, qgStages) {\nreturn deploymentType == containerDeploymentType\n? '[{\"name\":\"init\",\"step_name\":\"init\"},{\"name\":\"deploy\",\"step_name\":\"deploy\"},' + qgStages + ',{\"name\":\"promote-images-ecr\",\"step_name\":\"promote-images\"}]'\n: ''\n}\n\ndef createContainerizedCdPipeline(pipelineName, stageName, stages, pipelineScript, sourceType, libraryURL, libraryBranch, libraryCredId, gitServerCrVersion, autodeploy) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nif (sourceType == \"library\") {\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(libraryURL)\ncredentials(libraryCredId)\n}\nbranches(\"${libraryBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\n}\n}\n} else {\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\nDeploy()\")\nsandbox(true)\n}\n}\n}\nproperties {\ndisableConcurrentBuilds()\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${stages}\", \"Consequence of stages in JSON format to be run during execution\")\n\nif (autodeploy?.trim() &amp;&amp; autodeploy.toBoolean()) {\nstringParam(\"AUTODEPLOY\", \"${autodeploy}\", \"Is autodeploy enabled?\")\nstringParam(\"CODEBASE_VERSION\", null, \"Codebase versions to deploy.\")\n}\n}\n}\n}\n\ndef createCustomCdPipeline(pipelineName, stageName) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nproperties {\ndisableConcurrentBuilds()\n}\n}\n}\n</code></pre> <ul> <li>It is also necessary to add the string parameter DEPLOYMENT_TYPE to the CD provisioner:<ul> <li>Go to job-provisions - &gt; cd -&gt; default -&gt; configure;</li> <li>Add Parameter - &gt; String parameter;</li> <li>Name -&gt; DEPLOYMENT_TYPE</li> </ul> </li> </ul> </li> <li> <p>Update Jenkins pipelines and stages to the new release tag:</p> <ul> <li>In Jenkins, go to Manage Jenkins -&gt; Configure system -&gt; Find the Global Pipeline Libraries menu.</li> <li>Change the Default version for edp-library-stages from build/2.8.0-RC.6 to build/2.9.0-RC.5</li> <li>Change the Default version for edp-library-pipelines from build/2.8.0-RC.4 to build/2.9.0-RC.3</li> </ul> </li> <li> <p>Update the edp-admin-console Custom Resource in the KeycloakClient Custom Resource Definition:</p> View: keycloakclient.yaml <pre><code>kind: KeycloakClient\napiVersion: v1.edp.epam.com/v1alpha1\nmetadata:\nname: edp-admin-console\nnamespace: &lt;edp-namespace&gt;\nspec:\nadvancedProtocolMappers: false\nattributes: null\naudRequired: true\nclientId: admin-console-client\ndirectAccess: true\npublic: false\nsecret: admin-console-client\nserviceAccount:\nenabled: true\nrealmRoles:\n- developer\ntargetRealm: &lt;keycloak-edp-realm&gt;\nwebUrl: &gt;-\nhttps://edp-admin-console-example.com\n</code></pre> <pre><code>kubectl apply -f keycloakclient.yaml\n</code></pre> </li> <li> <p>Remove the admin-console-client client ID in the edp-namespace-main realm in Keycloak, restart the keycloak-operator pod and check that the new KeycloakClient is created with the confidential access type.</p> <p>Note</p> <p>If \"Internal error\" occurs, regenerate the admin-console-client secret in the Credentials tab in Keycloak and update the admin-console-client secret key \"clientSecret\" and \"password\".</p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-dotnet-21-agent:1.0.2\nepamedp/edp-jenkins-dotnet-31-agent:1.0.2\nepamedp/edp-jenkins-go-agent:1.0.3\nepamedp/edp-jenkins-gradle-java11-agent:2.0.2\nepamedp/edp-jenkins-gradle-java8-agent:1.0.2\nepamedp/edp-jenkins-helm-agent:1.0.6\nepamedp/edp-jenkins-maven-java11-agent:2.0.3\nepamedp/edp-jenkins-maven-java8-agent:1.0.2\nepamedp/edp-jenkins-npm-agent:2.0.2\nepamedp/edp-jenkins-python-38-agent:2.0.3\nepamedp/edp-jenkins-terraform-agent:2.0.4\n</code></pre> </li> </ul> <ul> <li>Add new Jenkins agents under the data field:</li> </ul> View <pre><code>data:\ncodenarc-template: |-\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;codenarc&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;codenarc&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-codenarc-agent:1.0.0&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\nopa-template: |-\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;opa&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;opa&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-opa-agent:1.0.1&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Update compatible plugins in Jenkins and install additional plugins:</p> <ul> <li>Go to Manage Jenkins -&gt; Manage Plugins -&gt; Select Compatible -&gt; Click Download now and install after restart</li> <li>Install the following additional plugins (click the Available plugins tab in Jenkins):<ul> <li>Groovy Postbuild</li> <li>CloudBees AWS Credentials</li> <li>Badge</li> <li>Timestamper</li> </ul> </li> </ul> </li> <li> <p>Add the annotation <code>deploy.edp.epam.com/previous-stage-name: ''</code> (it should be empty if the CD pipeline contains one stage) to each Custom Resource in the Custom Resource Definition Stage, for example:</p> <ul> <li>List all Custom Resources in Stage: <code>kubectl get stages.v2.edp.epam.com -n &lt;edp-namespace&gt;</code></li> </ul> <ul> <li>Edit resources: <code>kubectl edit stages.v2.edp.epam.com &lt;cd-stage-name&gt; -n &lt;edp-namespace&gt;</code><pre><code>apiVersion: v2.edp.epam.com/v1alpha1\nkind: Stage\nmetadata:\nannotations:\ndeploy.edp.epam.com/previous-stage-name: ''\n</code></pre> </li> </ul> <p>Note</p> <p>If a pipeline contains several stages, add a previous stage name indicated in the EDP Admin Console to the annotation, for example: <code>deploy.edp.epam.com/previous-stage-name: 'dev'</code>.</p> </li> <li> <p>Execute script to align CDPipeline resources to the new API (jq command-line JSON processor is required):</p> <pre><code>pipelines=$( kubectl get cdpipelines -n &lt;edp-namespace&gt; -ojson | jq -c '.items[]' )\nfor p in $pipelines; do\necho \"$p\" | \\\n    jq '. | .spec.inputDockerStreams = .spec.input_docker_streams | del(.spec.input_docker_streams) | .spec += { \"deploymentType\": \"container\" } ' | \\\n    kubectl apply -f -\ndone\n</code></pre> </li> <li> <p>Update the database in the edp-db pod in the edp-namespace:</p> <ul> <li>Log in to the pod:<pre><code>kubectl exec -i -t -n &lt;edp-namespace&gt; edp-db-&lt;pod&gt; -c edp-db \"--\" sh -c \"(bash || ash || sh)\"\n</code></pre> </li> </ul> <ul> <li>Log in to the Postgress DB (where \"admin\" is the user the secret was created for):<pre><code>psql edp-db &lt;admin&gt;;\nSET search_path to '&lt;edp-namespace&gt;';\nUPDATE cd_pipeline SET deployment_type = 'container';\n</code></pre> </li> </ul> </li> <li> <p>Add <code>\"AUTODEPLOY\":\"true/false\",\"DEPLOYMENT_TYPE\":\"container\"</code> to every Custom Resource in <code>jenkinsjobs.v2.edp.epam.com</code>:</p> <ul> <li>Edit Kubernetes resources:<pre><code>kubectl get jenkinsjobs.v2.edp.epam.com -n &lt;edp-namespace&gt;\n\nkubectl edit jenkinsjobs.v2.edp.epam.com &lt;cd-pipeline-name&gt; -n &lt;edp-namespace&gt;\n</code></pre> </li> </ul> <ul> <li>Alternatively, use this script to update all the necessary jenkinsjobs Custom Resources:<pre><code>edp_namespace=&lt;epd_namespace&gt;\nfor stages in $(kubectl get jenkinsjobs -o=name -n $edp_namespace); do kubectl get $stages -n $edp_namespace -o yaml | grep -q \"container\" &amp;&amp; echo -e \"\\n$stages is already updated\" || kubectl get $stages -n $edp_namespace -o yaml | sed 's/\"GIT_SERVER_CR_VERSION\"/\"AUTODEPLOY\":\"false\",\"DEPLOYMENT_TYPE\":\"container\",\"GIT_SERVER_CR_VERSION\"/g' | kubectl apply -f -; done\n</code></pre> </li> </ul> <ul> <li>Make sure the edited resource looks as follows:<pre><code>job:\nconfig: '{\"AUTODEPLOY\":\"false\",\"DEPLOYMENT_TYPE\":\"container\",\"GIT_SERVER_CR_VERSION\":\"v2\",\"PIPELINE_NAME\":\"your-pipeline-name\",\"QG_STAGES\":\"{\\\"name\\\":\\\"manual\\\",\\\"step_name\\\":\\\"your-step-name\\\"}\",\"SOURCE_TYPE\":\"default\",\"STAGE_NAME\":\"your-stage-name\"}'\nname: job-provisions/job/cd/job/default\n</code></pre> </li> </ul> <ul> <li>Restart the Jenkins operator pod and wait until the CD job provisioner in Jenkins creates the updated pipelines.</li> </ul> </li>"},{"location":"operator-guide/upgrade-edp-2.8/#possible-issues","title":"Possible Issues","text":"<ol> <li> <p>SonarQube fails during the CI pipeline run. The previous builds of SonarQube used the latest version of the OpenID Connect Authentication for SonarQube plugin. Version 2.1.0 of this plugin may have issues with the connection, so it is necessary to downgrade it in order to get rid of errors in the pipeline. Take the following steps:</p> <ul> <li>Log in to the Sonar pod:<pre><code>kubectl exec -i -t -n &lt;edp-namespace&gt; sonar-&lt;pod&gt; -c sonar \"--\" sh -c \"(bash || ash || sh)\"\n</code></pre> </li> </ul> <ul> <li>Run the command in the Sonar container:<pre><code>rm extensions/plugins/sonar-auth-oidc-plugin*\n</code></pre> </li> </ul> <ul> <li>Install the OpenID Connect Authentication for SonarQube plugin v2.0.0:<pre><code>curl -L  https://github.com/vaulttec/sonar-auth-oidc/releases/download/v2.0.0/sonar-auth-oidc-plugin-2.0.0.jar --output extensions/plugins/sonar-auth-oidc-plugin-2.0.0.jar\n</code></pre> </li> </ul> <ul> <li>Restart the SonarQube pod;</li> </ul> </li> <li> <p>The Helm lint checker in EDP 2.8.4 has some additional rules. There can be issues with it during the Code Review pipeline in Jenkins for applications that were transferred from previous EDP versions to EDP 2.8.4. To fix this, add the following annotation to the <code>Chart.yaml</code> file:</p> <ul> <li>Go to the Git repository -&gt; Choose the application -&gt; Edit the <code>deploy-templates/Chart.yaml</code> file.</li> <li>It is necessary to add the following lines to the bottom of the <code>Chart.yaml</code> file:<pre><code>home: https://github.com/your-repo.git\nsources:\n- https://github.com/your-repo.git\nmaintainers:\n- name: DEV Team\n</code></pre> </li> </ul> <ul> <li>Add a new line character at the end of the last line. Please be aware it is important.</li> </ul> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.8/#related-articles","title":"Related Articles","text":"<ul> <li>Set Up Kiosk</li> <li>IAM Roles for Kaniko Service Accounts</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"operator-guide/upgrade-edp-2.9/","title":"Upgrade EDP v2.8 to 2.9","text":"<p>This section provides the details on the EDP upgrade to 2.9.0. Explore the actions and requirements below.</p> <p>Note</p> <p>Kiosk is optional for EDP v.2.9.0 and higher, and enabled by default. To disable it, add the following parameter to the <code>values.yaml</code> file: <code>kioskEnabled: false</code>. Please refer to the Set Up Kiosk documentation for the details.</p> <ol> <li> <p>With Amazon Elastic Container Registry to store the images, there are two options:</p> <ul> <li>Enable IRSA and create AWS IAM Role for Kaniko image builder. Please refer to the IAM Roles for Kaniko Service Accounts section for the details.</li> <li>The Amazon Elastic Container Registry Roles can be stored in an instance profile.</li> </ul> </li> <li> <p>Before updating EDP to 2.9.0, update the <code>gerrit-is-credentials</code> secret by adding the new <code>clientSecret</code> key with the value from <code>gerrit-is-credentials.client_secret</code>:</p> <pre><code>kubectl edit secret gerrit-is-credentials -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>Make sure it looks as follows (replace with the necessary key value):<pre><code>data:\nclient_secret: example\nclientSecret: example\n</code></pre> </li> </ul> </li> <li> <p>Update Custom Resource Definitions. This command will apply all the necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritgroupmember_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritgroup_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritprojectaccess_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritproject_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkins_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkinsagent_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkinsauthorizationrolemapping_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkinsauthorizationrole_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.9/deploy-templates/crds/v1_v1alpha1_keycloakclientscope_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.9/deploy-templates/crds/v1_v1alpha1_keycloakrealmuser_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.9/deploy-templates/crds/edp_v1alpha1_nexus_crd.yaml\n</code></pre> </li> <li> <p>With Amazon Elastic Container Registry to store and Kaniko to build the images, add the kanikoRoleArn parameter to the values before starting the update process. This parameter is indicated in AWS Roles once IRSA is enabled and AWS IAM Role is created for Kaniko.The value should look as follows:</p> <pre><code>kanikoRoleArn: arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\n</code></pre> </li> <li> <p>To upgrade EDP to the v.2.9.0, run the following command:</p> <pre><code>helm upgrade --install edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.9.0\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade --install edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.9.0  --dry-run</code></p> </li> <li> <p>Remove the following Kubernetes resources left from the previous EDP installation (it is optional):</p> <pre><code>kubectl delete rolebinding edp-cd-pipeline-operator-&lt;edp-namespace&gt;-admin -n &lt;edp-namespace&gt;\n</code></pre> </li> <li> <p>After EDP update, please restart the 'sonar-operator' pod to address the proper Sonar plugin versioning. After 'sonar-operator' is restarted, check the list of installed plugins in the corresponding SonarQube menu.</p> </li> <li> <p>Update Jenkins pipelines and stages to the new release tag:</p> <ul> <li>Restart the Jenkins pod</li> <li>In Jenkins, go to Manage Jenkins -&gt; Configure system -&gt; Find the Global Pipeline Libraries menu</li> <li>Make sure that the Default version for edp-library-stages is build/2.10.0-RC.1</li> <li>Make sure that the Default version for edp-library-pipelines is build/2.10.0-RC.1</li> </ul> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-codenarc-agent:1.0.1\nepamedp/edp-jenkins-dotnet-21-agent:1.0.3\nepamedp/edp-jenkins-dotnet-31-agent:1.0.3\nepamedp/edp-jenkins-go-agent:1.0.4\nepamedp/edp-jenkins-gradle-java8-agent:1.0.3\nepamedp/edp-jenkins-gradle-java11-agent:2.0.3\nepamedp/edp-jenkins-helm-agent:1.0.7\nepamedp/edp-jenkins-maven-java8-agent:1.0.3\nepamedp/edp-jenkins-maven-java11-agent:2.0.4\nepamedp/edp-jenkins-npm-agent:2.0.3\nepamedp/edp-jenkins-opa-agent:1.0.2\nepamedp/edp-jenkins-python-38-agent:2.0.4\nepamedp/edp-jenkins-terraform-agent:2.0.5\n</code></pre> </li> </ul> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Update the compatible plugins in Jenkins:</p> <ul> <li>Go to Manage Jenkins -&gt; Manage Plugins -&gt; Select Compatible -&gt; Click Download now and install after restart</li> </ul> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.9/#related-articles","title":"Related Articles","text":"<ul> <li>Set Up Kiosk</li> <li>IAM Roles for Kaniko Service Accounts</li> </ul>"},{"location":"operator-guide/upgrade-edp-3.0/","title":"Upgrade EDP v2.12 to 3.0","text":"<p>Important</p> <ul> <li>Before starting the upgrade procedure, please make the necessary backups.</li> <li>Kiosk integration is disabled by default. With EDP below v.3.0.x, define the <code>global.kioskEnabled</code> parameter in the values.yaml file. For details, please refer to the Set Up Kiosk page.</li> <li>The <code>gerrit-ssh-port</code> parameter is moved from the <code>gerrit-operator.gerrit.sshport</code> to <code>global.gerritSSHPort</code> values.yaml file.</li> <li>In edp-gerrit-operator, the <code>gitServer.user</code> value is changed from the <code>jenkins</code> to <code>edp-ci</code>values.yaml file.</li> </ul> <p>This section provides the details on upgrading EDP to 3.0. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/d9a4d15244c527ef6d1d029af27574282a281b98/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_cdstagedeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_gittags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_imagestreamtags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_jiraissuemetadatas.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakauthflows.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakclients.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakclientscopes.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmidentityproviders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmrolebatches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmusers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloaks.yaml\n</code></pre> </li> <li> <p>Set the required parameters. For more details, please refer to the values.yaml file.</p> View: values.yaml <pre><code>edp-tekton:\nenabled: false\nadmin-console-operator:\nenabled: true\njenkins-operator:\nenabled: true\n</code></pre> </li> <li> <p>Add proper Helm annotations and labels as indicated below. This step is necessary starting from the release v.3.0.x as custom resources are managed by Helm and removed from the Keycloak Controller logic.       <pre><code>  kubectl label EDPComponent main-keycloak app.kubernetes.io/managed-by=Helm -n &lt;edp-namespace&gt;\n  kubectl annotate EDPComponent main-keycloak meta.helm.sh/release-name=&lt;edp-release-name&gt; -n &lt;edp-namespace&gt;\n  kubectl annotate EDPComponent main-keycloak meta.helm.sh/release-namespace=&lt;edp-namespace&gt; -n &lt;edp-namespace&gt;\n  kubectl label KeycloakRealm main app.kubernetes.io/managed-by=Helm -n &lt;edp-namespace&gt;\n  kubectl annotate KeycloakRealm main meta.helm.sh/release-name=&lt;edp-release-name&gt; -n &lt;edp-namespace&gt;\n  kubectl annotate KeycloakRealm main meta.helm.sh/release-namespace=&lt;edp-namespace&gt; -n &lt;edp-namespace&gt;\n</code></pre></p> </li> <li> <p>To upgrade EDP to 3.0, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.0.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.0.x  --dry-run</code></p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>  kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images must be the following:<pre><code>epamedp/edp-jenkins-codenarc-agent:3.0.10\nepamedp/edp-jenkins-dotnet-31-agent:3.0.9\nepamedp/edp-jenkins-go-agent:3.0.17\nepamedp/edp-jenkins-gradle-java11-agent:3.0.7\nepamedp/edp-jenkins-gradle-java8-agent:3.0.10\nepamedp/edp-jenkins-helm-agent:3.0.11\nepamedp/edp-jenkins-kaniko-docker-agent:1.0.9\nepamedp/edp-jenkins-maven-java11-agent:3.0.7\nepamedp/edp-jenkins-maven-java8-agent:3.0.10\nepamedp/edp-jenkins-npm-agent:3.0.9\nepamedp/edp-jenkins-opa-agent:3.0.7\nepamedp/edp-jenkins-python-38-agent:3.0.8\nepamedp/edp-jenkins-sast-agent:0.1.5\nepamedp/edp-jenkins-terraform-agent:3.0.9\n</code></pre> </li> </ul> <ul> <li>Remove the <code>edp-jenkins-dotnet-21-agent</code> agent manifest.</li> </ul> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Attach the <code>id_rsa.pub</code> SSH public key from the <code>gerrit-ciuser-sshkey</code> secret to the <code>edp-ci</code> Gerrit user in the <code>gerrit</code> pod:</p> <pre><code>ssh -p &lt;gerrit_ssh_port&gt; &lt;host&gt; gerrit set-account --add-ssh-key ~/id_rsa.pub\n</code></pre> <p>Notes</p> <ul> <li>For this operation, use the <code>gerrit-admin</code> SSH key from secrets.</li> <li><code>&lt;host&gt;</code> is admin@localhost or any other user with permissions.</li> </ul> </li> <li> <p>Change the username from <code>jenkins</code> to <code>edp-ci</code> in the <code>gerrit-ciuser-sshkey</code> secret:</p> <pre><code>kubectl -n &lt;edp-namespace&gt; patch secret gerrit-ciuser-sshkey\\\n --patch=\"{\\\"data\\\": { \\\"username\\\": \\\"$(echo -n edp-ci |base64 -w0)\\\" }}\" -oyaml\n</code></pre> </li> </ol> <p>Warning</p> <p>In EDP v.3.0.x, Admin Console is deprecated, and EDP interface is available only via EDP Portal.</p>"},{"location":"operator-guide/upgrade-edp-3.0/#related-articles","title":"Related Articles","text":"<ul> <li>Migrate CI Pipelines From Jenkins to Tekton</li> </ul>"},{"location":"operator-guide/upgrade-edp-3.1/","title":"Upgrade EDP v3.0 to 3.1","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to v3.1. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.13.2/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.13.4/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\n</code></pre> </li> <li> <p>To upgrade EDP to the v3.1, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.1.0\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.1.0  --dry-run</code></p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-3.2/","title":"Upgrade EDP v3.1 to 3.2","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to v3.2.2. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_cdstagedeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_gittags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_imagestreamtags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_jiraissuemetadatas.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_cdstagejenkinsdeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsagents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationrolemappings.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsfolders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsjobbuildruns.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsjobs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsscripts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsserviceaccounts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinssharedlibraries.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-component-operator/v0.13.0/deploy-templates/crds/v1.edp.epam.com_edpcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_cdpipelines.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_stages.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_nexuses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_nexususers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_sonargroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_sonarpermissiontemplates.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_sonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritgroupmembers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritmergerequests.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritprojectaccesses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritprojects.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritreplicationconfigs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfdatasourcegitlabs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfdatasourcejenkinses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfdatasourcesonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfservers.yaml\n</code></pre> </li> <li> <p>Generate a cookie-secret for proxy with the following command:</p> <p><pre><code>nexus_proxy_cookie_secret=$(openssl rand -base64 32 | head -c 32)\n</code></pre> Create <code>nexus-proxy-cookie-secret</code> in the  namespace: <pre><code>kubectl -n &lt;edp-project&gt; create secret generic nexus-proxy-cookie-secret \\\n--from-literal=cookie-secret=${nexus_proxy_cookie_secret}\n</code></pre> <li> <p>EDP 3.2.2 features OIDC configuration for EDP Portal. If this parameter is required, create <code>keycloak-client-headlamp-secret</code> as described in this article:</p> <pre><code>kubectl -n &lt;edp-project&gt; create secret generic keycloak-client-edp-portal-secret \\\n--from-literal=clientSecret=&lt;keycloak_client_secret_key&gt;\n</code></pre> </li> <li> <p>Delete the following resources:</p> <pre><code>kubectl -n &lt;edp-project&gt; delete KeycloakClient nexus\nkubectl -n &lt;edp-project&gt; delete EDPComponent nexus\nkubectl -n &lt;edp-project&gt; delete Ingress nexus\nkubectl -n &lt;edp-project&gt; delete deployment edp-tekton-dashboard\n</code></pre> </li> <li> <p>EDP release 3.2.2 uses the default cluster storageClass and we must check previous storageClass parameters. Align , if required, the <code>storageClassName</code> in EDP <code>values.yaml</code> to the same that were used by EDP PVC. For example:</p> <pre><code>edp-tekton:\nbuildTool:\ngo:\ncache:\npersistentVolume:\n# -- Specifies storageClass type. If not specified, a default storageClass for go-cache volume is used\nstorageClass: ebs-sc\n\njenkins-operator:\nenabled: true\njenkins:\nstorage:\n# -- Storageclass for Jenkins data volume\nclass: gp2\n\nsonar-operator:\nsonar:\nstorage:\ndata:\n# --  Storageclass for Sonar data volume\nclass: gp2\ndatabase:\n# --  Storageclass for database data volume\nclass: gp2\n\ngerrit-operator:\ngerrit:\nstorage:\n# --  Storageclass for Gerrit data volume\nclass: gp2\n\nnexus-operator:\nnexus:\nstorage:\n# --  Storageclass for Nexus data volume\nclass: gp2\n</code></pre> </li> <li> <p>To upgrade EDP to the v3.2.2, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.2.2\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.2.2  --dry-run</code></p> </li>"},{"location":"operator-guide/upgrade-edp-3.3/","title":"Upgrade EDP v3.2 to 3.3","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>Note</p> <p>We currently disabled cache volumes for go and npm in the EDP 3.3 release.</p> <p>This section provides the details on the EDP upgrade to v3.3.0. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.16.0/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\n</code></pre> </li> <li> <p>If you use Gerrit VCS, delete the corresponding resource due to changes in annotations:</p> <p><pre><code>kubectl -n edp delete EDPComponent gerrit\n</code></pre> The deployment will create a new EDPComponent called <code>gerrit</code> instead.</p> </li> <li> <p>To upgrade EDP to the v3.3.0, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.3.0\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the <code>--dry-run</code> tag: <code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.3.0  --dry-run</code></p> </li> <li> <p>In EDP v3.3.0, a new feature was introduced allowing manual pipeline re-triggering by sending a comment with <code>/recheck</code>. To enable the re-trigger feature for applications that were added before the upgrade, please proceed with the following:</p> <p>4.1 For Gerrit VCS, add the following event to the <code>webhooks.config</code> configuration file in the <code>All-Projects</code> repository:</p> <pre><code>[remote \"commentadded\"]\n  url = http://el-gerrit-listener:8080\n  event = comment-added\n</code></pre> <p>4.2 For GitHub VCS, check the <code>Issue comments</code> permission for each webhook in every application added before the EDP upgrade to 3.3.0.</p> <p>4.3 For GitLab VCS, check the <code>Comments</code> permission for each webhook in every application added before the EDP upgrade to 3.3.0.</p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-3.4/","title":"Upgrade EDP v3.3 to 3.4","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>Note</p> <p>Pay attention that the following components: <code>perf-operator</code>, <code>edp-admin-console</code>, <code>edp-admin-console-operator</code>, and <code>edp-jenkins-operator</code> are deprecated and should be additionally migrated in order to avoid their deletion. For migration details, please refer to the Migrate CI Pipelines From Jenkins to Tekton instruction.</p> <p>This section provides the details on the EDP upgrade to v3.4.1. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_cdpipelines.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_stages.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_clusterkeycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_clusterkeycloaks.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakauthflows.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakclients.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakclientscopes.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmidentityproviders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmrolebatches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmusers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloaks.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_templates.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.16.0/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\n</code></pre> </li> <li> <p>Remove deprecated components:</p> <p> View: values.yaml <p><pre><code>perf-operator:\nenabled: false\nadmin-console-operator:\nenabled: false\njenkins-operator:\nenabled: false\n</code></pre> </p> <li> <p>Since the values.yaml file structure has been modified, move the dockerRegistry subsection to the global section:</p> <p>The dockerRegistry value has been moved to the global section:</p> <pre><code>global:\ndockerRegistry:\n# -- Define Image Registry that will to be used in Pipelines. Can be ecr (default), harbor\ntype: \"ecr\"\n# -- Docker Registry endpoint\nurl: \"&lt;AWS_ACCOUNT_ID&gt;.dkr.ecr.&lt;AWS_REGION&gt;.amazonaws.com\"\n</code></pre> </li> <li> <p>(Optional) To integrate EDP with Jira, rename the default values from <code>epam-jira-user</code> to <code>jira-user</code> for a secret name. In case Jira is already integrated, it will continue working.</p> <pre><code>codebase-operator:\njira:\ncredentialName: \"jira-user\"\n</code></pre> </li> <li> <p>(Optional) To switch to the Harbor registry, change the secret format for the external secret from kaniko-docker-config v3.3.0 to kaniko-docker-config v3.4.1:</p> View: old format <pre><code> \"kaniko-docker-config\": {\"secret-string\"} //base64 format\n</code></pre> View: new format <pre><code>\"kaniko-docker-config\": {\n\"auths\" : {\n\"registry.com\" :\n{\"username\":\"&lt;registry-username&gt;\",\"password\":\"&lt;registry-password&gt;\",\"auth\":\"secret-string\"}\n}\n}\n</code></pre> </li> <li> <p>To upgrade EDP to the v3.4.1, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.4.1\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the <code>--dry-run</code> tag: <code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.4.1 --dry-run</code></p> </li>"},{"location":"operator-guide/upgrade-edp-3.5/","title":"Upgrade EDP v3.4 to 3.5","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides detailed instructions for upgrading EPAM Delivery Platform to version 3.5.3. Follow the steps and requirements outlined below:</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.19.0/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\n</code></pre> <p>Danger</p> <p>Codebase-operator v2.19.0 is not compatible with the previous versions. Please become familiar with the breaking change in Git Server Custom Resource Definition.</p> </li> <li> <p>Familiarize yourself with the updated file structure of the values.yaml file and adjust your values.yaml file accordingly:</p> <ol> <li> <p>By default, the deployment of sub components such as <code>edp-sonar-operator</code>, <code>edp-nexus-operator</code>, <code>edp-gerrit-operator</code>, and <code>keycloak-operator</code>, have been disabled. Set them back to <code>true</code> in case they are needed or manually deploy external tools, such as SonarQube, Nexus, Gerrit and integrate them with the EPAM Delivery Platform.</p> </li> <li> <p>The default Git provider has been changed from Gerrit to GitHub:</p> <p>Old format:</p> <pre><code>global:\ngitProvider: gerrit\ngerritSSHPort: \"22\"\n</code></pre> <p>New format:</p> <pre><code>global:\ngitProvider: github\n#gerritSSHPort: \"22\"\n</code></pre> </li> <li> <p>The sonarUrl and nexusUrl parameters have been deprecated. All the URLs from external components are stored in integration secrets:</p> <pre><code>global:\n# -- Optional parameter. Link to use custom sonarqube. Format: http://&lt;service-name&gt;.&lt;sonarqube-namespace&gt;:9000 or http://&lt;ip-address&gt;:9000\nsonarUrl: \"\"\n# -- Optional parameter. Link to use custom nexus. Format: http://&lt;service-name&gt;.&lt;nexus-namespace&gt;:8081 or http://&lt;ip-address&gt;:&lt;port&gt;\nnexusUrl: \"\"\n</code></pre> </li> <li> <p>Keycloak integration has been moved from the global section to the sso section. Update the parameters accordingly:</p> <p>Old format:</p> <pre><code>global:\n# -- Keycloak URL\nkeycloakUrl: https://keycloak.example.com\n# -- Administrators of your tenant\nadmins:\n- \"stub_user_one@example.com\"\n# -- Developers of your tenant\ndevelopers:\n- \"stub_user_one@example.com\"\n- \"stub_user_two@example.com\"\n</code></pre> <p>New format:</p> <pre><code>sso:\nenabled: true\n# -- Keycloak URL\nkeycloakUrl: https://keycloak.example.com\n# -- Administrators of your tenant\nadmins:\n- \"stub_user_one@example.com\"\n# -- Developers of your tenant\ndevelopers:\n- \"stub_user_one@example.com\"\n- \"stub_user_two@example.com\"\n</code></pre> </li> <li> <p>(Optional) The default secret name for Jira integration has been changed from <code>jira-user</code> to <code>ci-jira</code>. Please adjust the secret name in the parameters accordingly:</p> <pre><code>codebase-operator:\njira:\ncredentialName: \"ci-jira\"\n</code></pre> </li> </ol> </li> <li> <p>The secret naming and format have been refactored. Below are patterns of the changes for various components:</p> SonarQubeNexusDependency-TrackDefectDojoJiraGitLabGitHub <p>Old format: <pre><code>\"sonar-ciuser-token\": {\n\"username\": \"xxxxx\",\n\"secret\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n}\n</code></pre> New format: <pre><code>\"ci-sonarqube\": {\n\"token\": \"xxxxxxxxxxxxxxxxxxxxxxx\",\n\"url\":\"https://sonar.example.com\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"nexus-ci-user\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxxxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-nexus\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxx\",\n\"url\": \"http://nexus.example.com\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"ci-dependency-track\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-dependency-track\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\",\n\"url\": \"http://dependency-track.example.com\"}\n</code></pre></p> <p>Old format: <pre><code>\"defectdojo-ciuser-token\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\"\n\"url\": \"http://defectdojo.example.com\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-defectdojo\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\",\n\"url\": \"http://defectdojo.example.com\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"jira-user\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-jira\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxx\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"gitlab\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-gitlab\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"github\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-github\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>The tables below illustrate the difference between the old and new format:</p> <p>Old format</p> Secret Name Username Password Token Secret URL jira-user * * nexus-ci.user * * sonar-ciuser-token * * defectdojo-ciuser-token * * ci-dependency-track * <p>New format</p> Secret Name Username Password Token URL ci-jira * * ci-nexus * * * ci-sonarqube * * ci-defectdojo * * ci-dependency-track * * </li> <li> <p>To upgrade EDP to the v3.5.3, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.5.3\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the <code>--dry-run</code> tag: <code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.5.3 --dry-run</code></p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/","title":"Upgrade Keycloak v17.0 to 19.0","text":"<p>Starting from Keycloak v.18.x.x, the Keycloak server has been moved from the Wildfly (JBoss) Application Server to Quarkus framework and is called Keycloak.X.</p> <p>There are two ways to upgrade Keycloak v.17.0.x-legacy to v.19.0.x on Kubernetes, please perform the steps described in the Prerequisites section of this tutorial, and then select a suitable upgrade strategy for your environment:</p> <ul> <li>Upgrade Postgres database to a minor release v.11.17</li> <li>Migrate Postgres database from Postgres v.11.x to v.14.5</li> </ul>"},{"location":"operator-guide/upgrade-keycloak-19.0/#prerequisites","title":"Prerequisites","text":"<p>Before upgrading Keycloak, please perform the steps below:</p> <ol> <li> <p>Create a backup/snapshot of the Keycloak database volume. Locate the AWS <code>volumeID</code> and then create its snapshot on AWS:</p> <ul> <li> <p>Find the <code>PVC</code> name attached to the Postgres pod. It can be similar to <code>data-keycloak-postgresql-0</code> if the Postgres <code>StatefulSet</code> name is <code>keycloak-postgresql</code>:</p> <pre><code>kubectl get pods keycloak-postgresql-0 -n security -o jsonpath='{.spec.volumes[*].persistentVolumeClaim.claimName}{\"\\n\"}'\n</code></pre> </li> </ul> <ul> <li> <p>Locate the <code>PV</code> <code>volumeName</code> in the <code>data-keycloak-postgresql-0</code> Persistent Volume Claim:</p> <pre><code>kubectl get pvc data-keycloak-postgresql-0 -n security -o jsonpath='{.spec.volumeName}{\"\\n\"}'\n</code></pre> </li> </ul> <ul> <li> <p>Get <code>volumeID</code> in the Persistent Volume:</p> <pre><code>kubectl get pv ${pv_name} -n security -o jsonpath='{.spec.awsElasticBlockStore.volumeID}{\"\\n\"}'\n</code></pre> </li> </ul> </li> <li> <p>Add two additional keys: <code>password</code> and <code>postgres-password</code>, to the <code>keycloak-postgresql</code> secret in the Keycloak namespace.</p> <p>Note</p> <ul> <li>The <code>password</code> key must have the same value as the <code>postgresql-password</code> key.</li> <li>The <code>postgres-password</code> key must have the same value as the <code>postgresql-postgres-password</code> key.</li> </ul> <p>The latest chart for Keycloak.X does not have an option to override Postgres password and admin password keys in the secret, and it uses the Postgres defaults, therefore, a new secret scheme must be implemented:</p> <pre><code>kubectl -n security edit secret keycloak-postgresql\n</code></pre> <pre><code>data:\npostgresql-password: XXXXXX\npostgresql-postgres-password: YYYYYY\npassword: XXXXXX\npostgres-password: YYYYYY\n</code></pre> </li> <li> <p>Save Keycloak <code>StatefulSet</code> names, for example, <code>keycloak</code> and <code>keycloak-postgresql</code>. These names will be used in the new Helm deployments:</p> <pre><code>$ kubectl get statefulset -n security\nNAME                  READY   AGE\nkeycloak              1/1     18h\nkeycloak-postgresql   1/1     18h\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#upgrade-postgres-database-to-a-minor-release-v1117","title":"Upgrade Postgres Database to a Minor Release v.11.17","text":"<p>To upgrade Keycloak by upgrading Postgres Database to a minor release v.11.17, perform the steps described in the Prerequisites section of this tutorial, and then perform the following steps:</p>"},{"location":"operator-guide/upgrade-keycloak-19.0/#delete-keycloak-resources","title":"Delete Keycloak Resources","text":"<ol> <li> <p>Delete <code>Keycloak</code> and <code>Prostgres</code> <code>StatefulSets</code>:</p> <pre><code>kubectl delete statefulset keycloak keycloak-postgresql -n security\n</code></pre> </li> <li> <p>Delete the Keycloak <code>Ingress</code>object, to prevent hostname duplication issues:</p> <pre><code>kubectl delete ingress keycloak -n security\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#upgrade-keycloak","title":"Upgrade Keycloak","text":"<ol> <li> <p>Make sure the Keycloak chart repository is added:</p> <pre><code>helm repo add codecentric https://codecentric.github.io/helm-charts\nhelm repo update\n</code></pre> </li> <li> <p>Create values for Keycloak:</p> <p>Note</p> <p>Since the Keycloak.X release, Keycloak  and Postgres database charts are separated. Upgrade Keycloak, and then install the Postgres database.</p> <p>Note</p> <ul> <li><code>nameOverride: \"keycloak\"</code> sets the name of the Keycloak pod. It must be the same Keycloak name as in the previous <code>StatefulSet</code>.</li> <li>Change Ingress host name to the Keycloak host name.</li> <li><code>hostname: keycloak-postgresql</code> is the hostname of the pod with the Postgres database that is the same as Postgres StatefulSet name, for example, <code>keycloak-postgresql</code>.</li> <li><code>\"/opt/keycloak/bin/kc.sh start --auto-build\"</code> was used in the legacy Keycloak version. However, it is no longer required in the new Keycloak version since it is deprecated and used by default.</li> <li> <p>Optionally, use the following command for applying the old Keycloak theme:</p> <p><pre><code>bin/kc.sh start --features-disabled=admin2\n</code></pre> </p> </li> </ul> View: keycloak-values.yaml <pre><code>nameOverride: \"keycloak\"\n\nreplicas: 1\n\n# Deploy the latest verion\nimage:\ntag: \"19.0.1\"\n\n# start: create OpenShift realm which is required by EDP\nextraInitContainers: |\n- name: realm-provider\nimage: busybox\nimagePullPolicy: IfNotPresent\ncommand:\n- sh\nargs:\n- -c\n- |\necho '{\"realm\": \"openshift\",\"enabled\": true}' &gt; /opt/keycloak/data/import/openshift.json\nvolumeMounts:\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumeMounts: |\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumes: |\n- name: realm\nemptyDir: {}\n\ncommand:\n- \"/opt/keycloak/bin/kc.sh\"\n- \"--verbose\"\n- \"start\"\n- \"--http-enabled=true\"\n- \"--http-port=8080\"\n- \"--hostname-strict=false\"\n- \"--hostname-strict-https=false\"\n- \"--spi-events-listener-jboss-logging-success-level=info\"\n- \"--spi-events-listener-jboss-logging-error-level=warn\"\n- \"--import-realm\"\n\nextraEnv: |\n- name: KC_PROXY\nvalue: \"passthrough\"\n- name: KEYCLOAK_ADMIN\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: username\n- name: KEYCLOAK_ADMIN_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: password\n- name: JAVA_OPTS_APPEND\nvalue: &gt;-\n-XX:+UseContainerSupport\n-XX:MaxRAMPercentage=50.0\n-Djava.awt.headless=true\n-Djgroups.dns.query={{ include \"keycloak.fullname\" . }}-headless\n\n# This block should be uncommented if you install Keycloak on Kubernetes\ningress:\nenabled: true\nannotations:\nkubernetes.io/ingress.class: nginx\ningress.kubernetes.io/affinity: cookie\nrules:\n- host: keycloak.&lt;ROOT_DOMAIN&gt;\npaths:\n- path: '{{ tpl .Values.http.relativePath $ | trimSuffix \"/\" }}/'\npathType: Prefix\n\n# This block should be uncommented if you set Keycloak to OpenShift and change the host field\n# route:\n#   enabled: false\n#   # Path for the Route\n#   path: '/'\n#   # Host name for the Route\n#   host: \"keycloak.&lt;ROOT_DOMAIN&gt;\"\n#   # TLS configuration\n#   tls:\n#     enabled: true\n\nresources:\nlimits:\nmemory: \"2048Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"512Mi\"\n\n# Check database readiness at startup\ndbchecker:\nenabled: true\n\ndatabase:\nvendor: postgres\nexistingSecret: keycloak-postgresql\nhostname: keycloak-postgresql\nport: 5432\nusername: admin\ndatabase: keycloak\n</code></pre> </li> <li> <p>Upgrade the Keycloak Helm chart:</p> <p>Note</p> <ul> <li>The Helm chart is substituted with the new Keyacloak.X instance.</li> <li>Change the namespace and the values file name if required.</li> </ul> <pre><code>helm upgrade keycloak codecentric/keycloakx --version 1.6.0 --values keycloak-values.yaml -n security\n</code></pre> <p>Note</p> <p>If there are error messages when upgrading via Helm, make sure that <code>StatefulSets</code> are removed. If they are removed and the error still persists, try to add the <code>--force</code> flag to the Helm command:</p> <pre><code>helm upgrade keycloak codecentric/keycloakx --version 1.6.0 --values keycloak-values.yaml -n security --force\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#install-postgres","title":"Install Postgres","text":"<ol> <li> <p>Add Bitnami chart repository and update Helm repos:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create values for Postgres:</p> <p>Note</p> <ul> <li>Postgres v.11 and Postgres v.14.5 are not compatible.</li> <li>Postgres image will be upgraded to a minor release v.11.17.</li> <li><code>fullnameOverride: \"keycloak-postgresql\"</code> sets the name of the Postgres StatefulSet. It must be the same as in the previous <code>StatefulSet</code>.</li> </ul> View: postgres-values.yaml <pre><code>fullnameOverride: \"keycloak-postgresql\"\n\n# PostgreSQL read only replica parameters\nreadReplicas:\n# Number of PostgreSQL read only replicas\nreplicaCount: 1\n\nglobal:\npostgresql:\nauth:\nusername: admin\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\ndatabase: keycloak\n\nimage:\nregistry: docker.io\nrepository: bitnami/postgresql\ntag: 11.17.0-debian-11-r3\n\nauth:\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\n\nprimary:\npersistence:\nenabled: true\nsize: 3Gi\n# If the StorageClass with reclaimPolicy: Retain is used, install an additional StorageClass before installing PostgreSQL\n# (the code is given below).\n# If the default StorageClass will be used - change \"gp2-retain\" to \"gp2\"\nstorageClass: \"gp2-retain\"\n</code></pre> </li> <li> <p>Install the Postgres database chart:</p> <p>Note</p> <p>Change the namespace and the values file name if required.</p> <pre><code>helm install postgresql bitnami/postgresql \\\n--version 11.7.6 \\\n--values postgres-values.yaml \\\n--namespace security\n</code></pre> </li> <li> <p>Log in to Keycloak and check that everything works as expected.</p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#clean-and-analyze-database","title":"Clean and Analyze Database","text":"<p>Optionally, run the vacuumdb application on the database, to recover space occupied by \"dead tuples\" in the tables, analyze the contents of database tables, and collect statistics for PostgreSQL query engine to improve performance:</p> <p><pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose -d keycloak -U postgres\n</code></pre> For all databases, run the following command:</p> <pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose --all -U postgres\n</code></pre>"},{"location":"operator-guide/upgrade-keycloak-19.0/#migrate-postgres-database-from-postgres-v11x-to-v145","title":"Migrate Postgres Database From Postgres v.11.x to v.14.5","text":"<p>Info</p> <p>There is a Postgres database migration script at the end of this tutorial. Please read the section below before using the script.</p> <p>To upgrade Keycloak by migrating Postgres database from Postgres v.11.x to v.14.5, perform the steps described in the Prerequisites section of this tutorial, and then perform the following steps:</p>"},{"location":"operator-guide/upgrade-keycloak-19.0/#export-postgres-databases","title":"Export Postgres Databases","text":"<ol> <li> <p>Log in to the current Keycloak Postgres pod and create a logical backup of all roles and databases using the pg_dumpall application. If there is no access to the Postgres Superuser, backup the Keycloak database with the pg_dump application:</p> <p>Note</p> <ul> <li>The secret key <code>postgresql-postgres-password</code> is for the <code>postgres</code> Superuser and <code>postgresql-password</code> is for <code>admin</code> user. The <code>admin</code> user is indicated by default in the Postgres Helm chart. The <code>admin</code> user may not have enough permissions to dump all Postgres databases and roles, so the preferred option for exporting all objects is using the <code>pg_dumpall</code> tool with the <code>postgres</code> Superuser.</li> <li>If the <code>PGPASSWORD</code> variable is not specified before using the <code>pg_dumpall</code> tool, you will be prompted to enter a password for each database during the export.</li> <li>If the <code>-l keycloak</code> parameter is specified, <code>pg_dumpall</code> will connect to the <code>keycloak</code> database for dumping global objects and discovering what other databases should be dumped. By default, <code>pg_dumpall</code> will try to connect to <code>postgres</code> or <code>template1</code> databases. This parameter is optional.</li> <li>The <code>pg_dumpall --clean</code> option adds SQL commands to the dumped file for dropping databases before recreating them during import, as well as <code>DROP</code> commands for roles and tablespaces (<code>pg_dump</code> also has this option). If the <code>--clean</code> parameter is specified, connect to the <code>postgres</code> database initially during import via <code>psql</code>. The <code>psql</code> script will attempt to drop other databases immediately, and that will fail for the database you are connected to. This flag is optional, and it is not included into this tutorial.</li> </ul> <pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" pg_dumpall -h localhost -p 5432 -U postgres -l keycloak &gt; /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> <p>Note</p> <p>If there is no working password for the <code>postgres</code> Superuser, try the <code>admin</code> user using the pg_dump tool to export the <code>keycloak</code> database without global roles:</p> <pre><code>PGPASSWORD=\"${postgresql_password}\" pg_dump -h localhost -p 5432 -U admin -d keycloak &gt; /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> <p>Info</p> <p>Double-check that the contents of the dumped file is not empty. It usually contains more than 4000 lines.</p> </li> <li> <p>Copy the file with the database dump to a local machine. Since <code>tar</code> may not be present in the pod and <code>kubectl cp</code> will not work without <code>tar</code>, use the following command:</p> <pre><code>kubectl exec -n security ${postgresql_pod} -- cat /tmp/keycloak_wildfly_db_dump.sql  &gt; keycloak_wildfly_db_dump.sql\n</code></pre> <p>Note</p> <p>Please find below the alternative commands for exporting the database to the local machine without copying the file to a pod for Postgres and admin users:</p> <pre><code>kubectl exec -n security ${postgresql_pod} \"--\" sh -c \"PGPASSWORD='\"${postgresql_postgres-password}\"' pg_dumpall -h localhost -p 5432 -U postgres\" &gt; keycloak_wildfly_db_dump.sql\nkubectl exec -n security ${postgresql_pod} \"--\" sh -c \"PGPASSWORD='\"${postgresql_password}\"' pg_dump -h localhost -p 5432 -U admin -d keycloak\" &gt; keycloak_wildfly_db_dump.sql\n</code></pre> </li> <li> <p>Delete the dumped file from the pod for security reasons:</p> <pre><code>kubectl exec -n security ${postgresql_pod} \"--\" sh -c \"rm /tmp/keycloak_wildfly_db_dump.sql\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#delete-keycloak-resources_1","title":"Delete Keycloak Resources","text":"<ol> <li> <p>Delete all previous Keycloak resources along with the Postgres database and keycloak <code>StatefulSets</code>, <code>Ingress</code>, and custom resources via Helm, or via the tool used for their deployment.</p> <pre><code>helm list -n security\nhelm delete keycloak -n security\n</code></pre> <p>Warning</p> <p>Don't delete the whole namespace. Keep the <code>keycloak-postgresql</code> and <code>keycloak-admin-creds</code> secrets.</p> </li> <li> <p>Delete the volume in AWS, from which a snapshot has been created. Then delete the PVC:</p> <pre><code>kubectl delete pvc data-keycloak-postgresql-0 -n security\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#install-postgres_1","title":"Install Postgres","text":"<ol> <li> <p>Add Bitnami chart repository and update Helm repos:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create Postgres values:</p> <p>Note</p> <p><code>fullnameOverride: \"keycloak-postgresql\"</code> sets the name of the Postgres StatefulSet. It must be same as in the previous <code>StatefulSet</code>.</p> View: postgres-values.yaml <pre><code>nameOverride: \"keycloak-postgresql\"\n\n# PostgreSQL read only replica parameters\nreadReplicas:\n# Number of PostgreSQL read only replicas\nreplicaCount: 1\n\nglobal:\npostgresql:\nauth:\nusername: admin\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\ndatabase: keycloak\n\nauth:\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\n\nprimary:\npersistence:\nenabled: true\nsize: 3Gi\n# If the StorageClass with reclaimPolicy: Retain is used, install an additional StorageClass before installing PostgreSQL\n# (the code is given below).\n# If the default StorageClass will be used - change \"gp2-retain\" to \"gp2\"\nstorageClass: \"gp2-retain\"\n</code></pre> </li> <li> <p>Install the Postgres database:</p> <p>Note</p> <p>Change the namespace and the values file name if required.</p> <pre><code>helm install postgresql bitnami/postgresql \\\n--version 11.7.6 \\\n--values postgres-values.yaml \\\n--namespace security\n</code></pre> </li> <li> <p>Wait for the database to be ready.</p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#import-postgres-databases","title":"Import Postgres Databases","text":"<ol> <li> <p>Upload the database dump to the new Keycloak Postgres pod:</p> <pre><code>cat keycloak_wildfly_db_dump.sql | kubectl exec -i -n security ${postgresql_pod} \"--\" sh -c \"cat &gt; /tmp/keycloak_wildfly_db_dump.sql\"\n</code></pre> <p>Warning</p> <p>Database import must be done before deploying Keycloak, because Keycloak will write its own data to the database during the start, and the import will partially fail. If that happened, scale down the keycloak <code>StatefulSet</code>, and try to drop the Keycloak database in the Postgres pod:</p> <pre><code>dropdb -i -e keycloak -p 5432 -h localhost -U postgres\n</code></pre> <p>If there still are some conflicting objects like roles, drop them via the DROP ROLE command.</p> <p>If the previous steps do not help, downscale the Keycloak and Postgres <code>StatefulSets</code> and delete the attached <code>PVC</code> (save the <code>volumeID</code> before removing), and delete the volume on AWS if using <code>gp2-retain</code>. In case of using <code>gp2</code>, the volume will be deleted automatically after removing PVC. After that, redeploy the Postgres database, so that the new <code>PVC</code> is automatically created.</p> </li> <li> <p>Import the SQL dump file to the Postgres database cluster:</p> <p>Info</p> <p>Since the databases were exported in the <code>sql</code> format, the psql tool will be used to restore (reload) them. pg_restore does not support this plain-text format.</p> <ul> <li> <p>If the entire Postgres database cluster was migrated with the <code>postgres</code> Superuser using <code>pg_dumpall</code>, use the import command without indicating the database:</p> <pre><code>psql -U postgres -f /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> </li> </ul> <ul> <li> <p>If the database was migrated with the <code>admin</code> user using <code>pg_dump</code>, the <code>postgres</code> Superuser still can be used to restore it, but, in this case, a database must be indicated:</p> <p>Warning</p> <p>If the database name was not indicated during the import for the file dumped with <code>pg_dump</code>, the <code>psql</code> tool will import this database to a default Postgres database called <code>postgres</code>.</p> <pre><code>psql -U postgres -d keycloak -f /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> </li> </ul> <ul> <li> <p>If the <code>postgres</code> Superuser is not accessible in the Postgres pod, run the command under the <code>admin</code> or any other user that has the database permissions. In this case, indicate the database as well:</p> <pre><code>psql -U admin -d keycloak -f /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> </li> </ul> </li> <li> <p>After a successful import, delete the dump file from the pod for security reasons:</p> <pre><code>kubectl exec -n security ${postgresql_pod} \"--\" sh -c \"rm /tmp/keycloak_wildfly_db_dump.sql\"\n</code></pre> <p>Note</p> <p>Please find below the alternative commands for importing the database from the local machine to the pod without storing the backup on a pod for <code>postgres</code> or <code>admin</code> users:</p> <pre><code>cat \"keycloak_wildfly_db_dump.sql\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" sh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\"\ncat \"keycloak_wildfly_db_dump.sql\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" sh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\ncat \"keycloak_wildfly_db_dump.sql\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" sh -c \"cat | PGPASSWORD='\"${postgresql_admin_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#install-keycloak","title":"Install Keycloak","text":"<ol> <li> <p>Make sure the Keycloak chart repository is added:</p> <pre><code>helm repo add codecentric https://codecentric.github.io/helm-charts\nhelm repo update\n</code></pre> </li> <li> <p>Create Keycloak values:</p> <p>Note</p> <ul> <li><code>nameOverride: \"keycloak\"</code> sets the name of the Keycloak pod. It must be the same Keycloak name as in the previous <code>StatefulSet</code>.</li> <li>Change Ingress host name to the Keycloak host name.</li> <li><code>hostname: keycloak-postgresql</code> is the hostname of the pod with the Postgres database that is the same as Postgres StatefulSet name, for example, <code>keycloak-postgresql</code>.</li> <li><code>\"/opt/keycloak/bin/kc.sh start --auto-build\"</code> was used in the legacy Keycloak version. However, it is no longer required in the new Keycloak version since it is deprecated and used by default.</li> <li> <p>Optionally, use the following command for applying the old Keycloak theme:</p> <pre><code>bin/kc.sh start --features-disabled=admin2\n</code></pre> </li> </ul> <p>Info</p> <p>Automatic database migration will start after the Keycloak installation.</p> View: keycloak-values.yaml <pre><code>nameOverride: \"keycloak\"\n\nreplicas: 1\n\n# Deploy the latest verion\nimage:\ntag: \"19.0.1\"\n\n# start: create OpenShift realm which is required by EDP\nextraInitContainers: |\n- name: realm-provider\nimage: busybox\nimagePullPolicy: IfNotPresent\ncommand:\n- sh\nargs:\n- -c\n- |\necho '{\"realm\": \"openshift\",\"enabled\": true}' &gt; /opt/keycloak/data/import/openshift.json\nvolumeMounts:\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumeMounts: |\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumes: |\n- name: realm\nemptyDir: {}\n\ncommand:\n- \"/opt/keycloak/bin/kc.sh\"\n- \"--verbose\"\n- \"start\"\n- \"--http-enabled=true\"\n- \"--http-port=8080\"\n- \"--hostname-strict=false\"\n- \"--hostname-strict-https=false\"\n- \"--spi-events-listener-jboss-logging-success-level=info\"\n- \"--spi-events-listener-jboss-logging-error-level=warn\"\n- \"--import-realm\"\n\nextraEnv: |\n- name: KC_PROXY\nvalue: \"passthrough\"\n- name: KEYCLOAK_ADMIN\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: username\n- name: KEYCLOAK_ADMIN_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: password\n- name: JAVA_OPTS_APPEND\nvalue: &gt;-\n-XX:+UseContainerSupport\n-XX:MaxRAMPercentage=50.0\n-Djava.awt.headless=true\n-Djgroups.dns.query={{ include \"keycloak.fullname\" . }}-headless\n\n# This block should be uncommented if you install Keycloak on Kubernetes\ningress:\nenabled: true\nannotations:\nkubernetes.io/ingress.class: nginx\ningress.kubernetes.io/affinity: cookie\nrules:\n- host: keycloak.&lt;ROOT_DOMAIN&gt;\npaths:\n- path: '{{ tpl .Values.http.relativePath $ | trimSuffix \"/\" }}/'\npathType: Prefix\n\n# This block should be uncommented if you set Keycloak to OpenShift and change the host field\n# route:\n#   enabled: false\n#   # Path for the Route\n#   path: '/'\n#   # Host name for the Route\n#   host: \"keycloak.&lt;ROOT_DOMAIN&gt;\"\n#   # TLS configuration\n#   tls:\n#     enabled: true\n\nresources:\nlimits:\nmemory: \"2048Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"512Mi\"\n\n# Check database readiness at startup\ndbchecker:\nenabled: true\n\ndatabase:\nvendor: postgres\nexistingSecret: keycloak-postgresql\nhostname: keycloak-postgresql\nport: 5432\nusername: admin\ndatabase: keycloak\n</code></pre> </li> <li> <p>Deploy Keycloak:</p> <p>Note</p> <p>Change the namespace and the values file name if required.</p> <pre><code>helm install keycloak codecentric/keycloakx --version 1.6.0 --values keycloak-values.yaml -n security\n</code></pre> </li> <li> <p>Log in to Keycloak and check if everything has been imported correctly.</p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#clean-and-analyze-database_1","title":"Clean and Analyze Database","text":"<p>Optionally, run the vacuumdb application on the database, to analyze the contents of database tables and collect statistics for the Postgres query optimizer:</p> <p><pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose -d keycloak -U postgres\n</code></pre> For all databases, run the following command:</p> <pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose --all -U postgres\n</code></pre>"},{"location":"operator-guide/upgrade-keycloak-19.0/#postgres-database-migration-script","title":"Postgres Database Migration Script","text":"<p>Info</p> <p>Please read the Migrate Postgres Database From Postgres v.11.x to v.14.5 section of this tutorial before using the script.</p> <p>Note</p> <ul> <li>The <code>kubectl</code> tool is required for using this script.</li> <li>This script will likely work for any other Postgres database besides Keycloak after some adjustments. It queries the <code>pg_dump</code>, <code>pg_dumpall</code>, <code>psql</code>, and <code>vacuumdb</code> commands under the hood.</li> </ul> <p>The following script can be used for exporting and importing Postgres databases as well as optimizing them with the vacuumdb application. Please examine the code and make the adjustments if required.</p> <ul> <li> <p>By default, the following command exports Keycloak Postgres databases from a Kubernetes pod to a local machine:</p> <pre><code>./script.sh\n</code></pre> <p>After running the command, please follow the prompt.</p> </li> </ul> <ul> <li>To import a database backup to a newly created Postgres Kubernetes pod, pass a database dump sql file to the script:<pre><code>./script.sh path-to/db_dump.sql\n</code></pre> </li> </ul> <ul> <li>The <code>-h</code> flag prints help, and <code>-c|-v</code> runs the <code>vacuumdb</code> garbage collector and analyzer.</li> </ul> View: keycloak_db_migration.sh <pre><code>#!/bin/bash\n\n# set -x\n\ndb_migration_help(){\necho \"Keycloak Postgres database migration\"\necho\necho \"Usage:\"\necho \"------------------------------------------\"\necho \"Export Keycloak Postgres database from pod\"\necho \"Run without parameters:\"\necho \"      $0\"\necho \"------------------------------------------\"\necho \"Import Keycloak Postgres database to pod\"\necho \"Pass filename to script:\"\necho \"      $0 path/to/db_dump.sql\"\necho \"------------------------------------------\"\necho \"Additional options: \"\necho \"      $0 [OPTIONS...]\"\necho \"Options:\"\necho \"h     Print Help.\"\necho \"c|v   Run garbage collector and analyzer.\"\n}\n\nkeycloak_ns(){\nprintf '%s\\n' 'Enter keycloak namespace: '\nread -r keycloak_namespace\n\n    if [ -z \"${keycloak_namespace}\" ]; then\necho \"Don't skip namespace\"\nexit 1\nfi\n}\n\npostgres_pod(){\nprintf '%s\\n' 'Enter postgres pod name: '\nread -r postgres_pod_name\n\n    if [ -z \"${postgres_pod_name}\" ]; then\necho \"Don't skip pod name\"\nexit 1\nfi\n}\n\npostgres_user(){\nprintf '%s\\n' 'Enter postgres username: '\nprintf '%s' \"Skip to use [postgres] superuser: \"\nread -r postgres_username\n\n    if [ -z \"${postgres_username}\" ]; then\npostgres_username='postgres'\nfi\n}\n\npgdb_host_info(){\ndatabase_name='keycloak'\ndb_host='localhost'\ndb_port='5432'\n}\n\npostgresql_admin_pass(){\npostgresql_password='POSTGRES_PASSWORD'\npostgresql_admin_password=\"$(kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"printenv ${postgresql_password}\")\"\n}\n\npostgresql_su_pass(){\npostgresql_postgres_password='POSTGRES_POSTGRES_PASSWORD'\npostgresql_superuser_password=\"$(kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"printenv ${postgresql_postgres_password}\")\"\n\nif [ -z \"${postgresql_superuser_password}\" ]; then\necho \"SuperUser password variable does not exist. Using user password instead...\"\npostgresql_admin_pass\n        postgresql_superuser_password=\"${postgresql_admin_password}\"\nfi\n}\n\nkeycloak_pgdb_export(){\ncurrent_cluster=\"$(kubectl config current-context | tr -dc '[:alnum:]-')\"\nexported_db_name=\"keycloak_db_dump_${current_cluster}_${keycloak_namespace}_${postgres_username}_$(date +\"%Y%m%d%H%M\").sql\"\n\nif [ \"${postgres_username}\" == 'postgres' ]; then\n# call a function to get a pass for postgres user\npostgresql_su_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_superuser_password}\"' pg_dumpall -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\" &gt; \"${exported_db_name}\"\nelse\n# call a function to get a pass for admin user\npostgresql_admin_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_admin_password}\"' pg_dump -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\" &gt; \"${exported_db_name}\"\nfi\n\nseparate_lines=\"---------------\"\n\nif [ ! -s \"${exported_db_name}\" ]; then\nrm -f \"${exported_db_name}\"\necho \"${separate_lines}\"\necho \"Something went wrong. The database dump file is empty and was not saved.\"\nelse\necho \"${separate_lines}\"\ngrep 'Dumped' \"${exported_db_name}\" | sort -u\n        echo \"Database has been exported to $(pwd)/${exported_db_name}\"\nfi\n}\n\nkeycloak_pgdb_import(){\necho \"Preparing Import\"\necho \"----------------\"\n\nif [ ! -f \"$1\" ]; then\necho \"The file $1 does not exist.\"\nexit 1\nfi\n\nkeycloak_ns\n    postgres_pod\n    postgres_user\n    pgdb_host_info\n\n    if [ \"${postgres_username}\" == 'postgres' ]; then\n# restore full backup with all databases and roles as superuser or a single database\npostgresql_su_pass\n        if [ -n \"$(cat \"$1\" | grep 'CREATE ROLE')\" ]; then\ncat \"$1\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\"\nelse\ncat \"$1\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\nfi\nelse\n# restore a single database\npostgresql_admin_pass\n        cat \"$1\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"cat | PGPASSWORD='\"${postgresql_admin_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\nfi\n}\n\nvacuum_pgdb(){\necho \"Preparing garbage collector and analyzer\"\necho \"----------------------------------------\"\n\nkeycloak_ns\n    postgres_pod\n    postgres_user\n    pgdb_host_info\n\n    if [ \"${postgres_username}\" == 'postgres' ]; then\npostgresql_su_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_superuser_password}\"' vacuumdb --analyze --all -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\"\nelse\npostgresql_admin_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_admin_password}\"' vacuumdb --analyze -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\nfi\n}\n\nwhile [ \"$#\" -eq 1 ]; do\ncase \"$1\" in\n-h | --help)\ndb_migration_help\n            exit 0\n;;\n-c | --clean | -v | --vacuum)\nvacuum_pgdb\n            exit 0\n;;\n--)\nbreak\n;;\n-*)\necho \"Invalid option '$1'. Use -h|--help to see the valid options\" &gt;&amp;2\nexit 1\n;;\n*)\nkeycloak_pgdb_import \"$1\"\nexit 0\n;;\nesac\nshift\ndone\n\nif [ \"$#\" -gt 1 ]; then\necho \"Please pass a single file to the script\"\nexit 1\nfi\n\necho \"Preparing Export\"\necho \"----------------\"\nkeycloak_ns\npostgres_pod\npostgres_user\npgdb_host_info\nkeycloak_pgdb_export\n</code></pre>"},{"location":"operator-guide/upgrade-keycloak-19.0/#related-articles","title":"Related Articles","text":"<ul> <li>Deploy OKD 4.10 Cluster</li> </ul>"},{"location":"operator-guide/vcs/","title":"Overview","text":"<p>The Version Control Systems (VCS) section is dedicated to delivering comprehensive information on VCS within the EPAM Delivery Platform. This section comprises detailed descriptions of all the deployment strategies, along with valuable recommendations for their optimal usage, and the list of supported VCS, facilitating seamless integration with EDP.</p>"},{"location":"operator-guide/vcs/#supported-vcs","title":"Supported VCS","text":"<p>EDP can be integrated with the following Version Control Systems:</p> <ul> <li>Gerrit (used by default);</li> <li>GitHub;</li> <li>GitLab.</li> </ul> <p>Note</p> <p>So far, EDP doesn't support authorization mechanisms in the upstream GitLab.</p>"},{"location":"operator-guide/vcs/#vcs-deployment-strategies","title":"VCS Deployment Strategies","text":"<p>EDP offers the following strategies to work with repositories:</p> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with an application language, a build tool, and a framework selected while creating application. This strategy is recommended for projects that start developing their applications from scratch.</li> </ul> <p>Note</p> <p>Under the hood, all the built-in application frameworks, build tools and frameworks are stored in our public GitHub repository.</p> <ul> <li>Import project - enables working with the repository located in the added Git server. This scenario is preferred when the users already have an application stored in their own pre-configured repository and intends to continue working with their repository while also utilizing EDP simultaneously.</li> </ul> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitHub/GitLab in Jenkins or Integrate GitHub/GitLab in Tekton page. The Import project strategy is not applicable for Gerrit. Also, it is impossible to choose the Empty project field when using the Import project strategy while creating appication since it is implied that you already have a ready-to-work application in your own repository, whereas the \"Empty project\" option creates a repository but doesn't put anything in it.</p> <ul> <li>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. In this scenario, the application repository is forked from the original application repository to EDP. Since EDP doesn't support multiple VCS integration for now, this strategy is recommended when the user has several applications located in several repositories.</li> </ul>"},{"location":"operator-guide/vcs/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> </ul>"},{"location":"operator-guide/velero-irsa/","title":"IAM Roles for Velero Service Accounts","text":"<p>Note</p> <p>Make sure that IRSA is enabled and amazon-eks-pod-identity-webhook is deployed according to the Associate IAM Roles With Service Accounts documentation.</p> <p>Velero AWS plugin requires access to AWS resources. Follow the steps below to create a required role:</p> <ol> <li> <p>Create AWS IAM Policy \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero_policy\":</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"ec2:DescribeVolumes\",\n\"ec2:DescribeSnapshots\",\n\"ec2:CreateTags\",\n\"ec2:CreateVolume\",\n\"ec2:CreateSnapshot\",\n\"ec2:DeleteSnapshot\"\n],\n\"Resource\": \"*\"\n},\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"s3:GetObject\",\n\"s3:DeleteObject\",\n\"s3:PutObject\",\n\"s3:AbortMultipartUpload\",\n\"s3:ListMultipartUploadParts\"\n],\n\"Resource\": [\n\"arn:aws:s3:::velero-*/*\"\n]\n},\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"s3:ListBucket\"\n],\n\"Resource\": [\n\"arn:aws:s3:::velero-*\"\n]\n}\n]\n}\n</code></pre> </li> <li> <p>Create AWS IAM Role \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\" with trust relationships:</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:&lt;VELERO_NAMESPACE&gt;:edp-velero\"\n       }\n     }\n   }\n ]\n}\n</code></pre> </li> <li> <p>Attach the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero_policy\" policy to the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\" role.</p> </li> <li> <p>Make sure that Amazon S3 bucket with name velero-\u2039CLUSTER_NAME\u203a exists.</p> </li> <li> <p>Provide key value eks.amazonaws.com/role-arn: \"arn:aws:iam:::role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\" into the serviceAccount.server.annotations parameter in values.yaml during the Velero Installation."},{"location":"operator-guide/velero-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Associate IAM Roles With Service Accounts</li> <li>Install Velero</li> </ul>"},{"location":"operator-guide/waf-tf-configuration/","title":"Configure AWS WAF With Terraform","text":"<p>This page contains accurate information on how to configure AWS WAF using Terraform with the aim to have a secured traffic exposure and to prevent the Host Header vulnerabilities.</p>"},{"location":"operator-guide/waf-tf-configuration/#prerequisites","title":"Prerequisites","text":"<p>To follow the instruction, check the following prerequisites:</p> <ol> <li>Deployed infrastructure includes Nginx Ingress Controller</li> <li>Deployed services for testing</li> <li>Separate and exposed AWS ALB</li> <li>terraform 0.14.10</li> <li>hishicorp/aws = 4.8.0</li> </ol>"},{"location":"operator-guide/waf-tf-configuration/#solution-overview","title":"Solution Overview","text":"<p>The solution includes two parts:</p> <ol> <li>Prerequisites (mostly the left part of the scheme) - AWS ALB, Compute Resources (EC2, EKS, etc.).</li> <li>WAF configuration (the right part of the scheme).</li> </ol> <p>The WAF ACL resource is the main resource used for the configuration; The default web ACL option is Block.</p> <p> Overview WAF Solution </p> <p>The ACL includes three managed AWS rules that secure the exposed traffic:</p> <ul> <li>AWS-AWSManagedRulesCommonRuleSet</li> <li>AWS-AWSManagedRulesLinuxRuleSet</li> <li>AWS-AWSManagedRulesKnownBadInputsRuleSet</li> </ul> <p>AWS provides a lot of rules such as baseline and use-case specific rules, for details, please refer to the Baseline rule groups.</p> <p>There is the PreventHostInjections rule that prevents the Host Header vulnerabilities. This rule includes one statement that declares that the Host Header should match Regex Pattern Set, thus only in this case it will be passed.</p> <p>The Regex Pattern Set is another resource that helps to organize regexes, in fact, is a set of regexes. All regexes added to the single set are matched by the OR statement, i.e. when exposing several URLs, it is necessary to add this statement to the set and refer to it in the rule.</p>"},{"location":"operator-guide/waf-tf-configuration/#waf-acl-configuration","title":"WAF ACL Configuration","text":"<p>To create the Regex Pattern Set, inspect the following code:</p> <pre><code>resource \"aws_wafv2_regex_pattern_set\" \"common\" {\nname  = \"Common\"\nscope = \"REGIONAL\"\n\nregular_expression {\nregex_string = \"^.*(some-url).*((.edp-epam)+)\\\\.com$\"\n}\n\n  #  Add here additional regular expressions for other endpoints, they are merging with OR operator, e.g.\n\n  /*\n   regular_expression {\n      regex_string = \"^.*(jenkins).*((.edp-epam)+)\\\\.com$\"\n   }\n   */\n\ntags = var.tags\n}\n</code></pre> <p>It includes 'regex_string', for example: url - some-url.edp-epam.com, In addition, it is possible to add other links to the same resource using the regular_expression element.</p> <p>There is the Terraform code for the aws_wafv2_web_acl resource:</p> <pre><code>resource \"aws_wafv2_web_acl\" \"external\" {\nname  = \"ExternalACL\"\nscope = \"REGIONAL\"\n\ndefault_action {\nblock {}\n}\n\nrule {\nname     = \"AWS-AWSManagedRulesCommonRuleSet\"\npriority = 1\n\noverride_action {\nnone {}\n}\n\nstatement {\nmanaged_rule_group_statement {\nname        = \"AWSManagedRulesCommonRuleSet\"\nvendor_name = \"AWS\"\n}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"AWS-AWSManagedRulesCommonRuleSet\"\nsampled_requests_enabled   = true\n}\n}\n\nrule {\nname     = \"AWS-AWSManagedRulesLinuxRuleSet\"\npriority = 2\n\nstatement {\nmanaged_rule_group_statement {\nname        = \"AWSManagedRulesLinuxRuleSet\"\nvendor_name = \"AWS\"\n}\n}\n\noverride_action {\nnone {}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"AWS-AWSManagedRulesLinuxRuleSet\"\nsampled_requests_enabled   = true\n}\n}\n\nrule {\nname     = \"AWS-AWSManagedRulesKnownBadInputsRuleSet\"\npriority = 3\n\noverride_action {\nnone {}\n}\n\nstatement {\nmanaged_rule_group_statement {\nname        = \"AWSManagedRulesKnownBadInputsRuleSet\"\nvendor_name = \"AWS\"\n}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"AWS-AWSManagedRulesKnownBadInputsRuleSet\"\nsampled_requests_enabled   = true\n}\n}\n\nrule {\nname     = \"PreventHostInjections\"\npriority = 0\n\nstatement {\nregex_pattern_set_reference_statement {\narn = aws_wafv2_regex_pattern_set.common.arn\n\nfield_to_match {\nsingle_header {\nname = \"host\"\n}\n}\n\ntext_transformation {\npriority = 0\ntype     = \"NONE\"\n}\n}\n}\n\naction {\nallow {}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"PreventHostInjections\"\nsampled_requests_enabled   = true\n}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"ExternalACL\"\nsampled_requests_enabled   = true\n}\n\ntags = var.tags\n}\n</code></pre> <p>As mentioned previously, ACL includes three managed AWS rules (group rules), for visibility, enabling sampling, and CloudWatch in the config. The 'PreventHostInjections' custom rule refers to the created pattern set and declares the Host Header, as well as sets the 'Action' if matched to 'Allow'.</p>"},{"location":"operator-guide/waf-tf-configuration/#associate-aws-resource","title":"Associate AWS Resource","text":"<p>To have the created ACL working, it is necessary to associate an AWS resource with it, in this case, it is AWS ALB:</p> <pre><code>resource \"aws_wafv2_web_acl_association\" \"waf_alb\" {\nresource_arn = aws_lb.&lt;aws_alb_for_waf&gt;.arn\nweb_acl_arn  = aws_wafv2_web_acl.external.arn\n}\n</code></pre> <p>Note</p> <p>AWS ALB can be created in the scope of this Terraform code or created previously. When creating ALB to expose links, the ALB should have a security group that allows some external traffic.</p> <p>When ALB is associated with the WAF ACL, direct the traffic to the ALB by the Route53 CNAME record:</p> <pre><code>module \"some_url_exposure\" {\nsource  = \"terraform-aws-modules/route53/aws//modules/records\"\nversion = \"2.0.0\"\n\nzone_name = \"edp-epam.com\"\n\nrecords = [\n{\nname    = \"some-url\"\ntype    = \"CNAME\"\nttl     = 300\nrecords = [aws_lb.&lt;aws_alb_for_waf&gt;.dns_name]\n}\n]\n}\n</code></pre> <p>In the sample above, the module is used, but it is also possible to use a Terraform resource.</p>"},{"location":"use-cases/","title":"Overview","text":"<p>The Use Cases section provides useful recommendations of how to operate with the EPAM Delivery Platform tools and manage the custom resources. Get acquainted with the description of technical scenarios and solutions.</p> <ul> <li>Scaffold and Deploy FastAPI Application</li> <li>Deploy Application With Custom Build Tool/Framework</li> <li>Secured Secrets Management for Application Deployment</li> <li>Autotest as a Quality Gate</li> </ul>"},{"location":"use-cases/application-scaffolding/","title":"Scaffold and Deploy FastAPI Application","text":""},{"location":"use-cases/application-scaffolding/#overview","title":"Overview","text":"<p>This use case describes the creation and deployment of a FastAPI application to enable a developer to quickly generate a functional code structure for a FastAPI web application (with basic read functionality), customize it to meet specific requirements, and deploy it to a development environment. By using a scaffolding tool and a standardized process for code review, testing and deployment, developers can reduce the time and effort required to build and deploy a new application while improving the quality and reliability of the resulting code. Ultimately, the goal is to enable the development team to release new features and applications more quickly and efficiently while maintaining high code quality and reliability.</p> <p></p>"},{"location":"use-cases/application-scaffolding/#roles","title":"Roles","text":"<p>This documentation is tailored for the Developers and Team Leads.</p>"},{"location":"use-cases/application-scaffolding/#goals","title":"Goals","text":"<ul> <li>Create a new FastAPI application quickly.</li> <li>Deploy the initial code to the DEV environment.</li> <li>Check CI pipelines.</li> <li>Perform code review.</li> <li>Delivery update by deploying the new version.</li> </ul>"},{"location":"use-cases/application-scaffolding/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance is configured with Gerrit, Tekton and Argo CD.</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach.</li> <li>Developer has the <code>Administrator</code> role (to perform merge in Gerrit).</li> </ul>"},{"location":"use-cases/application-scaffolding/#scenario","title":"Scenario","text":"<p>To scaffold and deploy FastAPI Application, follow the steps below.</p>"},{"location":"use-cases/application-scaffolding/#scaffold-the-new-fastapi-application","title":"Scaffold the New FastAPI Application","text":"<ol> <li> <p>Open EDP Portal URL. Use the Sign-In option.</p> <p> Logging screen </p> </li> <li> <p>Ensure <code>Namespace</code> value in the User <code>Settings</code> tab points to the namespace with the EDP installation.</p> <p> Settings button </p> </li> <li> <p>Create the new <code>Codebase</code> with the <code>Application</code> type using the <code>Create</code> strategy. To do this, open EDP tab.</p> <p> Cluster overview </p> </li> <li> <p>Select the <code>Components</code> Section under the EDP tab and push the create <code>+</code> button.</p> <p> Components tab </p> </li> <li> <p>Select the <code>Application</code> Codebase type because we are going to deliver our application as a container and deploy it inside the Kubernetes cluster. Choose the <code>Create</code> strategy to scaffold our application from the template provided by the EDP and press the <code>Proceed</code> button.</p> <p> Step codebase info </p> </li> <li> <p>On the Application Info tab, define the following values and press the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>fastapi-demo</code></li> <li>Default branch: <code>main</code></li> <li>Application code language: <code>Python</code></li> <li>Language version/framework: <code>FastAPI</code></li> <li>Build tool: <code>Python</code></li> </ul> <p> Application info </p> </li> <li> <p>On the <code>Advances Settings</code> tab, define the below values and push the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>edp</code></li> <li>Start version from: <code>0.0.1</code> and <code>SNAPSHOT</code></li> </ul> <p> Advanced settings </p> </li> <li> <p>Check the application status. It should be green:</p> <p> Application status </p> </li> </ol>"},{"location":"use-cases/application-scaffolding/#deploy-the-application-to-the-development-environment","title":"Deploy the Application to the Development Environment","text":"<p>This section describes the application deployment approach from the latest branch commit. The general steps are:</p> <ul> <li>Build the initial version (generated from the template) of the application from the last commit of the <code>main</code> branch.</li> </ul> <ul> <li>Create a <code>CD Pipeline</code> to establish continuous delivery to the development environment. </li> </ul> <ul> <li>Deploy the initial version to the development env.</li> </ul> <p>To succeed with the steps above, follow the instructions below:</p> <ol> <li> <p>Build Container from the latest branch commit. To build the initial version of the application's main branch, go to the fastapi-demo application -&gt; branches -&gt; main and select the <code>Build</code> menu.</p> <p> Application building </p> </li> <li> <p>Build pipeline for the <code>fastapi-demo</code> application starts.</p> <p> Pipeline building </p> </li> <li> <p>Track Pipeline's status by accessing Tekton Dashboard by clicking the <code>fastapi-demo-main-build-lb57m</code> application link.</p> <p> Console logs </p> </li> <li> <p>Ensure that Build Pipeline was successfully completed.</p> </li> <li> <p>Create CD Pipeline. To enable application deployment create a CD Pipeline with a single environment - Development (with the name <code>dev</code>).</p> </li> <li> <p>Go to EDP Portal -&gt; EDP -&gt; CD Pipelines tab and push the <code>+</code> button to create pipeline. In the <code>Create CD Pipeline</code> dialog, define the below values:</p> <ul> <li> <p>Pipeline tab:</p> <ul> <li>Pipeline name: <code>mypipe</code></li> <li>Deployment type: <code>Container</code>, since we are going to deploy containers</li> </ul> <p> Pipeline tab with parameters </p> </li> </ul> <ul> <li> <p>Applications tab. Add <code>fastapi-demo</code> application, select <code>main</code> branch, and leave <code>Promote in pipeline</code> unchecked:</p> <p> Applications tab with parameters </p> </li> </ul> <ul> <li> <p>Stages tab. Add the <code>dev</code> stage with the values below:</p> <ul> <li>Stage name: <code>dev</code></li> <li>Description: <code>Development Environment</code></li> <li>Trigger type: <code>Manual</code>. We plan to deploy applications to this environment manually</li> <li>Quality gate type: <code>Manual</code></li> <li>Step name: <code>approve</code></li> <li>Push the <code>Apply</code> button</li> </ul> <p> Stages tab with parameters </p> </li> </ul> </li> <li> <p>Deploy the initial version of the application to the development environment:</p> <ul> <li>Open CD Pipeline with the name <code>mypipe</code>.</li> <li>Select the <code>dev</code> stage from the Stages tab.</li> <li>In the <code>Image stream version</code> select version <code>0.0.1-SNAPSHOT.1</code> and push the <code>Deploy</code> button.</li> </ul> <p> CD Pipeline deploy </p> </li> </ol>"},{"location":"use-cases/application-scaffolding/#check-the-application-status","title":"Check the Application Status","text":"<p>To ensure the application is deployed successfully, follow the steps below:</p> <ol> <li> <p>Ensure application status is <code>Healthy</code> and <code>Synced</code>, and the <code>Deployed version</code> points to <code>0.0.1-SNAPSHOT.1</code>:</p> <p> Pipeline health status </p> </li> <li> <p>Check that the selected version of the container is deployed on the <code>dev</code> environment. <code>${EDP_ENV}</code> - is the EDP namespace name:</p> <pre><code># Check the deployment status of fastapi-demo application\n$ kubectl get deployments -n ${EDP_ENV}-mypipe-dev\nNAME                 READY   UP-TO-DATE   AVAILABLE   AGE\nfastapi-demo-dl1ft   1/1     1            1           30m\n\n# Check the image version of fastapi-demo application\n$ kubectl get pods -o jsonpath=\"{.items[*].spec.containers[*].image}\" -n ${EDP_ENV}-mypipe-dev\n012345678901.dkr.ecr.eu-central-1.amazonaws.com/${EDP_ENV}/fastapi-demo:0.0.1-SNAPSHOT.1\n</code></pre> </li> </ol>"},{"location":"use-cases/application-scaffolding/#deliver-new-code","title":"Deliver New Code","text":"<p>This section describes the <code>Code Review</code> process for a new code. We need to deploy a new version of our <code>fastapi-demo</code> application that deploys <code>Ingress</code> object to expose API outside the Kubernetes cluster.</p> <p>Perform the below steps to merge new code (Pull Request) that passes the Code Review flow. For the steps below, we use Gerrit UI but the same actions can be performed using the command line and git tool:</p> <ol> <li> <p>Login to Gerrit UI, select <code>fastapi-demo</code> project, and create a change request.</p> </li> <li> <p>Browse Gerrit Repositories and select <code>fastapi-demo</code> project.</p> <p> Browse Gerrit repositories </p> </li> <li> <p>In the <code>Commands</code> section of the project, push the <code>Create Change</code> button.</p> <p> Create Change request </p> </li> <li> <p>In the <code>Create Change</code> dialog, provide the branch <code>main</code> and the <code>Description</code> (commit message):</p> <pre><code>Enable ingress for application\n\nCloses: #xyz\n</code></pre> </li> <li> <p>Push the <code>Create</code> button.</p> <p> Create Change </p> </li> <li> <p>Push the <code>Edit</code> button of the merge request and add <code>deployment-templates/values.yaml</code> for modification.</p> <p> Update values.yaml file </p> </li> <li> <p>Review the <code>deployment-templates/values.yaml</code> file and change the <code>ingress.enabled</code> flag from <code>false</code> to <code>true</code>. Then push the <code>SAVE &amp; PUBLISH</code> button. As soon as you get <code>Verified +1</code> from CI, you are ready for review: Push the <code>Mark as Active</code> button.</p> <p> Review Change </p> </li> <li> <p>You can always check your pipelines status from:</p> <ul> <li>Gerrit UI.</li> </ul> <p> Pipeline Status Gerrit </p> <ul> <li>EDP Portal.</li> </ul> <p> Pipeline Status EDP Portal </p> </li> <li> <p>With no Code Review Pipeline issues, set <code>Code-Review +2</code> for the patchset and push the <code>Submit</code> button. Then, your code is merged to the <code>main</code> branch, triggering the Build Pipeline. The build Pipeline produces the new version of artifact: <code>0.0.1-SNAPSHOT.2</code>, which is available for the deployment.</p> <p> Gerrit Code Review screen </p> </li> <li> <p>Deliver the New Version to the Environment. Before the new version deployment, check the ingress object in <code>dev</code> namespace:</p> <pre><code>$ kubectl get ingress -n ${EDP_ENV}-mypipe-dev\nNo resources found in ${EDP_ENV}-mypipe-dev namespace.\n</code></pre> <p>No ingress object exists as expected.</p> </li> <li> <p>Deploy the new version <code>0.0.1-SNAPSHOT.2</code> which has the ingress object in place. Since we use <code>Manual</code> deployment approach, we perform version upgrade by hand.</p> <ul> <li>Go to the <code>CD Pipelines</code> section of the <code>EDP Portal</code>, select <code>mypipe</code> pipeline and choose <code>dev</code> stage.</li> <li>In the <code>Image stream version</code> select the new version <code>0.0.1-SNAPSHOT.2</code> and push the <code>Update</code> button.</li> <li>Check that the new version is deployed: application status is <code>Healthy</code> and <code>Synced</code>, and the <code>Deployed version</code> points to <code>0.0.1-SNAPSHOT.2</code>.</li> </ul> <p> CD Pipeline Deploy New Version </p> </li> <li> <p>Check that the new version with Ingress is deployed:</p> <pre><code># Check the version of the deployed image\nkubectl get pods -o jsonpath=\"{.items[*].spec.containers[*].image}\" -n ${EDP_ENV}-mypipe-dev\n012345678901.dkr.ecr.eu-central-1.amazonaws.com/edp-delivery-tekton-dev/fastapi-demo:0.0.1-SNAPSHOT.2\n\n# Check Ingress object\nkubectl get ingress -n ${EDP_ENV}-mypipe-dev\nNAME                 CLASS    HOSTS                            ADDRESS          PORTS   AGE\nfastapi-demo-ko1zs   &lt;none&gt;   fastapi-demo-ko1zs-example.com   12.123.123.123   80      115s\n\n# Check application external URL\ncurl https://your-hostname-appeared-in-hosts-column-above.example.com/\n{\"Hello\":\"World\"}\n</code></pre> </li> </ol>"},{"location":"use-cases/application-scaffolding/#related-articles","title":"Related Articles","text":"<ul> <li>Use Cases</li> </ul>"},{"location":"use-cases/autotest-as-quality-gate/","title":"Autotest as a Quality Gate","text":"<p>This use case describes the flow of adding an autotest as a quality gate to a newly created CD pipeline with a selected build version of an application to be promoted. The purpose of autotests is to check if application meets predefined criteria for stability and functionality, ensuring that only reliable versions are promoted. The promotion feature allows users to implement complicated testing, thus improving application stability.</p>"},{"location":"use-cases/autotest-as-quality-gate/#roles","title":"Roles","text":"<p>This documentation is tailored for the Developers and Quality Assurance specialists.</p>"},{"location":"use-cases/autotest-as-quality-gate/#goals","title":"Goals","text":"<ul> <li>Create several applications and autotests quickly.</li> <li>Create a pipeline for Continuous Deployment.</li> <li>Perform testing.</li> <li>Update delivery by deploying the new version.</li> </ul>"},{"location":"use-cases/autotest-as-quality-gate/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance is configured with Gerrit, Tekton and Argo CD.</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach.</li> <li>Developer has the Administrator role (to perform merge in Gerrit).</li> </ul>"},{"location":"use-cases/autotest-as-quality-gate/#create-applications","title":"Create Applications","text":"<p>To implement autotests as Quality Gates, follow the steps below:</p> <ol> <li> <p>Ensure the namespace is specified in the cluster settings. Click the Settings icon in the top right corner and select Cluster settings:</p> <p> Cluster settings </p> </li> <li> <p>Enter the name of the default namespace, then enter your default namespace in the Allowed namespaces field and click the + button. You can also add other namespaces to the Allowed namespaces:</p> <p> Specify namespace </p> </li> <li> <p>Create several applications using the Create strategy. Navigate to the EDP tab, choose Components, click the + button:</p> <p> Add component </p> </li> <li> <p>Select Application and Create from template:</p> <p> Create new component menu </p> <p>Note</p> <p>Please refer to the Add Application section for details.</p> </li> <li> <p>On the Codebase info tab, define the following values and press the Proceed button:</p> <ul> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>js-application</code></li> <li>Component name: <code>js-application</code></li> <li>Description: <code>js application</code></li> <li>Application code language: <code>JavaScript</code></li> <li>Language version/Provider: <code>Vue</code></li> <li>Build tool: <code>NPM</code></li> </ul> <p> Codebase info tab </p> </li> <li> <p>On the Advanced settings tab, define the below values and push the Apply button:</p> <ul> <li>Default branch: <code>main</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> <p> Advanced settings tab </p> </li> <li> <p>Repeat the procedure twice to create the go-application and python-application applications. These applications will have the following parameters:</p> <p>go-application:</p> <ul> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>go-application</code></li> <li>Component name: <code>go-application</code></li> <li>Description: <code>go application</code></li> <li>Application code language: <code>Go</code></li> <li>Language version/Provider: <code>Gin</code></li> <li>Build tool: <code>Go</code></li> <li>Default branch: <code>main</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> <p>python-application:</p> <ul> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>python-application</code></li> <li>Component name: <code>python-application</code></li> <li>Description: <code>python application</code></li> <li>Application code language: <code>Python</code></li> <li>Language version/Provider: <code>FastAPI</code></li> <li>Build tool: <code>Python</code></li> <li>Default branch: <code>main</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> </li> <li> <p>In the Components tab, click one of the applications name to enter the application menu:</p> <p> Components list </p> </li> <li> <p>Click the three dots (\u22ee) button, select Build:</p> <p> Application menu </p> </li> <li> <p>Click the down arrow (v) to observe and wait for the application to be built:</p> <p> Application building </p> </li> <li> <p>Click the application run name to watch the building logs in Tekton:</p> <p> Tekton pipeline run </p> </li> <li> <p>Wait till the build is successful:</p> <p> Successful build </p> </li> <li> <p>Repeat steps 8-12 for the rest of the applications.</p> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#create-autotests","title":"Create Autotests","text":"<p>The steps below instruct how to create autotests in EDP:</p> <ol> <li> <p>Create a couple of autotests using the Create strategy. Navigate to the EDP tab, choose Components, click on the + button. Select Autotest and Clone project:</p> <p> Add autotest </p> <p>Note</p> <p>Please refer to the Add Autotest section for details.</p> </li> <li> <p>On the Codebase info tab, define the following values and press the Proceed button:</p> <ul> <li>Repository URL: <code>https://github.com/SergK/autotests.git</code></li> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>demo-autotest-gradle</code></li> <li>Component name: <code>demo-autotest-gradle</code></li> <li>Description: <code>demo-autotest-gradle</code></li> <li>Autotest code language: <code>Java</code></li> <li>Language version/framework: <code>Java11</code></li> <li>Build tool: <code>Gradle</code></li> <li>Autotest report framework: <code>Allure</code></li> </ul> <p> Codebase info tab for autotests </p> </li> <li> <p>On the Advanced settings tab, leave the settings as is and click the Apply button:</p> <p> Advanced settings tab for autotests </p> </li> <li> <p>Repeat the steps 1-3 to create one more autotest with the parameters below:</p> <ul> <li>Repository URL: <code>https://github.com/Rolika4/autotests.git</code></li> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>demo-autotest-maven</code></li> <li>Component name: <code>demo-autotest-maven</code></li> <li>Description: <code>demo-autotest-maven</code></li> <li>Autotest code language: <code>Java</code></li> <li>Language version/framework: <code>Java11</code></li> <li>Build tool: <code>Maven</code></li> <li>Autotest report framework: <code>Allure</code></li> </ul> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#create-cd-pipeline","title":"Create CD Pipeline","text":"<p>Now that applications and autotests are created, create pipeline for them by following the steps below:</p> <ol> <li> <p>Navigate to the CD Pipelines tab and click the + button:</p> <p> CD pipelines tab </p> </li> <li> <p>On the Pipeline tab, in the Pipeline name field, enter demo-pipeline:</p> <p> Pipeline tab </p> </li> <li> <p>On the Applications tab, add all the three applications, specify the main branch for all for them and check Promote in pipeline for Go and JavaScript applications:</p> <p> Applications tab </p> </li> <li> <p>On the Stages tab, click the Add stage button to open the Create stage menu:</p> <p> Stages tab </p> </li> <li> <p>In the Create stage menu, specify the following parameters and click Apply:</p> <ul> <li>Cluster: <code>In cluster</code></li> <li>Stage name: <code>dev</code></li> <li>Description: <code>dev</code></li> <li>Trigger type: <code>manual</code></li> <li>Quality gate type: <code>Autotests</code></li> <li>Step name: <code>dev</code></li> <li>Autotest: <code>demo-autotest-gradle</code></li> <li>Autotest branch: <code>main</code></li> </ul> <p> Create stage menu </p> </li> <li> <p>After the dev stage is added, click Apply:</p> <p> Create stage menu </p> </li> <li> <p>After the pipeline is created, click its name to open the pipeline details page:</p> <p> Enter pipeline </p> </li> <li> <p>In the pipeline details page, click the Create button to create a new stage:</p> <p> Create a new stage </p> </li> <li> <p>In the Create stage menu, specify the following parameters:</p> <ul> <li>Cluster: <code>In cluster</code></li> <li>Stage name: <code>sit</code></li> <li>Description: <code>sit</code></li> <li>Trigger type: <code>manual</code></li> <li>Quality gate type: <code>Autotests</code></li> <li>Step name: <code>dev</code></li> <li>Autotest: <code>demo-autotest-maven</code></li> <li>Autotest branch: <code>main</code></li> </ul> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#run-autotests","title":"Run Autotests","text":"<p>After the CD pipeline is created, deploy applications and run autotests by following the steps below:</p> <ol> <li> <p>Click the dev stage name to expand its details, specify image versions for each of the applications in the Image stream version field and click Deploy:</p> <p> Deploy applications </p> </li> <li> <p>Once applications are built, scroll down to Quality Gates and click Promote:</p> <p> Promote in pipeline </p> </li> <li> <p>Once promotion procedure is finished, the promoted applications will become available in the Sit stage. You will be able to select image stream versions for the promoted applications. The non-promoted application will stay grey in the stage and won't be allowed to get deployed:</p> <p> Sit stage </p> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add CD Pipeline</li> <li>Add Quality Gate</li> </ul>"},{"location":"use-cases/external-secrets/","title":"Secured Secrets Management for Application Deployment","text":"<p>This Use Case demonstrates how to securely manage sensitive data, such as passwords, API keys, and other credentials, that are consumed by application during development or runtime in production. The approach involves storing sensitive data in an external secret store that is located in a \"vault\" namespace (but can be Vault, AWS Secret Store or any other provider). The process implies transmitting confidential information from the vault namespace to the deployed namespace for the purpose of establishing a connection to a database.</p>"},{"location":"use-cases/external-secrets/#roles","title":"Roles","text":"<p>This documentation is tailored for the Developers and Team Leads.</p>"},{"location":"use-cases/external-secrets/#goals","title":"Goals","text":"<ul> <li>Make confidential information usage secure in the deployment environment.</li> </ul>"},{"location":"use-cases/external-secrets/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance is configured with Gerrit, Tekton and Argo CD;</li> <li>External Secrets is installed;</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach;</li> <li>Developer has the <code>Administrator</code> role (to perform merge in Gerrit);</li> <li>Developer has access to manage secrets in demo-vault namespace.</li> </ul>"},{"location":"use-cases/external-secrets/#scenario","title":"Scenario","text":"<p>To use External Secret in EDP approach, follow the steps below:</p>"},{"location":"use-cases/external-secrets/#add-application","title":"Add Application","text":"<p>To begin, you will need an application first. Here are the steps to create it:</p> <ol> <li> <p>Open EDP Portal URL. Use the <code>Sign-In</code> option:</p> <p> Logging screen </p> </li> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and ensure that both <code>Default namespace</code> and <code>Allowed namespace</code> are set:</p> <p> Cluster settings </p> </li> <li> <p>Create the new <code>Codebase</code> with the <code>Application</code> type using the <code>Create</code> strategy. To do this, click the <code>EDP</code> tab:</p> <p> Cluster overview </p> </li> <li> <p>Select the <code>Components</code> section under the EDP tab and push the <code>+</code> button:</p> <p> Components tab </p> </li> <li> <p>Select the <code>Application</code> Codebase type because we are going to deliver our application as a container and deploy it inside the Kubernetes cluster. Select the <code>Create</code> strategy to use predefined template:</p> <p> Step codebase info </p> </li> <li> <p>On the <code>Application Info</code> tab, define the following values and press the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>es-usage</code></li> <li>Default branch: <code>master</code></li> <li>Application code language: <code>Java</code></li> <li>Language version/framework: <code>Java 17</code></li> <li>Build tool: <code>Maven</code></li> </ul> <p> Step application info </p> </li> <li> <p>On the <code>Advanced Settings</code> tab, define the below values and push the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> <p> Step application info </p> </li> <li> <p>Check the application status. It should be green:</p> <p> Application status </p> </li> </ol>"},{"location":"use-cases/external-secrets/#create-cd-pipeline","title":"Create CD Pipeline","text":"<p>This section outlines the process of establishing a CD pipeline within EDP Portal. There are two fundamental steps in this procedure:</p> <ul> <li>Build the application from the last commit of the <code>master</code> branch;</li> </ul> <ul> <li>Create a <code>CD Pipeline</code> to establish continuous delivery to the SIT environment.</li> </ul> <p>To succeed with the steps above, follow the instructions below:</p> <ol> <li> <p>Create CD Pipeline. To enable application deployment, create a CD Pipeline with a single environment - System Integration Testing (SIT for short). Select the <code>CD Pipelines</code> section under the <code>EDP</code> tab and push the <code>+</code> button:</p> <p> CD-Pipeline tab </p> </li> <li> <p>On the <code>Pipeline</code> tab, define the following values and press the <code>Proceed</code> button:</p> <ul> <li>Pipeline name: <code>deploy</code></li> <li>Deployment type: <code>Container</code></li> </ul> <p> Pipeline tab </p> </li> <li> <p>On the <code>Applications</code> tab, add <code>es-usage</code> application, select <code>master</code> branch, leave <code>Promote in pipeline</code> unchecked and press the <code>Proceed</code> button:</p> <p> Pipeline tab </p> </li> <li> <p>On the <code>Stage</code> tab, add the <code>sit</code> stage with the values below and push the <code>Apply</code> button:</p> <ul> <li>Stage name: <code>sit</code></li> <li>Description: <code>System integration testing</code></li> <li>Trigger type: <code>Manual</code>. We plan to deploy applications to this environment manually</li> <li>Quality gate type: <code>Manual</code></li> <li> <p>Step name: <code>approve</code></p> <p> Stage tab </p> </li> </ul> </li> </ol>"},{"location":"use-cases/external-secrets/#configure-rbac-for-external-secret-store","title":"Configure RBAC for External Secret Store","text":"<p>Note</p> <p>In this scenario, three namespaces are used: <code>demo</code>, which is the namespace where EDP is deployed, <code>demo-vault</code>, which is the vault where developers store secrets, and<code>demo-deploy-sit</code>, which is the namespace used for deploying the application. The target namespace name for deploying application is formed with the pattern: <code>edp-&lt;cd_pipeline_name&gt;-&lt;stage_name&gt;</code>.</p> <p>To make the system to function properly, it is imperative to create the following resources:</p> <ol> <li> <p>Create namespace <code>demo-vault</code> to store secrets:</p> <pre><code> kubectl create namespace demo-vault\n</code></pre> </li> <li> <p>Create Secret:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: mongo\nnamespace: demo-vault\nstringData:\npassword: pass\nusername: user\ntype: Opaque\n</code></pre> </li> <li> <p>Create Role to access the secret:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: Role\nmetadata:\nnamespace: demo-vault\nname: external-secret-store\nrules:\n- apiGroups: [\"\"]\nresources:\n- secrets\nverbs:\n- get\n- list\n- watch\n- apiGroups:\n- authorization.k8s.io\nresources:\n- selfsubjectrulesreviews\nverbs:\n- create\n</code></pre> </li> <li> <p>Create RoleBinding:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\nname: eso-from-edp\nnamespace: demo-vault\nsubjects:\n- kind: ServiceAccount\nname: secret-manager\nnamespace: demo-deploy-sit\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: Role\nname: external-secret-store\n</code></pre> </li> </ol>"},{"location":"use-cases/external-secrets/#add-external-secret-to-helm-chart","title":"Add External Secret to Helm Chart","text":"<p>Now that RBAC is configured properly, it is time to add external secrets templates to application Helm chart. Follow the instructions provided below:</p> <ol> <li> <p>Navigate to <code>EDP Portal</code> -&gt; <code>EDP</code> -&gt; <code>Overview</code>, and push the Gerrit link:</p> <p> Overview page </p> </li> <li> <p>Log in to Gerrit UI, select <code>Repositories</code> and select <code>es-usage</code> project:</p> <p> Browse Gerrit repositories </p> </li> <li> <p>In the <code>Commands</code> section of the project, push the <code>Create Change</code> button:</p> <p> Create Change request </p> </li> <li> <p>In the <code>Create Change</code> dialog, provide the branch <code>master</code> and fill in the <code>Description</code> (commit message) field and push the <code>Create</code> button:</p> <pre><code>Add external secrets templates\n</code></pre> <p> Create Change </p> </li> <li> <p>Push the <code>Edit</code> button of the merge request and then the <code>ADD/OPEN/UPLOAD</code> button and add files:</p> <p> Add files to repository </p> <p>Once the file menu is opened, and click <code>SAVE</code> after editing each of the files:</p> <ol> <li> <p>deploy-templates/templates/sa.yaml:</p> <pre><code>apiVersion: v1\nkind: ServiceAccount\nmetadata:\nname: secret-manager\nnamespace: demo-deploy-sit\n</code></pre> </li> <li> <p>deploy-templates/templates/secret-store.yaml:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: SecretStore\nmetadata:\nname: demo\nnamespace: demo-deploy-sit\nspec:\nprovider:\nkubernetes:\nremoteNamespace: demo-vault\nauth:\nserviceAccount:\nname: secret-manager\nserver:\ncaProvider:\ntype: ConfigMap\nname: kube-root-ca.crt\nkey: ca.crt\n</code></pre> </li> <li> <p>deploy-templates/templates/external-secret.yaml:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: ExternalSecret\nmetadata:\nname: mongo                            # target secret name\nnamespace: demo-deploy-sit    # target namespace\nspec:\nrefreshInterval: 1h\nsecretStoreRef:\nkind: SecretStore\nname: demo\ndata:\n- secretKey: username                   # target value property\nremoteRef:\nkey: mongo                          # remote secret key\nproperty: username                  # value will be fetched from this field\n- secretKey: password                   # target value property\nremoteRef:\nkey: mongo                          # remote secret key\nproperty: password                  # value will be fetched from this field\n</code></pre> </li> <li> <p>deploy-templates/templates/deployment.yaml. Add the environment variable for mongodb to the existing deployment configuration that used the secret:</p> <pre><code>          env:\n- name: MONGO_USERNAME\nvalueFrom:\nsecretKeyRef:\nname: mongo\nkey: username\n- name: MONGO_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: mongo\nkey: password\n</code></pre> </li> </ol> </li> <li> <p>Push the <code>Publish Edit</code> button.</p> </li> <li> <p>As soon as review pipeline finished, and you get <code>Verified +1</code> from CI, you are ready for review. Click <code>Mark as Active</code> -&gt; <code>Code-Review +2</code> -&gt; <code>Submit</code>:</p> <p> Apply change </p> </li> </ol>"},{"location":"use-cases/external-secrets/#deploy-application","title":"Deploy Application","text":"<p>Deploy the application by following the steps provided below:</p> <ol> <li> <p>When build pipeline is finished, navigate to <code>EDP Portal</code> -&gt; <code>EDP</code> -&gt; <code>CD-Pipeline</code> and select <code>deploy</code> pipeline.</p> </li> <li> <p>Deploy the initial version of the application to the SIT environment:</p> <ul> <li>Select the <code>sit</code> stage from the Stages tab;</li> <li>In the <code>Image stream version</code>, select latest version and push the <code>Deploy</code> button.</li> </ul> </li> <li> <p>Ensure application status is <code>Healthy</code> and <code>Synced</code>:</p> <p> CD-Pipeline status </p> </li> </ol>"},{"location":"use-cases/external-secrets/#check-application-status","title":"Check Application Status","text":"<p>To ensure the application is deployed successfully, do the following:</p> <ol> <li> <p>Check that the resources are deployed:</p> <pre><code>kubectl get secretstore -n demo-deploy-sit\nNAME                           AGE     STATUS   READY\ndemo                           5m57s   Valid    True\n</code></pre> <pre><code>kubectl get externalsecret -n demo-deploy-sit\nNAME    STORE                          REFRESH INTERVAL   STATUS         READY\nmongo   demo                           1h                 SecretSynced   True\n</code></pre> </li> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and add <code>demo-deploy-sit</code> to the <code>Allowed namespace</code>.</p> </li> <li> <p>Navigate <code>EDP Portal</code> -&gt; <code>Configuration</code> -&gt; <code>Secrets</code> and ensure that secret was created:</p> <p> Secrets </p> </li> <li> <p>Navigate <code>EDP Portal</code> -&gt; <code>Workloads</code> -&gt; <code>Pods</code> and select deployed application:</p> <p> Pod information </p> </li> </ol>"},{"location":"use-cases/external-secrets/#related-articles","title":"Related Articles","text":"<ul> <li>Use Cases</li> <li>Add Application</li> <li>CD Pipeline</li> </ul>"},{"location":"use-cases/tekton-custom-pipelines/","title":"Deploy Application With Custom Build Tool/Framework","text":"<p>This Use Case describes the procedure of adding custom Tekton libraries that include pipelines with tasks. In addition to it, the process of modifying custom pipelines and tasks is enlightened as well.</p>"},{"location":"use-cases/tekton-custom-pipelines/#goals","title":"Goals","text":"<ul> <li>Add custom Tekton pipeline library;</li> <li>Modify existing pipelines and tasks in a custom Tekton library.</li> </ul>"},{"location":"use-cases/tekton-custom-pipelines/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance with Gerrit and Tekton inside is configured;</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach;</li> <li>Developer has the <code>Administrator</code> role to perform merge in Gerrit.</li> </ul>"},{"location":"use-cases/tekton-custom-pipelines/#scenario","title":"Scenario","text":"<p>Note</p> <p>This case is based on our predefined repository and application. Your case may be different.</p> <p>To create and then modify a custom Tekton library, please follow the steps below:</p>"},{"location":"use-cases/tekton-custom-pipelines/#add-custom-application-to-edp","title":"Add Custom Application to EDP","text":"<ol> <li> <p>Open EDP Portal URL. Use the Sign-In option:</p> <p> Logging screen </p> </li> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and ensure that both <code>Default namespace</code> and <code>Allowed namespace</code> are set:</p> <p> Cluster settings </p> </li> <li> <p>Create the new <code>Codebase</code> with the <code>Application</code> type using the <code>Clone</code> strategy. To do this, click the EDP tab:</p> <p> Cluster overview </p> </li> <li> <p>Select the <code>Components</code> section under the EDP tab and push the create <code>+</code> button:</p> <p> Components tab </p> </li> <li> <p>Select the <code>Application</code> codebase type because is meant to be delivered as a container and deployed inside the Kubernetes cluster. Choose the <code>Clone</code> strategy and this example repository:</p> <p> Step codebase info </p> </li> <li> <p>In the Application Info tab, define the following values and click the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>tekton-hello-world</code></li> <li>Default branch: <code>master</code></li> <li>Application code language: <code>Other</code></li> <li>Language version/framework: <code>go</code></li> <li>Build tool: <code>shell</code></li> </ul> <p> Application info </p> <p>Note</p> <p>These application details are required to match the Pipeline name <code>gerrit-shell-go-app-build-default</code>.</p> <p>The PipelineRun name is formed with the help of TriggerTemplates in <code>pipelines-library</code> so the Pipeline name should correspond to the following structure: <pre><code>  pipelineRef:\n    name: gerrit-$(tt.params.buildtool)-$(tt.params.framework)-$(tt.params.cbtype)-build-$(tt.params.versioning-type)\n</code></pre> The PipelineRun is created as soon as Gerrit (or, if configured, GitHub, GitLab) sends a payload during Merge Request events.</p> </li> <li> <p>In the <code>Advances Settings</code> tab, define the below values and click the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>default</code></li> <li>Leave <code>Specify the pattern to validate a commit message</code> empty.</li> </ul> <p> Advanced settings </p> </li> <li> <p>Check the application status. It should be green:</p> <p> Application status </p> <p>Now that the application is created successfully, proceed to adding the Tekton library.</p> </li> </ol>"},{"location":"use-cases/tekton-custom-pipelines/#add-tekton-library","title":"Add Tekton Library","text":"<ol> <li> <p>Select the <code>Components</code> section under the EDP tab and push the create <code>+</code> button:</p> <p> Components tab </p> </li> <li> <p>Create a new Codebase with the <code>Library</code> type using the <code>Create</code> strategy:</p> <p> Step codebase info </p> <p>Note</p> <p>The EDP Create strategy will automatically pull the code for the Tekton Helm application from here.</p> </li> <li> <p>In the Application Info tab, define the following values and click the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>custom-tekton-chart</code></li> <li>Default branch: <code>master</code></li> <li>Application code language: <code>Helm</code></li> <li>Language version/framework: <code>Pipeline</code></li> <li>Build tool: <code>Helm</code></li> </ul> <p> Step codebase info </p> </li> <li> <p>In the <code>Advances Settings</code> tab, define the below values and click the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>default</code></li> <li>Leave <code>Specify the pattern to validate a commit message</code> empty.</li> </ul> <p> Advanced settings </p> </li> <li> <p>Check the codebase status:</p> <p> Codebase status </p> </li> </ol>"},{"location":"use-cases/tekton-custom-pipelines/#modify-tekton-pipeline","title":"Modify Tekton Pipeline","text":"<p>Note</p> <p>Our recommendation is to avoid modifying the default Tekton resources. Instead, we suggest creating and modifying your own custom Tekton library.</p> <p>Now that the Tekton Helm library is created, it is time to clone, modify and then apply it to the Kubernetes cluster.</p> <ol> <li> <p>Generate SSH key to work with Gerrit repositories:</p> <pre><code>ssh-keygen -t ed25519 -C \"your_email@example.com\"\n</code></pre> </li> <li> <p>Log into Gerrit UI.</p> </li> <li> <p>Go to Gerrit <code>Settings</code> -&gt; <code>SSH keys</code>, paste your generated public SSH key to the <code>New SSH key</code> field and click <code>ADD NEW SSH KEY</code>:</p> <p> Gerrit settings Gerrit settings </p> </li> <li> <p>Browse Gerrit Repositories and select <code>custom-tekton-chart</code> project:</p> <p> Browse Gerrit repositories </p> </li> <li> <p>Clone the repository with <code>SSH</code> using <code>Clone with commit-msg hook</code> command:</p> <p> Gerrit clone </p> <p>Note</p> <p>In case of the strict firewall configurations, please use the <code>HTTP</code> protocol to pull and configure the <code>HTTP Credentials</code> in Gerrit.</p> </li> <li> <p>Examine the repository structure. It should look this way by default:</p> <pre><code>custom-tekton-chart\n  \u251c\u2500\u2500 Chart.yaml\n  \u251c\u2500\u2500 chart_schema.yaml\n  \u251c\u2500\u2500 ct.yaml\n  \u251c\u2500\u2500 lintconf.yaml\n  \u251c\u2500\u2500 templates\n  \u2502\u00a0\u00a0 \u251c\u2500\u2500 pipelines\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 hello-world\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-lib-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-lib-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-review-lib.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-review.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-lib-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-lib-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-review-lib.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-review.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-lib-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-lib-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-review-lib.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u2514\u2500\u2500 gitlab-review.yaml\n  \u2502\u00a0\u00a0 \u2514\u2500\u2500 tasks\n  \u2502\u00a0\u00a0     \u2514\u2500\u2500 task-hello-world.yaml\n  \u2514\u2500\u2500 values.yaml\n</code></pre> <p>Note</p> <p>Change the values in the <code>values.yaml</code> file.</p> <p>The <code>gitProvider</code> parameter is the git hosting provider, Gerrit in this example. The similar approach be made with GitHub, or GitLab.</p> <p>The dnsWildCard parameter is the cluster DNS address.</p> <p>The gerritSSHPort parameter is the SSH port of the Gerrit service on Kubernetes. Check the Gerrit port in your edp installation  global section.</p> <p>Note</p> <p>Our custom Helm chart includes edp-tekton-common-library dependencies in the <code>Chart.yaml</code> file. This library allows to use our predefined code snippets.</p> <p>Here is an example of the filled in <code>values.yaml</code> file:</p> <pre><code>nameOverride: \"\"\nfullnameOverride: \"\"\n\nglobal:\n  gitProvider: gerrit\n  dnsWildCard: \"example.domain.com\"\n  gerritSSHPort: \"30009\"\n</code></pre> </li> <li> <p>Modify and add tasks or pipelines.</p> <p>As an example, let's assume that we need to add the <code>helm-lint</code> pipeline task to the review pipeline. To implement this, insert the code below to the gerrit-review.yaml file underneath the hello task:</p> <pre><code>    - name: hello\n      taskRef:\n        name: hello\n      runAfter:\n      - init-values\n      params:\n      - name: BASE_IMAGE\n        value: \"$(params.shell-image-version)\"\n      - name: username\n        value: \"$(params.username)\"\n      workspaces:\n        - name: source\n          workspace: shared-workspace\n\n    - name: helm-lint\n      taskRef:\n        kind: Task\n        name: helm-lint\n      runAfter:\n        - hello\n      params:\n        - name: EXTRA_COMMANDS\n          value: |\n            ct lint --validate-maintainers=false --charts deploy-templates/\n      workspaces:\n        - name: source\n          workspace: shared-workspace\n</code></pre> <p>Note</p> <p>The <code>helm-lint</code> task references to the default <code>pipeline-library</code> Helm chart which is applied to the cluster during EDP installation.</p> <p>The <code>runAfter</code> parameter shows that this Pipeline task will be run after the <code>hello</code> pipeline task.</p> </li> <li> <p>Build Helm dependencies in the custom chart:</p> <pre><code>helm dependency update .\n</code></pre> </li> <li> <p>Ensure that the chart is valid and all the indentations are fine:</p> <pre><code>helm lint .\n</code></pre> <p>To validate if the values are substituted in the templates correctly, render the templated YAML files with the values using the following command. It generates and displays all the manifest files with the substituted values:</p> <pre><code>helm template .\n</code></pre> </li> <li> <p>Install the custom chart with the command below. You can also use the <code>--dry-run</code> flag to simulate the chart installation and catch possible errors:</p> <pre><code>helm upgrade --install edp-tekton-custom . -n edp --dry-run\n</code></pre> <pre><code>helm upgrade --install edp-tekton-custom . -n edp\n</code></pre> </li> <li> <p>Check the created pipelines and tasks in the cluster:</p> <pre><code>kubectl get tasks -n edp\nkubectl get pipelines -n edp\n</code></pre> </li> <li> <p>Commit and push the modified Tekton Helm chart to Gerrit:</p> <pre><code>git add .\ngit commit -m \"Add Helm chart testing for go-shell application\"\ngit push origin HEAD:refs/for/master\n</code></pre> </li> <li> <p>Check the Gerrit code review for the custom Helm chart pipelines repository in Tekton:</p> <p> Gerrit code review status </p> </li> <li> <p>Go to <code>Changes</code> -&gt; <code>Open</code>, click <code>CODE-REVIEW</code> and submit the merge request:</p> <p> Gerrit merge Gerrit merge </p> </li> <li> <p>Check the build Pipeline status for the custom Pipelines Helm chart repository in Tekton:</p> <p> Tekton status </p> </li> </ol>"},{"location":"use-cases/tekton-custom-pipelines/#create-application-merge-request","title":"Create Application Merge Request","text":"<p>Since we applied the Tekton library to the Kubernetes cluster in the previous step, let's test the review and build pipelines for our <code>tekton-hello-world</code> application.</p> <p>Perform the below steps to merge new code (Merge Request) that passes the Code Review flow. For the steps below, we use Gerrit UI but the same actions can be performed using the command line and Git tool:</p> <ol> <li> <p>Log into Gerrit UI, select <code>tekton-hello-world</code> project, and create a change request.</p> </li> <li> <p>Browse Gerrit Repositories and select <code>tekton-hello-world</code> project:</p> <p> Browse Gerrit repositories </p> </li> <li> <p>Clone the  <code>tekton-hello-world</code> repository to make the necessary changes or click the <code>Create Change</code> button in the <code>Commands</code> section of the project to make changes via Gerrit GUI:</p> <p> Create Change request </p> </li> <li> <p>In the <code>Create Change</code> dialog, provide the branch <code>master</code>, write some text in the <code>Description</code> (commit message) and click the <code>Create</code> button:</p> <p> Create Change </p> </li> <li> <p>Click the <code>Edit</code> button of the merge request and add <code>deployment-templates/values.yaml</code> to modify it and change the <code>ingress.enabled flag</code> from <code>false</code> to <code>true</code>:</p> <p> Update values.yaml file Update values.yaml file </p> </li> <li> <p>Check the Review Pipeline status. The <code>helm-lint</code> pipeline task should be displayed there:</p> <p> Review Change </p> </li> <li> <p>Review the <code>deployment-templates/values.yaml</code> file and push the <code>SAVE &amp; PUBLISH</code> button. As soon as you get <code>Verified +1</code> from CI bot, the change is ready for review. Click the <code>Mark as Active</code> and <code>Code-review</code> buttons:</p> <p> Review Change </p> </li> <li> <p>Click the <code>Submit</code> button. Then, your code is merged to the main branch, triggering the Build Pipeline.</p> <p> Review Change </p> <p>Note</p> <p>If the build is added and configured, push steps in the pipeline, it will produce a new version of artifact, which will be available for the deployment in EDP Portal.</p> </li> <li> <p>Check the pipelines in the Tekton dashboard:</p> <p> Tekton custom pipelines Tekton custom pipelines </p> </li> </ol> <p>What happens under the hood:   1) Gerrit sends a payload during Merge Request event to the Tekton EventListener;   2) EventListener catches it with the help of Interceptor;   3) TriggerTemplate creates a PipelineRun.</p> <p>The detailed scheme is shown below:</p> <pre><code>graph LR;\n    A[Gerrit events] --&gt; |Payload| B(Tekton EventListener) --&gt; C(Tekton Interceptor CEL filter) --&gt; D(TriggerTemplate)--&gt; E(PipelineRun)</code></pre> <p>This chart will be using the core of <code>common-library</code> and <code>pipelines-library</code> and custom resources on the top of them.</p>"},{"location":"use-cases/tekton-custom-pipelines/#related-articles","title":"Related Articles","text":"<ul> <li>Tekton Overview</li> <li>Add Application using EDP Portal</li> </ul>"},{"location":"user-guide/","title":"Overview","text":"<p>The EDP Portal user guide is intended for developers and provides details on working with EDP Portal, different codebase types, and EDP CI/CD flow.</p>"},{"location":"user-guide/#edp-portal","title":"EDP Portal","text":"<p>EDP Portal is a central management tool in the EDP ecosystem that provides the ability to define pipelines, project resources and new technologies in a simple way. Using EDP Portal enables to manage business entities:</p> <ul> <li>Create such codebase types as Applications, Libraries, Autotests and Infrastructures;</li> <li>Create/Update CD Pipelines;</li> <li>Add external Git servers and Clusters.</li> </ul> <p> Overview page </p> <ul> <li>Navigation bar \u2013 consists of the following sections: Overview, Marketplace, Components, CD Pipelines, and Configuration.</li> <li>Top panel bar \u2013 contains documentation link, notifications, EDP Portal settings, and cluster settings, such as default and allowed namespaces.</li> <li>Main links \u2013 displays the corresponding links to the major adjusted toolset, to the management tool and to the OpenShift cluster.</li> <li>Filters \u2013 used for searching and filtering the namespaces.</li> </ul> <p>EDP Portal is a complete tool allowing to manage and control the codebases (applications, autotests, libraries and infrastructures) added to the environment as well as to create a CD pipeline.</p> <p>Inspect the main features available in EDP Portal by following the corresponding link:</p> <ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Add Git Server</li> <li>Add CD Pipeline</li> <li>Add Quality Gate</li> </ul>"},{"location":"user-guide/add-application/","title":"Add Application","text":"<p>Portal allows to create, clone and import an application and add it to the environment. It can also be deployed in Gerrit (if the Clone or Create strategy is used) with the Code Review and Build pipelines built in Jenkins/Tekton.</p> <p>To add an application, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Application and choose one of the strategies which will be described later in this page. You can create an Application in YAML or via the two-step menu in the dialog.</p>"},{"location":"user-guide/add-application/#create-application-in-yaml","title":"Create Application in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Application dialog to open the YAML editor and create the Application.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Application dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-application/#create-application-via-ui","title":"Create Application via UI","text":"<p>The Create Application dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-application/#codebase-info-menu","title":"Codebase Info Menu","text":"<p>Follow the instructions below to fill in the fields of the Codebase Info menu:</p> <ol> <li> <p>In the Create new component menu, select Application:</p> <p> Application info </p> </li> <li> <p>Select the necessary configuration strategy. There are three configuration strategies:</p> </li> </ol> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with an application language, a build tool, and a framework. This strategy is recommended for projects that start developing their applications from scratch.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> </li> </ul> <ul> <li> <p>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well:</p> <p> Clone application </p> <p>In our example, we will use the Create from template strategy:</p> <p> Create application </p> <ol> <li> <p>Select the Git server from the drop-down list and define the relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code>.</p> </li> <li> <p>Type the name of the application in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> </li> <li> <p>Type the application description.</p> </li> <li> <p>To create an application with an empty repository in Gerrit, select the Empty project check box.</p> </li> <li> <p>Select any of the supported application languages with their providers in the Application Code Language field:</p> <ul> <li>Java \u2013 selecting specific Java version (8,11,17 are available).</li> <li>JavaScript - selecting JavaScript allows using React, Vue, Angular, Express, Next.js and Antora frameworks.</li> <li>Python - selecting Python allows using the Python v.3.8, FastAPI, Flask frameworks.</li> <li>Go - selecting Go allows using the Beego, Gin and Operator SDK frameworks.</li> <li>C# - selecting C# allows using the .Net v.3.1 and .Net v.6.0 frameworks.</li> <li>Helm - selecting Helm allows using the Helm framework.</li> <li>Other - selecting Other allows extending the default code languages when creating a codebase with the clone/import strategy. To add another code language, inspect the Add Other Code Language section.</li> </ul> <p>Note</p> <p>The Create from template strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select necessary Language version/framework depending on the Application code language field.</p> </li> <li> <p>Choose the necessary build tool in the Build Tool field:</p> <ul> <li>Java - selecting Java allows using the Gradle or Maven tool.</li> <li>JavaScript - selecting JavaScript allows using the NPM tool.</li> <li>C# - selecting C# allows using the .Net tool.</li> <li>Python - selecting Python allows using Python tool.</li> <li>Go - selecting Go allows using Go tool.</li> <li>Helm - selecting Helm allows using Helm tool.</li> </ul> <p>Note</p> <p>The Select Build Tool field disposes of the default tools and can be changed in accordance with the selected code language.</p> <p>Note</p> <p>Tekton pipelines offer built-in support for Java Maven Multi-Module projects. These pipelines are capable of recognizing Java deployable modules based on the information in the pom.xml file and performing relevant deployment actions. It's important to note that although the Dockerfile is typically located in the root directory, Kaniko, the tool used for building container images, uses the targets folder within the deployable module's context. For a clear illustration of a Multi-Module project structure, please refer to this example on GitHub, which showcases a commonly used structure for Java Maven Multi-Module projects.</p> </li> </ol> </li> </ul>"},{"location":"user-guide/add-application/#advanced-settings-menu","title":"Advanced Settings Menu","text":"<p>The Advanced Settings menu should look similar to the picture below:</p> <p> Advanced settings </p> <p>Follow the instructions below to fill in the fields of the Advanced Setting menu:</p> <p>a. Specify the name of the Default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted. For the Clone project and Import project strategies: if you want to use the existing branch, enter its name into this field.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default - using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li> <p>edp - using the edp versioning type, a developer indicates the version number that will be used for all the artifacts stored in artifactory: binaries, pom.xml, metadata, etc. The version stored in repository (e.g. pom.xml) will not be affected or used. Using this versioning overrides any version stored in the repository files without changing actual file.</p> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> Edp versioning </p> </li> </ul> <p>Type the version number from which you want the artifacts to be versioned.</p> <p>Note</p> <p>The Start Version From field should be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code>.</p> <p> JIRA integration </p> <p>d. Select the Integrate with Jira Server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and setup the Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. In the Jira Server field, select the Jira server.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira. Combine several variables to obtain the desired value.</p> <p>Note</p> <p>The GitLab CI tool is available only with the Import strategy and makes the Jira integration feature unavailable.</p> <p> Mapping fields </p> <p>g. In the Mapping field name section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket from the Mapping field name drop-down menu. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field, select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field, select the EDP_GITTAG variable that defines a tag assigned to the commit in GitHub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the application to the Applications list.</p> <p>Note</p> <p>After the complete adding of the application, inspect the Application Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-application/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Applications</li> <li>Add CD Pipeline</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-autotest/","title":"Add Autotest","text":"<p>Portal enables to clone or import an autotest, add it to the environment with its subsequent deployment in Gerrit (in case the Clone strategy is used) and building of the Code Review pipeline in Jenkins/Tekton, as well as to use it for work with an application under development.  It is also possible to use autotests as quality gates in a newly created CD pipeline.</p> <p>Info</p> <p>Please refer to the Add Application section for the details on how to add an application codebase type. For the details on how to use autotests as quality gates, please refer to the Stages Menu section of the Add CD Pipeline documentation.</p> <p>To add an autotest, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Autotest and choose one of the strategies which will be described later in this page. You can create an autotest in YAML or via the two-step menu in the dialog.</p>"},{"location":"user-guide/add-autotest/#create-autotest-in-yaml","title":"Create Autotest in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Autotest dialog to open the YAML editor and create an autotest:</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Autotest dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-autotest/#create-autotest-via-ui","title":"Create Autotest via UI","text":"<p>The Create Autotest dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-autotest/#the-codebase-info-menu","title":"The Codebase Info Menu","text":"<p>There are two available strategies: clone and import.</p> <ol> <li> <p>The Create new component menu should look like the picture below:</p> <p> Create new component menu </p> </li> <li> <p>In the Repository onboarding strategy field, select the necessary configuration strategy:</p> <ul> <li>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> <p>In our example, we will use the Clone project strategy:</p> <p> Clone autotest </p> <ol> <li> <p>While cloning the existing repository, it is required to fill in the Repository URL field.</p> </li> <li> <p>Select the Git server from the drop-down list and define the relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code>.</p> </li> <li> <p>Select the Repository credentials check box in case you clone the private repository, and fill in the repository login and password/access token.</p> </li> <li> <p>Fill in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> </li> <li> <p>Type the necessary description in the Description field.</p> </li> <li> <p>In the Autotest code language field, select the Java code language with its framework (specify Java 8 or Java 11 to be used) and get the default Maven build tool OR add another code language. Selecting Other allows extending the default code languages and get the necessary build tool, for details, inspect the Add Other Code Language section.</p> <p>Note</p> <p>Using the Create strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select the Java framework if Java is selected above.</p> </li> <li> <p>The Build Tool field can dispose of the default Maven tool, Gradle or other built tool in accordance with the selected code language.</p> </li> <li> <p>All the autotest reports will be created in the Allure framework that is available in the Autotest Report Framework field by default.</p> </li> </ol> </li> </ul> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol> <p>The Advanced Settings menu should look like the picture below:</p> <p> Advanced settings </p> <p>a. Specify the name of the default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default: Using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li> <p>edp: Using the edp versioning type, a developer indicates the version number from which all the artifacts will be versioned and, as a result, automatically registered in the corresponding file (e.g. pom.xml).</p> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> Edp versioning </p> <p>Type the version number from which you want the artifacts to be versioned.</p> </li> </ul> <p>Note</p> <p>The Start Version From field must be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code></p> <p> Jira integration </p> <p>d. Select the Integrate with Jira Server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. As soon as the Jira server is set, select it in the Jira Server field.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira.</p> <p> Mapping field name </p> <p>g. In the Advanced Mapping section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field select the EDP_GITTAGvariable that defines a tag assigned to the commit in Git Hub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the library to the Libraries list.</p> <p>Note</p> <p>After the complete adding of the autotest, inspect the Autotest Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-autotest/#the-advanced-settings-menu","title":"The Advanced Settings Menu","text":""},{"location":"user-guide/add-autotest/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Autotests</li> <li>Add Application</li> <li>Add CD Pipelines</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-cd-pipeline/","title":"Add CD Pipeline","text":"<p>Portal provides the ability to deploy an environment on your own and specify the essential components.</p> <p>Navigate to the CD Pipelines section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create CD Pipeline dialog will appear.</p> <p>The creation of the CD pipeline becomes available as soon as an application is created including its provisioning in a branch and the necessary entities for the environment. You can create the CD pipeline in YAML or via the three-step menu in the dialog.</p>"},{"location":"user-guide/add-cd-pipeline/#create-cd-pipeline-in-yaml","title":"Create CD Pipeline in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create CD Pipeline dialog to open the YAML editor and create the CD Pipeline.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create CD Pipeline dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-cd-pipeline/#create-cd-pipeline-in-the-dialog","title":"Create CD Pipeline in the Dialog","text":"<p>The Create CD Pipeline dialog contains the three steps:</p> <ul> <li>The Pipeline Menu</li> <li>The Applications Menu</li> <li>The Stages Menu</li> </ul>"},{"location":"user-guide/add-cd-pipeline/#the-pipeline-menu","title":"The Pipeline Menu","text":"<p>The Pipeline tab of the Create CD Pipeline menu should look like the picture below:</p> <p> Create CD pipeline </p> <ol> <li> <p>Type the name of the pipeline in the Pipeline Name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> <p>Note</p> <p>The namespace created by the CD pipeline has the following pattern combination: [edp namespace]-[cd pipeline name]-[stage name]. Please be aware that the namespace length should not exceed 63 symbols.</p> </li> <li> <p>Select the deployment type from the drop-down list:</p> <ul> <li>Container - the pipeline will be deployed in a Docker container;</li> <li>Custom - this mode allows to deploy non-container applications and customize the Init stage of CD pipeline.</li> </ul> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#the-applications-menu","title":"The Applications Menu","text":"<p>The Pipeline tab of the Create CD Pipeline menu should look like the picture below:</p> <p> CD pipeline applications </p> <ol> <li>Select the necessary application from the Mapping field name drop-down menu.</li> <li>Select the plus sign icon near the selected application to specify the necessary codebase Docker branch for the application (the output for the branch and other stages from other CD pipelines).</li> <li>Select the application branch from the drop-down menu.</li> <li> <p>Select the Promote in pipeline check box in order to transfer the application from one to another stage   by the specified codebase Docker branch. If the Promote in pipeline check box is not selected,   the same codebase Docker stream will be deployed regardless of the stage, i.e. the codebase Docker stream input,   which was selected for the pipeline, will always be used.</p> <p>Note</p> <p>The newly created CD pipeline has the following pattern combination: [pipeline name]-[branch name]. If there is another deployed CD pipeline stage with the respective codebase Docker stream (= image stream as an OpenShift term), the pattern combination will be as follows: [pipeline name]-[stage name]-[application name]-[verified].</p> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#the-stages-menu","title":"The Stages Menu","text":"<ol> <li> <p>Click the plus sign icon in the Stages menu and fill in the necessary fields in the Adding Stage window :</p> <p> CD stages </p> <p> Adding stage </p> <p>a. Type the stage name;</p> <p>Note</p> <p>The namespace created by the CD pipeline has the following pattern combination: [cluster name]-[cd pipeline name]-[stage name]. Please be aware that the namespace length should not exceed 63 symbols.</p> <p>b. Enter the description for this stage;</p> <p>c. Select the trigger type. The key benefit of the automatic deploy feature is to keep environments up-to-date. The available trigger types are Manual and Auto. When the Auto trigger type is chosen, the CD pipeline will initiate automatically once the image is built. Manual implies that user has to perform deploy manually by clicking the Deploy button in the CD Pipeline menu. Please refer to the Architecture Scheme of CD Pipeline Operator page for additional details.</p> <p>Note</p> <p>In Tekton deploy scenario, automatic deploy will start working only after the first manual deploy.</p> <p>d. Select the job provisioner. In case of working with non-container-based applications, there is an option to use a custom job provisioner. Please refer to the Manage Jenkins CD Job Provision page for details.</p> <p>e. Select the groovy-pipeline library;</p> <p>f. Select the branch;</p> <p>g. Add an unlimited number of quality gates by clicking a corresponding plus sign icon and remove them as well by clicking the recycle bin icon;</p> <p>h. Type the step name, which will be displayed in Jenkins/Tekton, for every quality gate;</p> <p>i. Select the quality gate type:</p> <ul> <li>Manual - means that the promoting process should be confirmed in Jenkins/Tekton manually;</li> <li>Autotests - means that the promoting process should be confirmed by the successful passing of the autotests.</li> </ul> <p>In the additional fields, select the previously created autotest name (j) and specify its branch for the autotest that will be launched on the current stage (k).</p> <p>Note</p> <p>Execution sequence. The image promotion and execution of the pipelines depend on the sequence in which the environments are added.</p> <p>l. Click the Apply button to display the stage in the Stages menu.</p> <p> Continuous delivery menu </p> </li> <li> <p>Edit the stage by clicking its name and applying changes, and remove the added stage by clicking the recycle bin icon    next to its name.</p> </li> <li> <p>Click the Apply button to start the provisioning of the pipeline. After the CD pipeline is added, the new project with the stage name will be created in OpenShift.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#manage-cd-pipeline","title":"Manage CD Pipeline","text":"<p>As soon as the CD pipeline is provisioned and added to the CD Pipelines list, there is an ability to:</p> <p> CD pipeline page </p> <ol> <li> <p>Create another application by clicking the plus sign icon in the lower-right corner of the screen and performing the same steps as described in the Add CD Pipeline section.</p> </li> <li> <p>Open CD pipeline data by clicking its link name. Once clicked, the following blocks will be displayed:</p> <ul> <li>General Info - displays common information about the CD pipeline, such as name and deployment type.</li> <li>Applications - displays the CD pipeline applications to promote.</li> <li>Stages - displays the CD pipeline stages and stage metadata (by selecting the information icon near the stage name); allows to add, edit and delete stages, as well as deploy or uninstall image stream versions of the related applications for a stage.</li> <li>Metadata - displays the CD pipeline name, namespace, creation date, finalizers, generation, resource version, and UID. Open this block by selecting the information icon near the options icon next to the CD pipeline name.</li> </ul> </li> <li> <p>Edit the CD pipeline by selecting the options icon next to its name in the CD Pipelines list, and then selecting Edit. For details see the Edit Existing CD Pipeline section.</p> </li> <li> <p>Delete the added CD pipeline by selecting the options icon next to its name in the CD Pipelines list, and then selecting Delete.</p> <p>Info</p> <p>In OpenShift, if the deployment fails with the ImagePullBackOff error, delete the POD.</p> </li> <li> <p>Sort the existing CD pipelines in a table by clicking the sorting icons in the table header. When sorting by name, the CD pipelines will be displayed in alphabetical order. You can also sort the CD pipelines by their status.</p> </li> <li> <p>Search the necessary CD pipeline by the namespace or by entering the corresponding name, language or the build tool into the Filter tool.</p> </li> <li> <p>Select a number of CD pipelines displayed per page (15, 25 or 50 rows) and navigate between pages if the number of CD pipelines exceeds the capacity of a single page.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#edit-existing-cd-pipeline","title":"Edit Existing CD Pipeline","text":"<p>Edit the CD pipeline directly from the CD Pipelines overview page or when viewing the CD Pipeline data:</p> <ol> <li> <p>Select Edit in the options icon menu next to the CD pipeline name:</p> <p> Edit CD pipeline on the CD Pipelines overview page </p> <p> Edit CD pipeline when viewing the CD pipeline data </p> </li> <li> <p>Apply the necessary changes (edit the list of applications for deploy, application branches, and promotion in the pipeline). Add new extra stages by clicking the plus sign icon and filling in the application branch and promotion in the pipeline.</p> <p> Edit CD pipeline dialog </p> </li> <li> <p>Select the Apply button to confirm the changes.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#add-a-new-stage","title":"Add a New Stage","text":"<p>In order to create a new stage for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Add CD pipeline stage </p> </li> <li> <p>Select Create to open the Create stage dialog.</p> </li> <li> <p>Click Edit YAML in the upper-right corner of the Create stage dialog to open the YAML editor and add a stage. Otherwise, fill in the required fields in the dialog. Please see the Stages Menu section for details.</p> </li> <li> <p>Click the Apply button.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#edit-stage","title":"Edit Stage","text":"<p>In order to edit a stage for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Edit CD pipeline stage </p> </li> <li> <p>Select the options icon related to the necessary stage and then select Edit.</p> <p> Edit CD pipeline stage dialog </p> </li> <li> <p>In the Edit Stage dialog, change the stage trigger type. See more about this field in the Stages Menu section.</p> </li> <li> <p>Click the Apply button.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#delete-stage","title":"Delete Stage","text":"<p>Note</p> <p>You cannot remove the last stage, as the CD pipeline does not exist without stages.</p> <p>In order to delete a stage for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Delete CD pipeline stage </p> </li> <li> <p>Select the options icon related to the necessary stage and then select Delete. After the confirmation, the CD stage is deleted with all its components: database record, Jenkins/Tekton pipeline, and cluster namespace.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#view-stage-data","title":"View Stage Data","text":"<p>To view the CD pipeline stage data for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Expand CD pipeline stage </p> </li> <li> <p>Select the expand icon near the stage name. The following blocks will be displayed:</p> <p> CD pipeline stage overview </p> </li> </ol> <ul> <li>Applications - displays the status of the applications related to the stage and allows deploying the applications. Applications health and sync statuses are returned from the Argo CD tool.</li> <li>General Info - displays the stage status, CD pipeline, description, job provisioning, order, trigger type, and source.</li> <li>Quality Gates - displays the stage quality gate type, step name, autotest name, and branch name.</li> </ul>"},{"location":"user-guide/add-cd-pipeline/#deploy-application","title":"Deploy Application","text":"<p>Navigate to the Applications block of the stage and select an application. Select the image stream version from the drop-down list and click Deploy. The application will be deployed in the Argo CD tool as well.</p> <p> Deploy the promoted application </p> <p>To update or uninstall the application, select Update or Uninstall.</p> <p> Update or uninstall the application </p> <p>After this, the application will be updated or uninstalled in the Argo CD tool as well.</p> <p>Note</p> <p>In a nutshell, the Update button updates your image version in the Helm chart, whereas the Uninstall button deletes the Helm chart from the namespace where the pipeline is deployed.</p>"},{"location":"user-guide/add-cd-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Jenkins CD Pipeline Job Provision</li> </ul>"},{"location":"user-guide/add-cluster/","title":"Add Cluster","text":"<p>Adding other clusters allows deploying applications to several clusters when creating a stage of CD pipeline in EDP Portal.</p> <p>To add a cluster, follow the steps below:</p> <ol> <li> <p>Navigate to the Configuration section on the navigation bar and select Clusters. The appearance differs depending on the chosen display option:</p> List optionTiled option <p> Configuration menu (List option) </p> <p> Configuration menu (Tiled option) </p> </li> <li> <p>Click the + button to enter the Create new cluster menu:</p> <p> Add Cluster </p> </li> <li> <p>Once clicked, the Create new cluster dialog will appear. You can create a Cluster in YAML or via UI:</p> </li> </ol> Add cluster in YAMLAdd cluster via UI <p>To add cluster in YAML, follow the steps below:</p> <ul> <li>Click the Edit YAML button in the upper-right corner of the Create New Cluster dialog to open the YAML editor and create a Kubernetes secret.</li> </ul> <p> Edit YAML </p> <ul> <li>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create new cluster dialog.</li> </ul> <ul> <li>To save the changes, select the Save &amp; Apply button.</li> </ul> <p>To add cluster in YAML, follow the steps below:</p> <ul> <li> <p>To add a new cluster via the dialog menu, fill in the following fields in the Create New Cluster dialog:</p> <ul> <li>Cluster Name - enter a cluster name;</li> <li>Cluster Host - enter a cluster host;</li> <li>Cluster Token - enter a cluster token;</li> <li>Cluster Certificate - enter a cluster certificate.</li> </ul> </li> </ul> <p> Add Cluster </p> <ul> <li>Click the Apply button to add the cluster to the clusters list.</li> </ul> <p>As a result, the Kubernetes secret will be created for further integration.</p> <p>Currently, the EDP uses the shared Argo CD and the secret needs to be copied to the namespace where the Argo CD is installed.</p>"},{"location":"user-guide/add-cluster/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add Autotest</li> <li>Add CD Pipeline</li> </ul>"},{"location":"user-guide/add-custom-global-pipeline-lib/","title":"Add a Custom Global Pipeline Library","text":"<p>In order to add a new custom global pipeline library, perform the steps below:</p> <ol> <li> <p>Navigate to Jenkins and go to Manage Jenkins -&gt; Configure System -&gt; Global Pipeline Libraries.</p> <p>Note</p> <p>It is possible to configure as many libraries as necessary. Since these libraries will be globally usable, any pipeline in the system can utilize the functionality implemented in these libraries.</p> </li> <li> <p>Specify the following values:</p> <p> Add custom library </p> <p>a. Library name: The name of a custom library.</p> <p>b. Default version: The version which can be branched, tagged or hashed of a commit.</p> <p>c. Load implicitly: If checked, scripts will automatically have access to this library without needing to request it via @Library. It means that there is no need to upload the library manually because it will be downloaded automatically during the build for each job.</p> <p>d. Allow default version to be overridden: If checked, scripts may select a custom version of the library by appending @someversion in the @Library annotation. Otherwise, they are restricted to using the version selected here.</p> <p>e. Include @Library changes in job recent changes: If checked, any changes in the library will be included in the changesets of a build, and changing the library would cause new builds to run for Pipelines that include this library. This can be overridden in the jenkinsfile: @Library(value=\"name@version\", changelog=true|false).</p> <p>f. Cache fetched versions on controller for quick retrieval: If checked, versions fetched using this library will be cached on the controller. If a new library version is not downloaded during the build for some reason, remove the previous library version from cache in the Jenkins workspace.</p> <p>Note</p> <p>If the Default version check box is not defined, the pipeline must specify a version, for example, <code>@Library('my-shared-library@master')</code>. If the Allow default version to be overridden check box is enabled in the Shared Library\u2019s configuration, a @Library annotation may also override the default version defined for the library.</p> <p> Source code management </p> <p>g. Project repository: The URL of the repository</p> <p>h. Credentials: The credentials for the repository.</p> </li> <li> <p>Use the Custom Global Pipeline Libraries on the pipeline, for example:</p> </li> </ol> <p>Pipeline</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines', 'edp-custom-shared-library-name'])_\n\nBuild()\n</code></pre> <p>Note</p> <p><code>edp-custom-shared-library-name</code> is the name of the Custom Global Pipeline Library that should be added to the Jenkins Global Settings.</p>"},{"location":"user-guide/add-custom-global-pipeline-lib/#related-articles","title":"Related Articles","text":"<ul> <li>Jenkins Official Documentation: Extending with Shared Libraries</li> </ul>"},{"location":"user-guide/add-git-server/","title":"Add Git Server","text":"<p>Important</p> <p>This article describes how to add a Git Server when deploying EDP with Jenkins. When deploying EDP with Tekton, Git Server is created automatically.</p> <p>Add Git servers to use the Import strategy for Jenkins and Tekton when creating an application, autotest or library in EDP Portal (Codebase Info step of the Create Application/Autotest/Library dialog). Enabling the Import strategy is a prerequisite to integrate EDP with Gitlab or GitHub.</p> <p>Note</p> <p><code>GitServer</code> Custom Resource can be also created manually. See step 3 for Jenkins import strategy in the Integrate GitHub/GitLab in Jenkins article.</p> <p>To add a Git server, navigate to the Git servers section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create Git server dialog will appear. You can create a Git server in YAML or via the three-step menu in the dialog.</p>"},{"location":"user-guide/add-git-server/#create-git-server-in-yaml","title":"Create Git Server in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Git server dialog to open the YAML editor and create a Git server.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Git server dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-git-server/#create-git-server-in-the-dialog","title":"Create Git Server in the Dialog","text":"<p>Fill in the following fields:</p> <p> Create Git server </p> <ul> <li>Git provider - select Gerrit, GitLab or GitHub.</li> <li>Host - enter a Git server endpoint.</li> <li>User - enter a user for Git integration.</li> <li>SSH port - enter a Git SSH port.</li> <li>HTTPS port - enter a Git HTTPS port.</li> <li>Private SSH key - enter a private SSH key for Git integration. To generate this key, follow the instructions of the step 1 for Jenkins in the Integrate GitHub/GitLab in Jenkins article.</li> <li>Access token - enter an access token for Git integration. To generate this token, go to GitLab/GitHub account -&gt; Settings -&gt; SSH and GPG keys -&gt; select New SSH key and add SSH key.</li> </ul> <p>Click the Apply button to add the Git server to the Git servers list. As a result, the Git Server object and the corresponding secret for further integration will be created.</p>"},{"location":"user-guide/add-git-server/#related-articles","title":"Related Articles","text":"<ul> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> </ul>"},{"location":"user-guide/add-infrastructure/","title":"Add Infrastructure","text":"<p>EDP Portal allows to create, clone and import an infrastructure. Its functionality is to create resources in cloud provider.</p> <p>To add an application, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Application and choose one of the strategies which will be described later in this page. You can create an Application in YAML or via the two-step menu in the dialog.</p>"},{"location":"user-guide/add-infrastructure/#create-infrastructure-in-yaml","title":"Create Infrastructure in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Infrastructure dialog to open the YAML editor and create the Infrastructure.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Infrastructure dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-infrastructure/#create-infrastructure-via-ui","title":"Create Infrastructure via UI","text":"<p>The Create Infrastructure dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-infrastructure/#codebase-info-menu","title":"Codebase Info Menu","text":"<p>Follow the instructions below to fill in the fields of the Codebase Info menu:</p> <ol> <li> <p>In the Create new component menu, select Infrastructure:</p> <p> Infrastructure info </p> </li> <li> <p>Select the necessary configuration strategy:</p> </li> </ol> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with an infrastructure language, a build tool, and a framework.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> </li> </ul> <ul> <li> <p>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well:</p> <p>In our example, we will use the Create from template strategy:</p> <p> Create infrastructure </p> <ol> <li> <p>Select the Git server from the drop-down list and define the Git repo relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code>.</p> </li> <li> <p>Type the name of the infrastructure in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> </li> <li> <p>Write the description in the Description field.</p> </li> <li> <p>To create an application with an empty repository in Gerrit, select the Empty project check box.</p> </li> <li> <p>Select any of the supported application languages with their providers in the Infrastructure Code Language field. So far, only HCL is supported.</p> <p>Note</p> <p>The Create from template strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select necessary Language version/framework depending on the Infrastructure code language field. So far, only AWS is supported.</p> </li> <li> <p>Choose the necessary build tool in the Build Tool field. So far, only Terraform is supported.\\</p> <p>Note</p> <p>The Select Build Tool field disposes of the default tools and can be changed in accordance with the selected code language.</p> </li> </ol> </li> </ul> <p>The Advanced Settings menu should look similar to the picture below:</p> <p> Advanced settings </p> <p>Follow the instructions below to fill in the fields of the Advanced Setting menu:</p> <p>a. Specify the name of the Default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted. For the Clone project and Import project strategies: if you want to use the existing branch, enter its name into this field.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default - using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li> <p>edp - using the edp versioning type, a developer indicates the version number that will be used for all the artifacts stored in artifactory: binaries, pom.xml, metadata, etc. The version stored in repository (e.g. pom.xml) will not be affected or used. Using this versioning overrides any version stored in the repository files without changing actual file.</p> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> Edp versioning </p> </li> </ul> <p>Type the version number from which you want the artifacts to be versioned.</p> <p>Note</p> <p>The Start Version From field should be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code>.</p> <p> JIRA integration </p> <p>d. Select the Integrate with Jira Server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and setup the Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. In the Jira Server field, select the Jira server.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira. Combine several variables to obtain the desired value.</p> <p>Note</p> <p>The GitLab CI tool is available only with the Import strategy and makes the Jira integration feature unavailable.</p> <p> Mapping fields </p> <p>g. In the Mapping field name section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket from the Mapping field name drop-down menu. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field, select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field, select the EDP_GITTAG variable that defines a tag assigned to the commit in GitHub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the application to the Applications list.</p> <p>Note</p> <p>After the complete adding of the application, inspect the Application Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-infrastructure/#advanced-settings-menu","title":"Advanced Settings Menu","text":""},{"location":"user-guide/add-infrastructure/#related-articles","title":"Related Articles","text":"<ul> <li>Application Overview</li> <li>Add CD Pipelines</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Enable VCS Import Strategy</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-library/","title":"Add Library","text":"<p>Portal helps to create, clone and import a library and add it to the environment. It can also be deployed in Gerrit (if the Clone or Create strategy is used) with the Code Review and Build pipelines built in Jenkins/Tekton.</p> <p>To add a library, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Library and choose one of the strategies which will be described later in this page. You can create a library in YAML or via the two-step menu in the dialog.</p> <p> Create new component menu </p>"},{"location":"user-guide/add-library/#create-library-in-yaml","title":"Create Library in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Library dialog to open the YAML editor and create the Library.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Application dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-library/#create-library-via-ui","title":"Create Library via UI","text":"<p>The Create Library dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-library/#the-codebase-info-menu","title":"The Codebase Info Menu","text":"<ol> <li> <p>The Create new component menu should look like the following:</p> <p> Create new component menu </p> </li> <li> <p>In the Create new component menu, select the necessary configuration strategy. The choice will define the parameters you will need to specify:</p> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with a library language, a build tool, and a framework.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> </li> </ul> <ul> <li> <p>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well:</p> <p> Clone library </p> <p>In our example, we will use the Create from template strategy:</p> <p> Create library </p> <ol> <li>While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code></li> <li>Type the name of the library in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</li> <li>Type the library description.</li> <li>To create a library with an empty repository in Gerrit, select the Empty project check box. The empty repository option is available only for the Create from template strategy.</li> <li> <p>Select any of the supported code languages with its framework in the Library code language field:</p> <ul> <li>Java \u2013 selecting specific Java version available.</li> <li>JavaScript - selecting JavaScript allows using the NPM tool.</li> <li>Python - selecting Python allows using the Python v.3.8, FastAPI, Flask.</li> <li>Groovy-pipeline - selecting Groovy-pipeline allows having the ability to customize a stages logic. For details,   please refer to the Customize CD Pipeline page.</li> <li>Terraform - selecting Terraform allows using the Terraform different versions via the Terraform version manager (tfenv).   EDP supports all actions available in Terraform, thus providing the ability to modify the virtual infrastructure and launch some checks with the help of linters.   For details, please refer to the Use Terraform Library in EDP page.</li> <li>Rego - this option allows using Rego code language with an Open Policy Agent (OPA) Library. For details, please   refer to the Use Open Policy Agent page.</li> <li>Container - this option allows using the Kaniko tool for building the container images from a Dockerfile. For details, please refer to the CI Pipeline for Container page.</li> <li>Helm - this option allows using the chart testing lint (Pipeline) for Helm charts or using Helm chart as a set of other Helm charts organized according to the example.</li> <li>C# - selecting C# allows using .Net v.3.1 and .Net v.6.0.</li> <li>Other - selecting Other allows extending the default code languages when creating a codebase with the Clone/Import strategy. To add another code language, inspect the Add Other Code Language page.</li> </ul> <p>Note</p> <p>The Create strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select necessary Language version/framework depending on the Library code language field.</p> </li> <li> <p>The Select Build Tool field disposes of the default tools and can be changed in accordance with the selected code language.</p> </li> </ol> </li> </ul> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol>"},{"location":"user-guide/add-library/#the-advanced-settings-menu","title":"The Advanced Settings Menu","text":"<p>The Advanced Settings menu should look like the picture below:</p> <p> Advanced settings </p> <p>a. Specify the name of the default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default: Using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li>edp: Using the edp versioning type, a developer indicates the version number from which all the artifacts will be versioned and, as a result, automatically registered in the corresponding file (e.g. pom.xml).</li> </ul> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> EDP versioning </p> <p>Type the version number from which you want the artifacts to be versioned.</p> <p>Note</p> <p>The Start Version From field should be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code></p> <p> Integrate with Jira server </p> <p>d. Select the Integrate with Jira server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. As soon as the Jira server is set, select it in the Jira Server field.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira.</p> <p> Mapping fields </p> <p>g. In the Advanced Mapping section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field select the EDP_GITTAGvariable that defines a tag assigned to the commit in Git Hub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the library to the Libraries list.</p> <p>Note</p> <p>After the complete adding of the library, inspect the Library Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-library/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Libraries</li> <li>Add CD Pipeline</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-marketplace/","title":"Add Component via Marketplace","text":"<p>With the built-in Marketplace, users can easily create a new application by clicking several buttons. This page contains detailed guidelines on how to create a new component with the help of the Marketplace feature.</p>"},{"location":"user-guide/add-marketplace/#add-component","title":"Add Component","text":"<p>To create a component from template, follow the instructions below:</p> <ol> <li> <p>Navigate to the Marketplace section on the navigation bar to see the Marketplace overview page.</p> </li> <li> <p>Click the component name to open its details window and click Create from template:</p> <p> Create from template </p> </li> <li> <p>Fill in the required fields and click Apply:</p> <p> Creating from template window </p> </li> <li> <p>As a result, new component will appear in the Components section:</p> <p> Creating from template window </p> </li> </ol>"},{"location":"user-guide/add-marketplace/#related-articles","title":"Related Articles","text":"<ul> <li>Marketplace Overview</li> <li>Add Application</li> <li>Add Library</li> <li>Add Infrastructure</li> </ul>"},{"location":"user-guide/add-quality-gate/","title":"Add Quality Gate","text":"<p>This section describes how to use quality gate in EDP and how to customize the quality gate for the CD pipeline with the selected build version of the promoted application between stages.</p>"},{"location":"user-guide/add-quality-gate/#apply-new-quality-gate-to-pipelines","title":"Apply New Quality Gate to Pipelines","text":"<p>Quality gate pipeline is a usual Tekton pipeline but with a specific label: <code>app.edp.epam.com/pipelinetype: deploy</code>. To add and apply the quality gate to your pipelines, follow the steps below:</p> <p>1. To use the Tekton pipeline as a quality gate pipeline, add this label to the pipelines:     <pre><code>metadata:\n  labels:\n    app.edp.epam.com/pipelinetype: deploy\n</code></pre>   2. Insert the  value that is the quality gate name displayed in the quality gate drop-down list of the CD pipeline menu:     <pre><code>metadata:\n  name: &lt;name-of-quality-gate&gt;\n</code></pre>   3. Ensure the task <code>promote-images</code> contains steps and logic to apply to the project. Also ensure that the last task is <code>promote-images</code> which parameters are mandatory.     <pre><code>spec:\n  params:\n    - default: ''\n      description: Codebases with a tag separated with a space.\n      name: CODEBASE_TAG\n      type: string\n    - default: ''\n      name: CDPIPELINE_CR\n      type: string\n    - default: ''\n      name: CDPIPELINE_STAGE\n      type: string\n  tasks:\n    - name: promote-images\n      params:\n        - name: CODEBASE_TAG\n          value: $(params.CODEBASE_TAG)\n        - name: CDPIPELINE_STAGE\n          value: $(params.CDPIPELINE_STAGE)\n        - name: CDPIPELINE_CR\n          value: $(params.CDPIPELINE_CR)\n      runAfter:\n        - &lt;last-task-name&gt;\n      taskRef:\n        kind: Task\n        name: promote-images\n</code></pre>   4. Create a new pipeline with a unique name or modify your created pipeline with the command below. Please be aware that the \u2039edp-project\u203a value is the name of the EDP tenant:       <pre><code>kubectl apply -f &lt;file&gt;.yaml -namespace \u2039edp-project\u203a\n</code></pre> Example: file.yaml <pre><code> apiVersion: tekton.dev/v1beta1\n kind: Pipeline\n metadata:\n   labels:\n     app.edp.epam.com/pipelinetype: deploy\n   name: &lt;name-of-quality-gate&gt;\n   namespace: edp\n spec:\n   params:\n     - default: &gt;-\n         https://&lt;CI-pipeline-provisioner&gt;-edp.&lt;cluster-name&gt;.aws.main.edp.projects.epam.com/#/namespaces/$(context.pipelineRun.namespace)/pipelineruns/$(context.pipelineRun.name)\n       name: pipelineUrl\n       type: string\n     - default: ''\n       description: Codebases with a tag separated with a space.\n       name: CODEBASE_TAG\n       type: string\n     - default: ''\n       name: CDPIPELINE_CR\n       type: string\n     - default: ''\n       name: CDPIPELINE_STAGE\n       type: string\n   tasks:\n     - name: autotests\n       params:\n         - name: BASE_IMAGE\n           value: bitnami/kubectl:1.25.4\n         - name: EXTRA_COMMANDS\n           value: echo \"Hello World\"\n       taskRef:\n         kind: Task\n         name: run-quality-gate\n     - name: promote-images\n       params:\n         - name: CODEBASE_TAG\n           value: $(params.CODEBASE_TAG)\n         - name: CDPIPELINE_STAGE\n           value: $(params.CDPIPELINE_STAGE)\n         - name: CDPIPELINE_CR\n           value: $(params.CDPIPELINE_CR)\n       runAfter:\n         - autotests\n       taskRef:\n         kind: Task\n         name: promote-images\n</code></pre>"},{"location":"user-guide/add-quality-gate/#run-quality-gate","title":"Run Quality Gate","text":"<p>Before running the quality gate, first of all, ensure that the environment has deployed the created CD pipeline and then ensure that the application is successfully deployed and ready to run the quality gate. To run quality gate, please follow the steps below:</p> <ol> <li> <p>Check the CD pipeline status. To do this, open the created CD pipeline, select <code>Image stream version</code>, click <code>DEPLOY</code> button and wait until <code>Applications</code>, <code>Health</code> and <code>Sync</code> statuses become <code>green</code>. This implies that the application is successfully deployed and ready to run the quality gate.</p> <p> CD pipeline stage overview </p> </li> <li> <p>Select the <code>&lt;name-of-quality-gate&gt;</code> of <code>Quality gates</code> from the drop-down list and click the <code>RUN</code> button.The execution process should be started in the <code>Pipelines</code> menu:</p> <p> Quality gate pipeline status </p> </li> </ol>"},{"location":"user-guide/add-quality-gate/#add-stage-for-quality-gate","title":"Add Stage for Quality Gate","text":"<p>For a better understanding of this section, please read the documentation about how to add a new stage for quality gate. The scheme below illustrates two approaches of adding quality gates:</p> <p> Types of adding quality gate </p> <ul> <li>The first type of adding a quality gate is about adding the specific quality gate to the specific pipeline stage.</li> </ul> <ul> <li>The second type is rather optional and implies activating the <code>Promote in pipelines</code> option while creating a CD Pipeline to pass the quality gate in a certain sequence.</li> </ul> <p>As a result, after the quality gate is successfully passed, the projected image is promoted to the next stage.</p>"},{"location":"user-guide/add-quality-gate/#related-articles","title":"Related Articles","text":"<ul> <li>Add CD Pipeline</li> </ul>"},{"location":"user-guide/application/","title":"Manage Applications","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing applications.</p>"},{"location":"user-guide/application/#check-and-remove-application","title":"Check and Remove Application","text":"<p>As soon as the application is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this application. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>The added application will be listed in the Applications list allowing you to do the following:</p> <p> Applications menu </p> <ul> <li>Application status - displays the Git Server status. Can be red or green depending on if the EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> <li>Application name (clickable) - displays the Git Server name set during the Git Server creation.</li> <li>Open documentation - opens the documentation that leads to this page.</li> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> <li>Create new application - displays the Create new component menu.</li> <li>Edit application - edit the application by selecting the options icon next to its name in the applications list, and then selecting Edit. For details see the Edit Existing Application section.</li> <li> <p>Delete application - remove application by selecting the options icon next to its name in the applications list, and then selecting Delete.</p> <p>Note</p> <p>The application that is used in a CD pipeline cannot be removed.</p> </li> </ul> <p>There are also options to sort the applications:</p> <ul> <li>Sort the existing applications in a table by clicking the sorting icons in the table header. Sort the applications alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the applications by their status: Created, Failed, or In progress.</li> </ul> <ul> <li> <p>Select a number of applications displayed per page (15, 25 or 50 rows) and navigate between pages if the number of applications exceeds the capacity of a single page:</p> <p> Applications pages </p> </li> </ul>"},{"location":"user-guide/application/#edit-existing-application","title":"Edit Existing Application","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for applications.</p> <ol> <li> <p>To edit an application directly from the Applications overview page or when viewing the application data:</p> <ul> <li>Select Edit in the options icon menu:</li> </ul> <p> Edit application on the Applications overview page </p> <p> Edit application when viewing the application data </p> <ul> <li>The Edit Application dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, in the Edit Application dialog do the following:</p> <p> Edit application </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h of the Add Application page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. (Optional) Enable commit validation mechanism by navigating to Jenkins/Tekton and adding the commit-validate stage in the Code Review pipeline to have your commits reviewed.</p> </li> <li> <p>To disable Jira integration, in the Edit Application dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. (Optional) Disable commit validation mechanism by navigating to Jenkins/Tekton and removing the commit-validate stage in the Code Review pipeline to have your commits reviewed.</p> </li> <li> <p>To create, edit and delete application branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/application/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/autotest/","title":"Manage Autotests","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing autotests.</p>"},{"location":"user-guide/autotest/#check-and-remove-autotest","title":"Check and Remove Autotest","text":"<p>As soon as the autotest is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this autotest. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>Info</p> <p>To navigate quickly to OpenShift, Jenkins/Tekton, Gerrit, SonarQube, Nexus, and other resources, click the Overview section on the navigation bar and hit the necessary link.</p> <p>The added autotest will be listed in the Autotests list allowing you to do the following:</p> <p> Autotests page </p> <ul> <li>Autotest status - displays the Git Server status. Can be red or green depending on EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> </ul> <ul> <li>Autotest name (clickable) - displays the Git Server name set during the Git Server creation.</li> </ul> <ul> <li>Open documentation - opens the documentation that leads to this page.</li> </ul> <ul> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> </ul> <ul> <li>Create new autotest - displays the Create new component menu.</li> </ul> <ul> <li>Edit autotest - edit the autotest by selecting the options icon next to its name in the autotests list, and then selecting Edit. For details see the Edit Existing Autotest section.</li> </ul> <ul> <li> <p>Delete autotest - remove autotest with the corresponding database and Jenkins/Tekton pipelines by selecting the options icon next to its name in the Autotests list, and then selecting Delete:</p> <p>Note</p> <p>The autotest that is used in a CD pipeline cannot be removed.</p> </li> </ul> <p>There are also options to sort the applications:</p> <ul> <li>Sort the existing autotests in a table by clicking the sorting icons in the table header. Sort the autotests alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the autotests by their status: Created, Failed, or In progress.</li> </ul> <ul> <li>Select a number of autotests displayed per page (15, 25 or 50 rows)  and navigate between pages if the number of autotests exceeds the capacity of a single page.</li> </ul>"},{"location":"user-guide/autotest/#edit-existing-autotest","title":"Edit Existing Autotest","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for autotests.</p> <ol> <li> <p>To edit an autotest directly from the Autotests overview page or when viewing the autotest data:</p> <ul> <li> <p>Select Edit in the options icon menu:</p> <p> Edit autotest on the autotests overview page </p> <p> Edit autotest when viewing the autotest data </p> </li> </ul> <ul> <li>The Edit Autotest dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, on the Edit Autotest page do the following:</p> <p> Edit library </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h on the Add Autotests page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and add the create-jira-issue-metadata stage in the Build pipeline. Also add the commit-validate stage in the Code Review pipeline.</p> <p>Note</p> <p>Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration and Adjust VCS Integration With Jira pages.</p> </li> <li> <p>To disable Jira integration, in the Edit Autotest dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and remove the create-jira-issue-metadata stage in the Build pipeline. Also remove the commit-validate stage in the Code Review pipeline.</p> <p>As a result, the necessary changes will be applied.</p> </li> <li> <p>To create, edit and delete application branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/autotest/#add-autotest-as-a-quality-gate","title":"Add Autotest as a Quality Gate","text":"<p>In order to add an autotest as a quality gate to a newly added CD pipeline, do the following:</p> <ol> <li> <p>Create a CD pipeline with the necessary parameters. Please refer to the Add CD Pipeline section for the details.</p> </li> <li> <p>In the Stages menu, select the Autotest quality gate type. It means the promoting process should be confirmed by the successful passing of the autotests.</p> </li> <li> <p>In the additional fields, select the previously created autotest name and specify its branch.</p> </li> <li> <p>After filling in all the necessary fields, click the Create button to start the provisioning of the pipeline. After the CD pipeline is added, the new namespace containing the stage name will be created in Kubernetes (in OpenShift, a new project will be created) with the following name pattern: [cluster name]-[cd pipeline name]-[stage name].</p> </li> </ol>"},{"location":"user-guide/autotest/#configure-autotest-launch-at-specific-stage","title":"Configure Autotest Launch at Specific Stage","text":"<p>In order to configure the added autotest launch at the specific stage with necessary parameters, do the following:</p> <ol> <li> <p>Add the necessary stage to the CD pipeline. Please refer to the Add CD Pipeline documentation for the details.</p> </li> <li> <p>Navigate to the run.json file and add the stage name and the specific parameters.</p> </li> </ol>"},{"location":"user-guide/autotest/#launch-autotest-locally","title":"Launch Autotest Locally","text":"<p>There is an ability to run the autotests locally using the IDEA (Integrated Development Environment Application, such as IntelliJ, NetBeans etc.). To launch the autotest project for the local verification, perform the following steps:</p> <ol> <li> <p>Clone the project to the local machine.</p> </li> <li> <p>Open the project in IDEA and find the run.json file to copy out the necessary command value.</p> </li> <li> <p>Paste the copied command value into the Command line field and run it with the necessary values and namespace.</p> </li> <li> <p>As a result, all the launched tests will be executed.</p> </li> </ol>"},{"location":"user-guide/autotest/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotests</li> <li>Add CD Pipeline</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/build-pipeline/","title":"Build Pipeline","text":"<p>This section provides details on the Build pipeline of the EDP CI/CD pipeline framework. Explore below the pipeline purpose, stages and possible actions to perform.</p>"},{"location":"user-guide/build-pipeline/#build-pipeline-purpose","title":"Build Pipeline Purpose","text":"<p>The purpose of the Build pipeline contains the following points:</p> <ul> <li>Check out, test, tag and build an image from the mainstream branch after a patch set is submitted in order to inspect whether the integrated with the mainstream code fits all quality gates, can be built and tested;</li> <li>Be triggered if any new patch set is submitted;</li> <li>Tag a specific commit in Gerrit in case the build is successful;</li> <li>Build a Docker image with an application that can be afterward deployed using the Jenkins Deploy pipeline.</li> </ul> <p>Find below the functional diagram of the Build pipeline with the default stages:</p> <pre><code>---\ntitle: gitlab-gradle-java17-app-build-edp\n---\nflowchart TD\n   build --&gt; get-nexus-repository-url\n   compile --&gt; test\n   start([fa:fa-circle]) --&gt; fetch-repository\n   fetch-repository --&gt; init-values\n   get-nexus-repository-url --&gt; push\n   get-version --&gt; update-build-number\n   git-tag --&gt; update-cbis\n   init-values --&gt; get-version\n   kaniko-build --&gt; git-tag\n   push --&gt; kaniko-build\n   sast --&gt; compile\n   sonar --&gt; build\n   test --&gt; sonar\n   update-build-number --&gt; sast\n   update-cbis --&gt; stop([fa:fa-circle])</code></pre>"},{"location":"user-guide/build-pipeline/#build-pipeline-for-application-and-library","title":"Build Pipeline for Application and Library","text":"<p>The Build pipeline is triggered automatically after the Code Review pipeline is completed and the changes are submitted.</p> <p>To review the Build pipeline, take the following steps:</p> <ol> <li> <p>Open Jenkins via the created link in Gerrit or via the Admin Console Overview page.</p> </li> <li> <p>Click the Build pipeline link to open its stages for the application and library codebases:</p> <ul> <li>Init - initialization of the Code Review pipeline inputs;</li> </ul> <ul> <li>Checkout - checkout of the application code;</li> </ul> <ul> <li>Get-version - get the version from the pom.XML file and add the build number;</li> </ul> <ul> <li>Compile - code compilation;</li> </ul> <ul> <li>Tests - tests execution;</li> </ul> <ul> <li>Sonar - Sonar launch that checks the whole code;</li> </ul> <ul> <li>Build - artifact building and adding to Nexus;</li> </ul> <ul> <li>Build-image - docker image building and adding to Docker Registry. The Build pipeline for the library has the same stages as the application except the Build-image stage, i.e. the Docker image is not building.</li> </ul> <ul> <li>Push - artifact docker image pushing to Nexus and Docker Registry;</li> </ul> <ul> <li>Ecr-to-docker - the docker image, after being built, is copied from the ECR project registry to DockerHub via the Crane tool. The stage is not the default and can be set for the application codebase type.   To set this stage, please refer to the EcrToDocker.groovy file and to the Promote Docker Images From ECR to Docker Hub page.</li> </ul> <ul> <li>Git-tag - adding of the corresponding Git tag of the current commit to relate with the image, artifact, and build version.</li> </ul> </li> </ol> <p>Note</p> <p>For more details on stages, please refer to the Pipeline Stages documentation.</p> <p>After the Build pipeline runs all the stages successfully, the corresponding tag numbers will be created in Kubernetes/OpenShift and Nexus.</p>"},{"location":"user-guide/build-pipeline/#check-the-tag-in-kubernetesopenshift-and-nexus","title":"Check the Tag in Kubernetes/OpenShift and Nexus","text":"<ol> <li> <p>After the Build pipeline is completed, check the tag name and the same with the commit revision. Simply navigate to Gerrit \u2192 Projects \u2192 List \u2192 select the project \u2192 Tags.</p> <p>Note</p> <p>For the Import strategy, navigate to the repository from which a codebase is imported \u2192 Tags. It is actual both for GitHub and GitLab.</p> </li> <li> <p>Open the Kubernetes/OpenShift Overview page and click the link to Nexus and check the build of a new version.</p> </li> <li> <p>Switch to Kubernetes \u2192 CodebaseImageStream (or OpenShift \u2192 Builds \u2192 Images) \u2192 click the image stream that will be used for deployment.</p> </li> <li> <p>Check the corresponding tag.</p> </li> </ol>"},{"location":"user-guide/build-pipeline/#configure-and-start-pipeline-manually","title":"Configure and Start Pipeline Manually","text":"<p>The Build pipeline can be started manually. To set the necessary stages and trigger the pipeline manually, take the following steps:</p> <ol> <li> <p>Open the Build pipeline for the created library.</p> </li> <li> <p>Click the Build with parameters option from the left-side menu. Modify the stages by removing the whole objects massive:{\"name\". \"tests\"} where name is a key and tests is a stage name that should be executed.</p> </li> <li> <p>Open Jenkins and check the successful execution of all stages.</p> </li> </ol>"},{"location":"user-guide/build-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Autotest as Quality Gate</li> <li>Pipeline Stages</li> </ul>"},{"location":"user-guide/cd-pipeline-details/","title":"CD Pipeline Details","text":"<p>CD Pipeline (Continuous Delivery Pipeline) - an EDP business entity that describes the whole delivery process of the selected application set via the respective stages. The main idea of the CD pipeline is to promote the application build version between the stages by applying the sequential verification (i.e. the second stage will be available if the verification on the first stage is successfully completed). The CD pipeline can include the essential set of applications with its specific stages as well.</p> <p>In other words, the CD pipeline allows the selected image stream (Docker container in Kubernetes terms) to pass a set of stages for the verification process (SIT - system integration testing with the automatic type of a quality gate, QA - quality assurance, UAT - user acceptance testing with the manual testing).</p> <p>Note</p> <p>It is possible to change the image stream for the application in the CD pipeline. Please refer to the Edit CD Pipeline section for the details.</p> <p>A CI/CD pipeline helps to automate steps in a software delivery process, such as the code build initialization, automated tests running, and deploying to a staging or production environment. Automated pipelines remove manual errors, provide standardized development feedback cycle, and enable the fast product iterations. To get more information on the CI pipeline, please refer to the CI Pipeline Details chapter.</p> <p>The codebase stream is used as a holder for the output of the stage, i.e. after the Docker container (or an image stream in OpenShift terms) passes the stage verification, it will be placed to the new codebase stream. Every codebase has a branch that has its own codebase stream - a Docker container that is an output of the build for the corresponding branch.</p> <p>Note</p> <p>For more information on the main terms used in EPAM Delivery Platform, please refer to the EDP Glossary</p> <p> EDP CD pipeline </p> <p>Explore the details of the CD pipeline below.</p>"},{"location":"user-guide/cd-pipeline-details/#deploy-pipeline","title":"Deploy Pipeline","text":"<p>The Deploy pipeline is used by default on any stage of the Continuous Delivery pipeline. It addresses the following concerns:</p> <ul> <li>Deploying the application(s) to the main STAGE (SIT, QA, UAT) environment in order to run autotests and to promote image build versions to the next environments afterwards.</li> <li>Deploying the application(s) to a custom STAGE environment in order to run autotests and check manually that everything is ok with the application.</li> <li>Deploying the latest or a stable and some particular numeric version of an image build that exists in Docker registry.</li> <li>Promoting the image build versions from the main STAGE (SIT, QA, UAT) environment.</li> <li>Auto deploying the application(s) version from the passed payload (using the CODEBASE_VERSION job parameter).</li> </ul> <p>Find below the functional diagram of the Deploy pipeline with the default stages:</p> <p>Note</p> <p>The input for a CD pipeline depends on the Trigger Type for a deploy stage and can be either Manual or Auto.</p> <p> Deploy pipeline stages </p>"},{"location":"user-guide/cd-pipeline-details/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add CD Pipeline</li> <li>Add Library</li> <li>CI Pipeline Details</li> <li>CI/CD Overview</li> <li>EDP Glossary</li> <li>EDP Pipeline Framework</li> <li>EDP Pipeline Stages</li> <li>Prepare for Release</li> </ul>"},{"location":"user-guide/ci-pipeline-details/","title":"CI Pipeline Details","text":"<p>CI Pipeline (Continuous Integration Pipeline) - an EDP business entity that describes the integration of changes made to a codebase into a single project. The main idea of the CI pipeline is to review the changes in the code submitted through a Version Control System (VCS) and build a new codebase version so that it can be transmitted to the Continuous Delivery Pipeline for the rest of the delivery process.</p> <p>There are three codebase types in EPAM Delivery Platform:</p> <ol> <li>Applications - a codebase that is developed in the Version Control System, has the full lifecycle starting from the Code Review stage to its deployment to the environment;</li> <li>Libraries - this codebase is similar to the Application type, but it is not deployed and stored in the Artifactory. The library can be connected to other applications/libraries;</li> <li>Autotests - a codebase that inspects the code and can be used as a quality gate for the CD pipeline stage. The autotest only has the Code Review pipeline and is launched for the stage verification.</li> </ol> <p>Note</p> <p>For more information on the above mentioned codebase types, please refer to the Add Application, Add Library, Add Autotests and Autotest as Quality Gate pages.</p> <p> EDP CI pipeline </p>"},{"location":"user-guide/ci-pipeline-details/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Autotest as Quality Gate</li> <li>Build Pipeline</li> <li>Code Review Pipeline</li> <li>Pipeline Stages</li> </ul>"},{"location":"user-guide/cicd-overview/","title":"EDP CI/CD Overview","text":"<p>This chapter provides information on CI/CD basic definitions and flow, as well as its components and process.</p>"},{"location":"user-guide/cicd-overview/#cicd-basic-definitions","title":"CI/CD Basic Definitions","text":"<p>The Continuous Integration part means the following:</p> <ul> <li>all components of the application development are in the same place and perform the same processes for running;</li> <li>the results are published in one place and replicated into EPAM GitLab or VCS (version control system);</li> <li>the repository also includes a storage tool (e.g. Nexus) for all binary artifacts that are produced by the Jenkins CI server after submitting changes from Code Review tool into VCS;</li> </ul> <p>The <code>Code Review</code> and <code>Build</code> pipelines are used before the code is delivered. An important part of both of them is the integration tests that are launched during the testing stage.</p> <p>Many applications (SonarQube, Gerrit, etc,) used by the project need databases for their performance.</p> <p>The Continuous Delivery comprises an approach allowing to produce an application in short cycles so that it can be reliably released at any time point. This part is tightly bound with the usage of the <code>Code Review</code>, <code>Build</code>, and <code>Deploy</code> pipelines.</p> <p>The <code>Deploy</code> pipelines deploy the applications configuration and their specific versions, launch automated tests and control quality gates for the specified environment. As a result of the successfully completed process, the specific versions of images are promoted to the next environment. All environments are sequential and promote the build versions of applications one-by-one. The logic of each stage is described as a code of Jenkins pipelines and stored in the VCS.</p> <p>During the CI/CD, there are several continuous processes that run in the repository, find below the list of possible actions:</p> <ul> <li>Review the code with the help of Gerrit tool;</li> <li>Run the static analysis using SonarQube to control the quality of the source code and keep the historical data which helps to understand the trend and effectivity of particular teams and members;</li> <li>Analyze application source code using SAST, byte code, and binaries for coding/design conditions that are indicative of security vulnerabilities;</li> <li>Build the code with Jenkins and run automated tests that are written to make sure the applied changes will not break any functionality.</li> </ul> <p>Note</p> <p>For the details on autotests, please refer to the Autotest, Add Autotest, and Autotest as Quality Gate pages.</p> <p>The release process is divided into cycles and provides regular delivery of completed pieces of functionality while continuing the development and integration of new functionality into the product mainline.</p> <p>Explore the main flow that is displayed on the diagram below:</p> <p> EDP CI/CD pipeline </p>"},{"location":"user-guide/cicd-overview/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add CD Pipeline</li> <li>CI Pipeline Details</li> <li>CD Pipeline Details</li> <li>Customize CI Pipeline</li> <li>EDP Pipeline Framework</li> <li>Customize CD Pipeline</li> <li>EDP Stages</li> <li>Glossary</li> <li>Use Terraform Library in EDP</li> </ul>"},{"location":"user-guide/cluster/","title":"Manage Clusters","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing clusters.</p> <p>In a nutshell, cluster in EDP Portal is a Kubernetes secret that stores credentials and endpoint to connect to the another cluster. Adding new clusters allows users to deploy applications in several clusters, thus improving flexibility of your infrastructure.</p> <p>The added cluster will be listed in the clusters list allowing you to do the following:</p> <p> Clusters list </p>"},{"location":"user-guide/cluster/#view-authentication-data","title":"View Authentication Data","text":"<p>To view authentication data that is used to log in to the cluster, run the <code>kubectl describe</code> command:</p> <pre><code>kubectl describe secret cluster_name -n edp\n</code></pre>"},{"location":"user-guide/cluster/#delete-cluster","title":"Delete Cluster","text":"<p>To delete cluster, use the <code>kubectl delete</code> command as follows:</p> <pre><code>kubectl delete secret cluster_name -n edp\n</code></pre>"},{"location":"user-guide/cluster/#related-articles","title":"Related Articles","text":"<ul> <li>Add Cluster</li> <li>Add Application</li> </ul>"},{"location":"user-guide/code-review-pipeline/","title":"Code Review Pipeline","text":"<p>This section provides details on the Code Review pipeline of the EDP CI/CD framework. Explore below the pipeline purpose, stages and possible actions to perform.</p>"},{"location":"user-guide/code-review-pipeline/#code-review-pipeline-purpose","title":"Code Review Pipeline Purpose","text":"<p>The purpose of the Code Review pipeline contains the following points:</p> <ul> <li>Check out and test a particular developer's change (Patch Set) in order to inspect whether the code fits all the quality gates and can be built and tested;</li> <li>Be triggered if any new Patch Set appears in Gerrit;</li> <li>Send feedback about the build process in Jenkins to review the card in Gerrit;</li> <li>Send feedback about Sonar violations that have been found during the Sonar stage.</li> </ul> <p>Find below the functional diagram of the Code Review pipeline with the default stages:</p> <pre><code>---\ntitle: gitlab-gradle-java17-app-review\n---\nflowchart TD\n   build --&gt; dockerbuild-verify\n   compile --&gt; test\n   dockerbuild-verify --&gt; stop([fa:fa-circle])\n   dockerfile-lint --&gt; dockerbuild-verify\n   fetch-repository --&gt; init-values\n   fetch-repository --&gt; helm-docs\n   fetch-repository --&gt; dockerfile-lint\n   fetch-repository --&gt; helm-lint\n   helm-docs --&gt; stop([fa:fa-circle])\n   helm-lint --&gt; stop([fa:fa-circle])\n   init-values --&gt; compile\n   start([fa:fa-circle]) --&gt; report-pipeline-start-to-gitlab\n   report-pipeline-start-to-gitlab --&gt; fetch-repository\n   sonar --&gt; build\n   test --&gt; sonar</code></pre>"},{"location":"user-guide/code-review-pipeline/#code-review-pipeline-for-applications-and-libraries","title":"Code Review Pipeline for Applications and Libraries","text":"<p>Note</p> <p>Make sure the necessary applications or libraries are added to the Admin Console. For the details on how to add a codebase, please refer to the Add Application or Add Library pages accordingly.</p> <p>To discover the Code Review pipeline, apply changes that will trigger the Code Review pipeline automatically and take the following steps:</p> <ol> <li> <p>Navigate to Jenkins. In Admin Console, go to the Overview section on the left-side navigation bar and click the link to Jenkins.</p> <p> Link to Jenkins </p> <p>or</p> <p>In Gerrit, go to the Patch Set page and click the CI Jenkins link in the Change Log section</p> <p> Link from Gerrit </p> <p>Note</p> <p>The Code Review pipeline starts automatically for every codebase type (Application, Autotests, Library).</p> </li> <li> <p>Check the Code Review pipeline for the application of for the library. Click the application name in Jenkins and switch to the additional release-01 branch that is created with the respective Code Review and Build pipelines.</p> </li> <li> <p>Click the Code Review pipeline link to open the Code Review pipeline stages for the application:</p> <ul> <li>Init - initialization of the codebase information and loading of the common libraries</li> <li>gerrit-checkout / checkout - the checkout of patch sets from Gerrit. The stage is called gerrit-checkout for the Create and Clone strategies of adding a codebase and checkout for the Import strategy.</li> <li>compile - the source code compilation</li> <li>tests - the launch of the tests</li> <li>sonar - the launch of the static code analyzer that checks the whole code</li> <li>helm-lint - the launch of the linting tests for deployment charts</li> <li>dockerfile-lint - the launch of the linting tests for Dockerfile</li> <li>commit-validate - the stage is optional and appears under enabled integration with Jira. Please refer to the Adjust Jira Integration and Adjust VCS Integration With Jira sections for the details.</li> </ul> </li> </ol> <p>Note</p> <p>For more details on EDP pipeline stages, please refer to the Pipeline Stages section.</p>"},{"location":"user-guide/code-review-pipeline/#code-review-pipeline-for-autotests","title":"Code Review Pipeline for Autotests","text":"<p>To discover the Code Review pipeline for autotests, first, apply changes to a codebase that will trigger the Code Review pipeline automatically. The flow for the autotest is similar for that for applications and libraries, however, there are some differences. Explore them below.</p> <ol> <li> <p>Open the run.json file for the created autotest.</p> <p>Note</p> <p>Please refer to the Add Autotest page for the details on how to create an autotest.</p> <p>The run.json file keeps a command that is executed on this stage.</p> </li> <li> <p>Open the Code Review pipeline in Jenkins (via the link in Gerrit or via the Admin Console Overview page) and click the Configure option from the left side. There are only four stages available: Initialization - Gerrit-checkout - tests - sonar (the launch of the static code analyzer that checks the whole code).</p> </li> <li> <p>Open the Code Review pipeline in Jenkins with the successfully passed stages.</p> </li> </ol>"},{"location":"user-guide/code-review-pipeline/#retrigger-code-review-pipeline","title":"Retrigger Code Review Pipeline","text":"<p>The Code Review pipeline can be retriggered manually, especially if the pipeline failed before. To retrigger it, take the following steps:</p> <ol> <li> <p>In Jenkins, click the Retrigger option from the drop-down menu for the specific Code Review pipeline version number. Alternatively, click the Jenkins main page and select the Query and Trigger Gerrit Patches option.</p> </li> <li> <p>Click Search and select the check box of the necessary change and patch set and then click Trigger Selected.</p> </li> </ol> <p>As a result, the Code Review pipeline will be retriggered.</p>"},{"location":"user-guide/code-review-pipeline/#configure-code-review-pipeline","title":"Configure Code Review Pipeline","text":"<p>The Configure option allows adding/removing the stage from the Code Review pipeline if needed. To configure the Code Review pipeline, take the following steps:</p> <ol> <li> <p>Being in Jenkins, click the Configure option from the left-side menu.</p> </li> <li> <p>Define the stages set that will be executed for the current pipeline.</p> <ul> <li>To remove a stage, select and remove the whole objects massive: {\"name\".\"tests\"}, where name is a key and tests is a stage name that should be executed.</li> <li>To add a stage, define the objects massive: {\"name\".\"tests\"}, where name is a key and tests is a stage name that should be added.</li> </ul> <p>Note</p> <p>All stages are launched from the shared library on GitHub. The list of libraries is located in the edp-library-stages repository.</p> </li> <li> <p>To apply the new stage process, retrigger the Code Review pipeline. For details, please refer to the Retrigger Code Review Pipeline section.</p> </li> <li> <p>Open Jenkins and check that there is no removed stage in the Code Review pipeline.</p> </li> </ol>"},{"location":"user-guide/code-review-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Autotest as Quality Gate</li> <li>Pipeline Stages</li> </ul>"},{"location":"user-guide/container-stages/","title":"CI Pipeline for Container","text":"<p>EPAM Delivery Platform ensures the implemented Container support allowing to work with Dockerfile that is processed by means of stages in the Code-Review and Build pipelines. These pipelines are expected to be created after the Container Library is added.</p>"},{"location":"user-guide/container-stages/#code-review-pipeline-stages","title":"Code Review Pipeline Stages","text":"<p>In the Code Review pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage is a standard step during which all files are checked out from a selected branch of the Git repository.</p> </li> <li> <p>dockerfile-lint stage uses the hadolint tool to perform linting tests for the Dockerfile.</p> </li> <li> <p>dockerbuild-verify stage collects artifacts and builds an image from the Dockerfile without pushing to registry. This stage is intended to check if the image is built.</p> </li> </ol>"},{"location":"user-guide/container-stages/#build-pipeline-stages","title":"Build Pipeline Stages","text":"<p>In the Build pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage is a standard step during which all files are checked out from a master branch of the Git repository.</p> </li> <li> <p>get-version stage where the library version is determined either via:</p> <p>2.1. EDP versioning functionality.</p> <p>2.2. Default versioning functionality.</p> </li> <li> <p>dockerfile-lint stage uses the hadolint tool to perform linting tests for Dockerfile.</p> </li> <li> <p>build-image-kaniko stage builds Dockerfile using the Kaniko tool.</p> </li> <li> <p>git-tag stage that is intended for tagging a repository in Git.</p> </li> </ol>"},{"location":"user-guide/container-stages/#tools-for-container-images-building","title":"Tools for Container Images Building","text":"<p>EPAM Delivery Platform ensures the implemented Kaniko tool and <code>BuildConfig</code> object support. Using Kaniko tool allows building the container images from a Dockerfile both on the Kubernetes and OpenShift platforms. The <code>BuildConfig</code> object enables the building of the container images only on the OpenShift platform.</p> <p>EDP uses the <code>BuildConfig</code> object and the Kaniko tool for creating containers from a Dockerfile and pushing them to the internal container image registry. For Kaniko, it is also possible to change the Docker config file and push the containers to different container image registries.</p>"},{"location":"user-guide/container-stages/#supported-container-image-build-tools","title":"Supported Container Image Build Tools","text":"Platform Build Tools Kubernetes Kaniko OpenShift Kaniko, BuildConfig"},{"location":"user-guide/container-stages/#change-build-tool-in-the-build-pipeline","title":"Change Build Tool in the Build Pipeline","text":"<p>By default, EPAM Delivery Platform uses the <code>build-image-kaniko</code> stage for building container images on the Kubernetes platform and the <code>build-image-from-dockerfile</code> stage for building container images on the OpenShift platform.</p> <p>In order to change a build tool for the OpenShift Platform from the default <code>buildConfig</code> object to the Kaniko tool, perform the following steps:</p> <ol> <li>Modify or update a job provisioner logic, follow the instructions on the Manage Jenkins CI Pipeline Job Provisioner page.</li> <li>Update the required parameters for a new provisioner.    For example, if it is necessary to change the build tool for Container build pipeline, update the list of stages:<pre><code>stages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-from-dockerfile\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n</code></pre> <pre><code>stages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n</code></pre> </li> </ol>"},{"location":"user-guide/container-stages/#related-articles","title":"Related Articles","text":"<ul> <li>Use Dockerfile Linters for Code Review Pipeline</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/copy-shared-secrets/","title":"Copy Shared Secrets","text":"<p>The Copy Shared Secrets stage provides the ability to copy secrets from the current Kubernetes namespace into a namespace created during CD pipeline.</p> <p> Shared secrets </p> <p>Please follow the steps described below to copy the secrets:</p> <ol> <li> <p>Create a secret in the current Kubernetes namespace that should be used in the deployment. The secret label must be <code>app.edp.epam.com/use: cicd</code>, since the pipeline script will attempt to copy the secret by its label. For example:</p> <pre><code>kind: Secret\nmetadata:\nlabels:\napp.edp.epam.com/use: cicd\n</code></pre> </li> <li> <p>Add the following step to the CD pipeline <code>{\"name\":\"copy-secrets\",\"step_name\":\"copy-secrets\"}</code>. Alternatively, it is possible to create a custom job provisioner with this step.</p> </li> <li> <p>Run the job. The pipeline script will create a secret with the same data in the namespace generated by the cd pipeline.</p> <p>Note</p> <p>Service account tokens are not supported.</p> </li> </ol>"},{"location":"user-guide/copy-shared-secrets/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CD Pipeline</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/customize-cd-pipeline/","title":"Customize CD Pipeline","text":"<p>Apart from running CD pipeline stages with the default logic, there is the ability to perform the following:</p> <ul> <li>Create your own logic for stages;</li> <li>Redefine the default EDP stages of a CD pipeline.</li> </ul> <p>In order to have the ability to customize a stage logic, create a CD pipeline stage source as a Library:</p> <ol> <li> <p>Navigate to the Libraries section of the Admin Console and create a library with the Groovy-pipeline code language:</p> <p>Note</p> <p>If you clone the library, make sure that the correct source branch is selected.</p> <p> Create library </p> <p>Select the required fields to build your library:</p> <p> Advanced settings </p> </li> <li> <p>Go to the Continuous Delivery section of the Admin Console and create a CD pipeline with the library stage source and its branch:</p> <p> Library source </p> </li> </ol>"},{"location":"user-guide/customize-cd-pipeline/#add-new-stage","title":"Add New Stage","text":"<p>Follow the steps below to add a new stage:</p> <ul> <li>Clone the repository with the added library;</li> <li>Create a \"stages\" directory in the root;</li> <li>Create a Jenkinsfile with default content:<pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nDeploy()\n</code></pre> </li> </ul> <ul> <li>Create a groovy file with a meaningful name, e.g. NotificationStage.groovy;</li> <li>Put the required construction and your own logic into the file:<pre><code>import com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"notify\")\nclass Notify {\n    Script script\n    void run(context) {\n    --------------- Put your own logic here ------------------\n            script.println(\"Send notification logic\")\n    --------------- Put your own logic here ------------------\n    }\n}\nreturn Notify\n</code></pre> </li> </ul> <ul> <li> <p>Add a new stage to the STAGES parameter of the Jenkins job of your CD pipeline:</p> <p> Stages parameter </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> </li> </ul> <ul> <li>Run the job to check that your new stage has been run during the execution.</li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#redefine-existing-stage","title":"Redefine Existing Stage","text":"<p>By default, the following stages are implemented in EDP pipeline framework:</p> <ul> <li>deploy,</li> <li>deploy-helm,</li> <li>autotests,</li> <li>manual (Manual approve),</li> <li>promote-images.</li> </ul> <p>Using one of these names for annotation in your own class will lead to redefining the default logic with your own.</p> <p>Find below a sample of the possible flow of the redefining deploy stage:</p> <ul> <li>Clone the repository with the added library;</li> <li>Create a \"stages\" directory in the root;</li> <li>Create a Jenkinsfile with default content:<pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nDeploy()\n</code></pre> </li> </ul> <ul> <li>Create a groovy file with a meaningful name, e.g. CustomDeployStage.groovy;</li> <li>Put the required construction and your own logic into the file:<pre><code>import com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"deploy\")\nclass CustomDeployStage {\n    Script script\n\n    void run(context) {\n    --------------- Put your own logic here ------------------\n            script.println(\"Custom deploy stage logic\")\n    --------------- Put your own logic here ------------------\n    }\n}\nreturn CustomDeployStage\n</code></pre> </li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#add-a-new-stage-using-shared-library-via-custom-global-pipeline-libraries","title":"Add a New Stage Using Shared Library via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ul> <li> <p>Navigate to the Libraries section of the Admin Console and create a library with the Groovy-pipeline code language:</p> <p> Create library </p> <p>Select the required fields to build your library:</p> <p> Advanced settings </p> </li> </ul> <ul> <li>Clone the repository with the added library;</li> <li>Create a directory with the name <code>src/com/epam/edp/customStages/impl/cd/impl/</code> in the library repository, for instance: <code>src/com/epam/edp/customStages/impl/cd/impl/EmailNotify.groovy</code>;</li> <li>Add a Groovy file with another name to the same stages catalog, for instance \u2013 <code>EmailNotify.groovy</code>:<pre><code>package com.epam.edp.customStages.impl.cd.impl\n\nimport com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"notify\")\nclass Notify {\n    Script script\n    void run(context) {\n    --------------- Put your own logic here ------------------\n    script.println(\"Send notification logic\")\n    --------------- Put your own logic here ------------------\n   }\n}\n</code></pre> </li> </ul> <ul> <li> <p>Create a Jenkinsfile with default content and the added custom library to Jenkins:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines', 'edp-custom-shared-library-name']) _\n\nDeploy()\n</code></pre> <p>Note</p> <p><code>edp-custom-shared-library-name</code> is the name of your Custom Global Pipeline Library that should be added to the Jenkins Global Settings.</p> </li> </ul> <ul> <li> <p>Add a new stage to the STAGES parameter of the Jenkins job of your CD pipeline:</p> <p> Stages parameter </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> </li> </ul> <ul> <li>Run the job to check that the new stage has been running during the execution.</li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#redefine-a-default-stage-logic-via-custom-global-pipeline-libraries","title":"Redefine a Default Stage Logic via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>By default, the following stages are implemented in EDP pipeline framework:</p> <ul> <li>deploy,</li> <li>deploy-helm,</li> <li>autotests,</li> <li>manual (Manual approve),</li> <li>promote-images.</li> </ul> <p>Using one of these names for annotation in your own class will lead to redefining the default logic with your own.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ul> <li> <p>Navigate to the Libraries section of the Admin Console and create a library with the Groovy-pipeline code language:</p> <p> Create library </p> <p>Select the required fields to build your library:</p> <p> Advanced settings </p> </li> </ul> <ul> <li>Clone the repository with the added library;</li> <li>Create a directory with the name <code>src/com/epam/edp/customStages/impl/cd/impl/</code> in the library repository, for instance: <code>src/com/epam/edp/customStages/impl/cd/impl/CustomDeployStage.groovy;</code>;</li> <li>Add a Groovy file with another name to the same stages catalog, for instance \u2013 <code>CustomDeployStage.groovy</code>:<pre><code>package com.epam.edp.customStages.impl.cd.impl\n\nimport com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"deploy\")\nclass CustomDeployStage {\n    Script script\n\n    void run(context) {\n    --------------- Put your own logic here ------------------\n            script.println(\"Custom deploy stage logic\")\n    --------------- Put your own logic here ------------------\n    }\n}\n</code></pre> </li> </ul> <ul> <li> <p>Create a Jenkinsfile with default content and the added custom library to Jenkins:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines', 'edp-custom-shared-library-name']) _\n\nDeploy()\n</code></pre> <p>Note</p> <p><code>edp-custom-shared-library-name</code> is the name of your Custom Global Pipeline Library that should be added to the Jenkins Global Settings.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> </li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add a New Custom Global Pipeline Library</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/customize-ci-pipeline/","title":"Customize CI Pipeline","text":"<p>This chapter describes the main steps that should be followed when customizing a CI pipeline.</p>"},{"location":"user-guide/customize-ci-pipeline/#redefine-a-default-stage-logic-for-a-particular-application","title":"Redefine a Default Stage Logic for a Particular Application","text":"<p>To redefine any stage and add custom logic, perform the steps below:</p> <ol> <li> <p>Open the GitHub repository:</p> <ul> <li>Create a directory with the name \u201cstages\u201d in the application repository;</li> <li>Create a Groovy file with a meaningful name for a custom stage description, for instance: CustomSonar.groovy.</li> </ul> </li> <li> <p>Paste the copied skeleton from the reference stage and insert the necessary logic.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> <p>The stage logic structure is the following:</p> <p>CustomSonar.groovy</p> <pre><code>import com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY])\nclass CustomSonar {\n    Script script\n    void run(context) {\n        script.sh \"echo 'Your custom logic of the stage'\"\n    }\n}\nreturn CustomSonar\n</code></pre> <p>Info</p> <p>There is the ability to redefine the predefined EDP stage as well as to create it from scratch, it depends on the name that is used in the @Stage annotation. For example, using name = \"sonar\" will redefine an existing sonar stage with the same name, but using name=\"new-sonar\" will create a new stage.</p> <p>By default, the following stages are implemented in EDP:</p> <ul> <li>build</li> <li>build-image-from-dockerfile</li> <li>build-image</li> <li>build-image-kaniko</li> <li>checkout</li> <li>compile</li> <li>create-branch</li> <li>gerrit-checkout</li> <li>get-version</li> <li>git-tag</li> <li>push</li> <li>sonar</li> <li>sonar-cleanup</li> <li>tests</li> <li>trigger-job</li> </ul> <p>Mandatory points:</p> <ul> <li>Importing classes com.epam.edp.stages.impl.ci.ProjectType and com.epam.edp.stages.impl.ci.Stage;</li> <li>Annotating \"Stage\" for class - @Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]);</li> <li>Property with the type \"Script\";</li> <li>Void the \"run\" method with the \"context input parameter\" value;</li> <li>Bring the custom class back to the end of the file: return CustomSonar.</li> </ul> </li> <li> <p>Open Jenkins and make sure that all the changes are correct after the completion of the customized pipeline.</p> </li> </ol>"},{"location":"user-guide/customize-ci-pipeline/#add-a-new-stage-for-a-particular-application","title":"Add a New Stage for a Particular Application","text":"<p>To add a new stage for a particular application, perform the steps below:</p> <ol> <li>In the GitHub repository, add a Groovy file with another name to the same stages catalog.</li> <li> <p>Copy the part of a pipeline framework logic that cannot be predefined;</p> <p>The stage logic structure is the following:</p> <p>EmailNotify.groovy</p> <pre><code>import com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"email-notify\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass EmailNotify {\n    Script script\n    void run(context) {\n        -------------------'Your custom logic here'\n    }\n}\nreturn EmailNotify\n</code></pre> </li> <li> <p>Open the default set of stages and add a new one into the Default Value field by saving the respective type {\"name\": \"email-notify\"}, save the changes:   Add stage </p> </li> <li> <p>Open Jenkins to check the pipeline; as soon as the checkout stage is passed, the new stage will appear in the pipeline:   Check stage </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> </li> </ol>"},{"location":"user-guide/customize-ci-pipeline/#redefine-a-default-stage-logic-via-custom-global-pipeline-libraries","title":"Redefine a Default Stage Logic via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ol> <li> <p>Open the GitHub repository:</p> <ul> <li>Create a directory with the name <code>/src/com/epam/edp/customStages/impl/ci/impl/stageName/</code> in the library repository, for instance: <code>/src/com/epam/edp/customStages/impl/ci/impl/sonar/</code>;</li> <li>Create a Groovy file with a meaningful name for a custom stage description, for instance \u2013 <code>CustomSonar.groovy</code>.</li> </ul> </li> <li> <p>Paste the copied skeleton from the reference stage and insert the necessary logic.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> <p>The stage logic structure is the following:</p> <p>CustomSonar.groovy</p> <pre><code>package com.epam.edp.customStages.impl.ci.impl.sonar\n\nimport com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY])\nclass CustomSonar {\n    Script script\n    void run(context) {\n        script.sh \"echo 'Your custom logic of the stage'\"\n    }\n}\n</code></pre> <p>Info</p> <p>There is the ability to redefine the predefined EDP stage as well as to create it from scratch, it depends on the name that is used in the @Stage annotation. For example, using name = \"sonar\" will redefine an existing sonar stage with the same name, but using name=\"new-sonar\" will create a new stage.</p> <p>By default, the following stages are implemented in EDP:</p> <ul> <li>build</li> <li>build-image-from-dockerfile</li> <li>build-image</li> <li>build-image-kaniko</li> <li>checkout</li> <li>compile</li> <li>create-branch</li> <li>gerrit-checkout</li> <li>get-version</li> <li>git-tag</li> <li>push</li> <li>sonar</li> <li>sonar-cleanup</li> <li>tests</li> <li>trigger-job</li> </ul> <p>Mandatory points:</p> <ul> <li>Defining a package com.epam.edp.customStages.impl.ci.impl.stageName;</li> <li>Importing classes com.epam.edp.stages.impl.ci.ProjectType and com.epam.edp.stages.impl.ci.Stage;</li> <li>Annotating \"Stage\" for class - @Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]);</li> <li>Property with the type \"Script\";</li> <li>Void the \"run\" method with the \"context input parameter\" value.</li> </ul> </li> </ol> <p>3.Open Jenkins and make sure that all the changes are correct after the completion of the customized pipeline.</p>"},{"location":"user-guide/customize-ci-pipeline/#add-a-new-stage-using-shared-library-via-custom-global-pipeline-libraries","title":"Add a New Stage Using Shared Library via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ol> <li> <p>Open the GitHub repository:</p> <ul> <li>Create a directory with the name <code>/src/com/epam/edp/customStages/impl/ci/impl/stageName/</code> in the library repository, for instance: <code>/src/com/epam/edp/customStages/impl/ci/impl/emailNotify/</code>;</li> <li>Add a Groovy file with another name to the same stages catalog, for instance \u2013 <code>EmailNotify.groovy</code>.</li> </ul> </li> <li> <p>Copy the part of a pipeline framework logic that cannot be predefined;</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> <p>The stage logic structure is the following:</p> <p>EmailNotify.groovy</p> <pre><code>package com.epam.edp.customStages.impl.ci.impl.emailNotify\n\nimport com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"email-notify\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass EmailNotify {\n    Script script\n    void run(context) {\n        -------------------'Your custom logic here'\n    }\n}\n</code></pre> </li> <li> <p>Open the default set of stages and add a new one into the Default Value field by saving the respective type {\"name\": \"email-notify\"}, save the changes:   Add stage </p> </li> <li> <p>Open Jenkins to check the pipeline; as soon as the checkout stage is passed, the new stage will appear in the pipeline:   Check stage </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> </li> </ol>"},{"location":"user-guide/customize-ci-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add a New Custom Global Pipeline Library</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Add Security Scanner</li> </ul>"},{"location":"user-guide/dockerfile-stages/","title":"Use Dockerfile Linters for Code Review Pipeline","text":"<p>This section contains the description of dockerbuild-verify, dockerfile-lint stages which one can use in Code Review pipeline.</p> <p>These stages help to obtain a quick response on the validity of the code in the Code Review pipeline in Kubernetes for all types of applications supported by EDP out of the box.</p> <p> Add stages </p> <p>Inspect the functions performed by the following stages:</p> <ol> <li> <p>dockerbuild-verify stage collects artifacts and builds an image from the Dockerfile without push to registry. This stage is intended to check if the image is built.</p> </li> <li> <p>dockerfile-lint stage launches the hadolint command in order to check the Dockerfile.</p> </li> </ol>"},{"location":"user-guide/dockerfile-stages/#related-articles","title":"Related Articles","text":"<ul> <li>Use Terraform Library in EDP</li> <li>EDP Pipeline Framework</li> <li>Promote Docker Images From ECR to Docker Hub</li> <li>CI Pipeline for Container</li> </ul>"},{"location":"user-guide/ecr-to-docker-stages/","title":"Promote Docker Images From ECR to Docker Hub","text":"<p>This section contains the description of the ecr-to-docker stage, available in the Build pipeline.</p> <p>The ecr-to-docker stage is intended to perform the push of Docker images collected from the Amazon ECR cluster storage to Docker Hub repositories, where the image becomes accessible to everyone who wants to use it. This stage is optional and is designed for working with various EDP components.</p> <p>Note</p> <p>When pushing the image from ECR to Docker Hub using crane, the SHA-256 value remains unchanged.</p> <p>To run the ecr-to-docker stage just for once, navigate to the Build with Parameters option, add this stage to the stages list, and click Build.  To add the ecr-to-docker stage to the pipeline, modify the job provisioner.</p> <p>Note</p> <p>To push properly the Docker image from the ECR storage, the ecr-to-docker stage should follow the build-image-kaniko stage. Add custom lib2 </p> <p>The ecr-to-docker stage contains a specific script that launches the following actions:</p> <ol> <li>Performs authorization in AWS ECR in the EDP private storage via awsv2.</li> <li>Performs authorization in the Docker Hub.</li> <li> <p>Checks whether a similar image exists in the Docker Hub in order to avoid its overwriting.</p> <ul> <li>If a similar image exists in the Docker Hub, the script will return the message about it and stop the execution. The ecr-to-docker stage in the Build pipeline will be marked in red.</li> <li>If there is no similar image, the script will proceed to promote the image using crane.</li> </ul> </li> </ol>"},{"location":"user-guide/ecr-to-docker-stages/#create-secret-for-ecr-to-docker-stage","title":"Create Secret for ECR-to-Docker Stage","text":"<p>The ecr-to-docker stage expects the authorization credentials to be added as Kubernetes secret into EDP-installed namespace. To create the dockerhub-credentials secret, run the following command:</p> <pre><code>  kubectl -n edp create secret generic dockerhub-credentials \\\n  --from-literal=accesstoken=&lt;dockerhub_access_token&gt; \\\n  --from-literal=account=&lt;dockerhub_account_name&gt; \\\n  --from-literal=username=&lt;dockerhub_user_name&gt;\n</code></pre> <p>Note</p> <ul> <li>The \u2039dockerhub_access_token\u203a should be created beforehand and in accordance with the official Docker Hub instruction.</li> <li>The \u2039dockerhub_account_name\u203a and \u2039dockerhub_user_name\u203a for the organization account repository will differ and be identical for the personal account repository.</li> <li>Pay attention that the Docker Hub repository for images uploading should be created beforehand and named by the following pattern: \u2039dockerhub_account_name\u203a/\u2039Application Name\u203a, where the \u2039Application Name\u203a should match the application name in the EDP Admin Console.</li> </ul>"},{"location":"user-guide/ecr-to-docker-stages/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Pipeline Framework</li> <li>Manage Access Token</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/git-server-overview/","title":"Manage Git Servers","text":"<p>Git Server is responsible for integration with Version Control System, whether it is GitHub, Gitlab or Gerrit.</p> <p></p> <p>The Git Server is set via the global.gitProvider parameter of the values.yaml file.</p> <p>To view the current Git Server, you can open <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Git Servers</code> and inspect the following properties:</p> <p> Git Server menu </p> <ul> <li>Git Server status and name - displays the Git Server status, which depends on the Git Server integration status (Success/Failed).</li> </ul> <ul> <li>Git Server properties - displays the Git Server type, its host address, username, SSH/HTTPS port, and name of the secret that contains SSH key.</li> </ul> <ul> <li>Open documentation - opens the \"Manage Git Servers\" documentation page.</li> </ul>"},{"location":"user-guide/git-server-overview/#view-authentication-data","title":"View Authentication Data","text":"<p>To view authentication data that is used to connect to the Git server, use <code>kubectl describe</code> command as follows:</p> <pre><code>kubectl describe GitServer git_server_name -n edp\n</code></pre>"},{"location":"user-guide/git-server-overview/#delete-git-server","title":"Delete Git Server","text":"<p>To remove a Git Server from the Git Servers list, utilize the <code>kubectl delete</code> command as follows:</p> <pre><code>kubectl delete GitServer git_server_name -n edp\n</code></pre>"},{"location":"user-guide/git-server-overview/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Integrate GitHub/GitLab in Tekton</li> </ul>"},{"location":"user-guide/gitops/","title":"Manage GitOps","text":"<p>This page is dedicated to the GitOps section of the Configuration tab, the process of establishing the GitOps repository, outline benefits it extends to users within the platform capabilities. GitOps, short for \"Git Operations\", is a modern approach to managing and automating infrastructure and application deployments. In GitOps, the desired state of your environment is declared and stored in a Git repository. With GitOps, you can ensure that your infrastructure and applications are always in sync with your intended configurations and readily adapt to changing requirements.</p>"},{"location":"user-guide/gitops/#overview","title":"Overview","text":"<p>The purpose of the GitOps section is to provide users with the ability to customize the state of their environments with the help of GitOps approach that enables you to store your entire deployment configuration in a Git repository, providing version control for changes, consistent collaboration, and automated deployments. Enforcing GitOps allows you to declaratively define and automate your configurations, ensuring consistency, version control, and collaboration within your team.</p> <p>To open the GitOps subsection, navigate to <code>EDP Portal</code> -&gt; <code>EDP</code> -&gt; <code>Components</code> -&gt; <code>GitOps</code>:</p> <p> GitOps section </p>"},{"location":"user-guide/gitops/#add-gitops-repository","title":"Add GitOps Repository","text":"<p>To add a GitOps repository, follow the steps below:</p> <ol> <li> <p>Navigate to <code>EDP</code> -&gt; <code>Components</code> -&gt; <code>GitOps</code>. Click the + Add GitOps Repository button:</p> <p> Add GitOps repository </p> </li> <li> <p>Fill in the required fields (in case VCS supports nesting) and click Save:</p> <p> Required fields </p> </li> <li> <p>Check the GitOps repository connected to the platform:</p> <p> System Codebase </p> </li> </ol> <p>In addition to it, the system Codebase is called the same as the GitOps repository will be added to the Codebase list of the Components section:</p> <p> GitOps Codebase </p> <p>Note</p> <p>The platform allows only one GitOps repository at a time.</p>"},{"location":"user-guide/gitops/#gitops-usage","title":"GitOps Usage","text":"<p>Once the GitOps repository is added to the platform, you can set custom parameters for the deployed Helm Chart. To redefine the parameters, follow the steps below:</p> <ol> <li> <p>In the GitOps repository, create the values.yaml file according to the <code>&lt;pipeline-name&gt;/&lt;stage-name&gt;/&lt;application-name&gt;-values.yaml</code> pattern.</p> </li> <li> <p>In the created values.yaml file, enter the parameters with their custom values.</p> </li> <li> <p>Navigate to the Environments section. Open the created environment, open its stage and deploy it with the Values override checkbox selected as it is shown below:</p> <p> GitOps Codebase </p> </li> </ol>"},{"location":"user-guide/gitops/#delete-gitops-repository","title":"Delete GitOps Repository","text":"<p>In case you need to delete the GitOps repository, do the following:</p> <ol> <li> <p>Delete the GitOps repository in the Git provider.</p> </li> <li> <p>Delete the Codebase custom resource using the <code>kubectl delete</code> command:</p> <pre><code>kubectl delete Codebase edp-gitops -n edp\n</code></pre> </li> </ol>"},{"location":"user-guide/gitops/#related-articles","title":"Related Articles","text":"<ul> <li>Add CD Pipeline</li> <li>Cluster Add-Ons Overview</li> <li>Manage Clusters</li> </ul>"},{"location":"user-guide/helm-release-deletion/","title":"Helm Release Deletion","text":"<p>The Helm release deletion stage provides the ability to remove Helm releases from the namespace.</p> <p>Note</p> <p>Pay attention that this stages will remove all Helm releases from the namespace. To avoid loss of important data, before using this stage, make the necessary backups.</p> <p>To remove Helm releases, follow the steps below:</p> <ol> <li> <p>Add the following step to the CD pipeline <code>{\"name\":\"helm-uninstall\",\"step_name\":\"helm-uninstall\"}</code>. Alternatively, with this step, it is possible to create a custom job provisioner.</p> </li> <li> <p>Run the job. The pipeline script will remove Helm releases from the namespace.</p> </li> </ol>"},{"location":"user-guide/helm-release-deletion/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CD Pipeline</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/helm-stages/","title":"Helm Chart Testing and Documentation Tools","text":"<p>This section contains the description of the helm-lint and helm-docs stages that can be used in the Code Review pipeline.</p> <p>The stages help to obtain a quick response on the validity of the helm chart code and documentation in the Code Review pipeline.</p> <p>Inspect the functions performed by the following stages:</p> <ol> <li> <p>helm-lint stage launches the ct lint --charts-deploy-templates/ command in order to validate the chart.</p> <p> Helm lint </p> <ul> <li>chart_schema.yaml - this file contains some rules by which the chart validity is checked. These rules are necessary for the YAML scheme validation.</li> </ul> <p>See the current scheme:</p> View: chart_schema.yaml <pre><code>name: str()\nhome: str()\nversion: str()\ntype: str()\napiVersion: str()\nappVersion: any(str(), num())\ndescription: str()\nkeywords: list(str(), required=False)\nsources: list(str(), required=True)\nmaintainers: list(include('maintainer'), required=True)\ndependencies: list(include('dependency'), required=False)\nicon: str(required=False)\nengine: str(required=False)\ncondition: str(required=False)\ntags: str(required=False)\ndeprecated: bool(required=False)\nkubeVersion: str(required=False)\nannotations: map(str(), str(), required=False)\n---\nmaintainer:\nname: str(required=True)\nemail: str(required=False)\nurl: str(required=False)\n---\ndependency:\nname: str()\nversion: str()\nrepository: str()\ncondition: str(required=False)\ntags: list(str(), required=False)\nenabled: bool(required=False)\nimport-values: any(list(str()), list(include('import-value')), required=False)\nalias: str(required=False)\n</code></pre> <ul> <li>ct.yaml - this file contains rules that will skip the validation of certain rules.</li> </ul> <p>To get more information about the chart testing lint, please refer to the ct_lint documentation.</p> </li> <li> <p>helm-docs stage helps to validate the generated documentation for the Helm deployment templates in the Code Review pipeline for all types of applications supported by EDP. This stage launches the helm-docs command in order to validate the chart documentation file existence and verify its relevance.</p> <p>Requirements: helm-docs v1.10.0</p> <p>Note</p> <p>The helm-docs stage is optional. To extend the pipeline with an additional stage, please refer to the Configure Code Review Pipeline page.</p> <p> Helm docs </p> <p>Note</p> <p>The example of the generated documentation.</p> </li> </ol>"},{"location":"user-guide/helm-stages/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Pipeline Framework</li> </ul>"},{"location":"user-guide/infrastructure/","title":"Manage Infrastructures","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing infrastructures.</p>"},{"location":"user-guide/infrastructure/#check-and-remove-application","title":"Check and Remove Application","text":"<p>As soon as the infrastructure is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this application. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>The added application will be listed in the Applications list allowing you to do the following:</p> <p> Applications menu </p> <ul> <li>Infrastructure status - displays the Git Server status. Can be red or green depending on if the EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> <li>Infrastructure name (clickable) - displays the infrastructure name set during the Git Server creation.</li> <li>Open documentation - opens the documentation that leads to this page.</li> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> <li>Create new infrastructure - displays the Create new component menu.</li> <li>Edit infrastructure - edit the infrastructure by selecting the options icon next to its name in the infrastructures list, and then selecting Edit. For details see the Edit Existing Application section.</li> <li>Delete infrastructure - remove infrastructure by selecting the options icon next to its name in the infrastructures list, and then selecting Delete.</li> </ul> <p>There are also options to sort the infrastructures:</p> <ul> <li>Sort the existing infrastructures in a table by clicking the sorting icons in the table header. Sort the infrastructures alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the infrastructures by their status: Created, Failed, or In progress.</li> </ul> <ul> <li>Select a number of infrastructures displayed per page (15, 25 or 50 rows)  and navigate between pages if the number of applications exceeds the capacity of a single page.</li> </ul>"},{"location":"user-guide/infrastructure/#edit-existing-infrastructure","title":"Edit Existing Infrastructure","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for infrastructures.</p> <ol> <li> <p>To edit an infrastructure directly from the infrastructures overview page or when viewing the infrastructure data:</p> <ul> <li>Select Edit in the options icon menu:</li> </ul> <p> Edit infrastructure on the Infrastructures overview page </p> <p> Edit infrastructure when viewing the infrastructure data </p> <ul> <li>The Edit Infrastructure dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, in the Edit Infrastructure dialog do the following:</p> <p> Edit infrastructure </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h on the Add Infrastructure page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and add the create-jira-issue-metadata stage in the Build pipeline. Also add the commit-validate stage in the Code Review pipeline.</p> </li> <li> <p>To disable Jira integration, in the Edit Infrastructure dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and remove the create-jira-issue-metadata stage in the Build pipeline. Also remove the commit-validate stage in the Code Review pipeline.</p> </li> <li> <p>To create, edit and delete infrastructure branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/infrastructure/#related-articles","title":"Related Articles","text":"<ul> <li>Add Infrastructure</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/library/","title":"Manage Libraries","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing libraries.</p>"},{"location":"user-guide/library/#check-and-remove-library","title":"Check and Remove Library","text":"<p>As soon as the library is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this library. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>Info</p> <p>To navigate quickly to OpenShift, Jenkins/Tekton, Gerrit, SonarQube, Nexus, and other resources, click the Overview section on the navigation bar and hit the necessary link.</p> <p>The added library will be listed in the Libraries list allowing to do the following:</p> <p> Library menu </p> <ol> <li> <p>Create another library by clicking the plus sign icon in the lower-right corner of the screen and performing the same steps as described on the Add Library page.</p> </li> <li> <p>Open library data by clicking its link name. Once clicked, the following blocks will be displayed:</p> </li> </ol> <ul> <li>Library status - displays the Git Server status. Can be red or green depending on if the EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> <li>Library name (clickable) - displays the Git Server name set during the Git Server creation.</li> <li>Open documentation - opens the documentation that leads to this page.</li> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> <li>Create new library - displays the Create new component menu.</li> <li>Edit library - edit the library by selecting the options icon next to its name in the libraries list, and then selecting Edit. For details see the Edit Existing Library section.</li> <li> <p>Delete Library - remove library with the corresponding database and Jenkins/Tekton pipelines by selecting the options icon next to its name in the libraries list, and then selecting Delete.</p> <p>Note</p> <p>The library that is used in a CD pipeline cannot be removed.</p> </li> </ul> <p>There are also options to sort the libraries:</p> <ul> <li>Sort the existing libraries in a table by clicking the sorting icons in the table header. Sort the libraries alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the libraries by their status: Created, Failed, or In progress.</li> <li>Select a number of libraries displayed per page (15, 25 or 50 rows) and navigate between pages if the number of libraries exceeds the capacity of a single page.</li> </ul>"},{"location":"user-guide/library/#edit-existing-library","title":"Edit Existing Library","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for libraries.</p> <ol> <li> <p>To edit a library directly from the Libraries overview page or when viewing the library data:</p> <ul> <li> <p>Select Edit in the options icon menu:</p> <p> Edit library on the libraries overview page </p> <p> Edit library when viewing the library data </p> </li> </ul> <ul> <li>The Edit Library dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, in the Edit Library dialog do the following:</p> <p> Edit library </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h on the Add Library page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and add the create-jira-issue-metadata stage in the Build pipeline. Also add the commit-validate stage in the Code Review pipeline.</p> </li> <li> <p>To disable Jira integration, in the Edit Library dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and remove the create-jira-issue-metadata stage in the Build pipeline. Also remove the commit-validate stage in the Code Review pipeline.</p> <p>As a result, the necessary changes will be applied.</p> </li> <li> <p>To create, edit and delete library branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/library/#related-articles","title":"Related Articles","text":"<ul> <li>Add Library</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/manage-branches/","title":"Manage Branches","text":"<p>This page describes how to manage branches in the created component, whether it is an application, library, autotest or infrastructure.</p>"},{"location":"user-guide/manage-branches/#add-new-branch","title":"Add New Branch","text":"<p>Note</p> <p>When working with libraries, pay attention when specifying the branch name: the branch name is involved in the formation of the library version, so it must comply with the versioning semantic rules for the library.</p> <p>When adding a component, the default branch is a master branch. In order to add a new branch, follow the steps below:</p> <ol> <li> <p>Navigate to the Branches block by clicking the component name link in the Components list.</p> </li> <li> <p>Select the options icon related to the necessary branch and then select Create:</p> <p> Add branch </p> </li> <li> <p>Click Edit YAML in the upper-right corner of the dialog to open the YAML editor and add a branch. Otherwise, fill in the required fields in the dialog:</p> <p> New branch </p> <p>a. Release Branch - select the Release Branch check box if you need to create a release branch.</p> <p>b. Branch name - type the branch name. Pay attention that this field remains static if you create a release branch. For the Clone and Import strategies: if you want to use the existing branch, enter its name into this field.</p> <p>c. From Commit Hash - paste the commit hash from which the branch will be created. For the Clone and Import strategies: Note that if the From Commit Hash field is empty, the latest commit from the branch name will be used.</p> <p>d. Branch version - enter the necessary branch version for the artifact. The Release Candidate (RC) postfix is concatenated to the branch version number.</p> <p>e. Default branch version - type the branch version that will be used in a master branch after the release creation. The Snapshot postfix is concatenated to the master branch version number.</p> <p>f. Click the Apply button and wait until the new branch will be added to the list.</p> <p>Info</p> <p>Adding of a new branch is indicated in the context of the edp versioning type.</p> </li> </ol> <p>The default component repository is cloned and changed to the new indicated version before the build, i.e. the new indicated version will not be committed to the repository; thus, the existing repository will keep the default version.</p>"},{"location":"user-guide/manage-branches/#build-branch","title":"Build Branch","text":"<p>In order to build branch from the latest commit, do the following:</p> <ol> <li>Navigate to the Branches block by clicking the library name link in the Libraries list.</li> <li> <p>Select the options icon related to the necessary branch and then select Build:</p> <p> Build branch </p> </li> </ol> <p>The pipeline run status is displayed near the branch name in the Branches block:</p> <p> Pipeline run status in EDP Portal </p> <p>The corresponding item appears on the Tekton Dashboard in the PipelineRuns section:</p> <p> Pipeline run status in Tekton </p>"},{"location":"user-guide/manage-branches/#delete-branch","title":"Delete Branch","text":"<p>Note</p> <p>The default master branch cannot be removed.</p> <p>In order to delete the added branch with the corresponding record in the EDP Portal database, do the following:</p> <ol> <li>Navigate to the Branches block by clicking the component name link in the components list.</li> <li> <p>Select the options icon related to the necessary branch and then select Delete:</p> <p> Delete branch </p> </li> </ol>"},{"location":"user-guide/manage-branches/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add Autotest</li> </ul>"},{"location":"user-guide/marketplace/","title":"Marketplace Overview","text":"<p>The EDP Marketplace offers a range of Templates, predefined tools and settings for creating software. These Templates speed up development, minimize errors, and ensure consistency. A key EDP Marketplace feature is customization. Organizations can create and share their own Templates, finely tuned to their needs. Each Template serves as a tailored blueprint of tools and settings.</p> <p>These tailored Templates include preset CI/CD pipelines, automating your development workflows. From initial integration to final deployment, these processes are efficiently managed. Whether for new applications or existing ones, these templates enhance processes, save time, and ensure consistency.</p> <p>To see the Marketplace section, navigate to the Main menu -&gt; EDP -&gt; Marketplace. General look of the Marketplace section is described below:</p> <p> Marketplace section (listed view) </p> <ul> <li>Marketplace templates - all the components marketplace can offer;</li> <li>Template properties - the item summary that shows the type, category, language, framework, build tool and maturity;</li> <li>Enable/disable filters - enables users to enable/disable searching by the item name or namespace it is available in;</li> <li>Change view - allows switching from the listed view to the tiled one and vice versa. See the screenshot below for details.</li> </ul> <p>There is also a possibility to switch into the tiled view instead of the listed one:</p> <p> Marketplace section (tiled view) </p> <p>To view the details of a marketplace item, simply click on its name:</p> <p> Item details </p> <p>The details window shows supplemental information, such as item's author, keywords, release version and the link to the repository it is located in. The window also contains the Create from template button that allows users to create the component by the chosen template. The procedure of creating new components is described in the Add Component via Marketplace page.</p>"},{"location":"user-guide/marketplace/#related-articles","title":"Related Articles","text":"<ul> <li>Add Component via Marketplace</li> <li>Add Application</li> <li>Add Library</li> <li>Add Infrastructure</li> </ul>"},{"location":"user-guide/opa-stages/","title":"Use Open Policy Agent","text":"<p>Open Policy Agent (OPA) is a policy engine that provides:</p> <ul> <li>High-level declarative policy language Rego;</li> <li>API and tooling for policy execution.</li> </ul> <p>EPAM Delivery Platform ensures the implemented Open Policy Agent support allowing to work with Open Policy Agent bundles that is processed by means of stages in the Code Review and Build pipelines. These pipelines are expected to be created after the Rego OPA Library is added.</p>"},{"location":"user-guide/opa-stages/#code-review-pipeline-stages","title":"Code Review Pipeline Stages","text":"<p>In the Code Review pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage, a standard step during which all files are checked out from a selected branch of the Git repository.</p> </li> <li> <p>tests stage containing a script that performs the following actions:</p> <p>2.1. Runs policy tests.</p> <p>2.2. Converts OPA test results into JUnit format.</p> <p>2.3. Publishes JUnit-formatted results to Jenkins.</p> </li> </ol>"},{"location":"user-guide/opa-stages/#build-pipeline-stages","title":"Build Pipeline Stages","text":"<p>In the Build pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage, a standard step during which all files are checked out from a selected branch of the Git repository.</p> </li> <li> <p>get-version optional stage, a step where library version is determined either via:</p> <p>2.1. Standard EDP versioning functionality.</p> <p>2.2. Manually specified version. In this case .manifest file in a root directory MUST be provided. File must contain a JSON document with revision field. Minimal example: <code>{ \"revision\": \"1.0.0\" }\"</code>.</p> </li> <li> <p>tests stage containing a script that performs the following actions:   3.1. Runs policy tests.   3.2. Converts OPA test results into JUnit format.   3.3. Publishes JUnit-formatted results to Jenkins.</p> </li> <li> <p>git-tag stage, a standard step where git branch is tagged with a version.</p> </li> </ol>"},{"location":"user-guide/opa-stages/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Pipeline Framework</li> </ul>"},{"location":"user-guide/pipeline-framework/","title":"EDP Pipeline Framework","text":"<p>This chapter provides detailed information about the EDP pipeline framework concepts and parts, as well as the accurate data about the <code>Code Review</code>, <code>Build</code> and <code>Deploy</code> pipelines with the respective stages.</p>"},{"location":"user-guide/pipeline-framework/#edp-pipeline-framework-overview","title":"EDP Pipeline Framework Overview","text":"<p>Note</p> <p>The whole logic is applied to Jenkins as it is the main tool for the CI/CD processes organization.</p> <p> EDP pipeline framework basic </p> <p>The general EDP Pipeline Framework consists of several parts:</p> <ul> <li>Jenkinsfile - a text file that keeps the definition of a Jenkins Pipeline and is checked into source control. Every Job has its Jenkinsfile stored in the specific application repository and in Jenkins as the plain text. The behavior logic of the pipelines can be customized easily by modifying a source code which is always copied to the EDP repository after the EDP installation.</li> </ul> <p> Jenkinsfile example </p> <ul> <li>Loading Shared Libraries - a part where every job loads libraries with the help of the shared libraries mechanism for Jenkins that allows to create reproducible pipelines, write them uniformly, and manage the update process. There are two main libraries: EDP Pipelines with the common logic described for the main pipelines Code Review, Build, Deploy pipelines and EDP Stages library that keeps the description of the stages for every pipeline.</li> </ul> <ul> <li>Run Stages - a part where the predefined default stages are launched.</li> </ul> <p> Pipeline script </p>"},{"location":"user-guide/pipeline-framework/#cicd-jobs-comparison","title":"CI/CD Jobs Comparison","text":"<p>Explore the CI and CD job comparison. Please note that the dynamic stages order can be changed, meanwhile, the predefined stages order in the reference pipeline cannot be changed, i.e. only the predefined stages set can be run.</p> <p> CI/CD jobs comparison </p>"},{"location":"user-guide/pipeline-framework/#context","title":"Context","text":"<p>Context - a variable that stores and transfers all necessary parameters between stages that are used by pipeline during performing.</p> <ol> <li>The context type is \"Map\".</li> <li>Each stage has input and output context.</li> <li>Each stage has a mandatory input context.</li> </ol> <p>Note</p> <p>If the input context isn't transferred, the stage will be failed.</p>"},{"location":"user-guide/pipeline-framework/#annotations-for-cicd-stages","title":"Annotations for CI/CD Stages","text":"<p>Annotation for CI Stages:</p> <ul> <li>The annotation type is \"Map\";</li> <li>The annotation consists of the name, buildTool, and codebaseType.</li> </ul> <p>Annotation for CD Stages:</p> <ul> <li>The annotation type is \"Map\";</li> <li>The annotation consists of a name.</li> </ul>"},{"location":"user-guide/pipeline-framework/#code-review-pipeline","title":"Code Review Pipeline","text":"<p>CodeReview() \u2013 a function that allows using the EDP implementation for the Code Review pipeline.</p> <p>Note</p> <p>All values of different parameters that are used during the pipeline execution are stored in the \"Map\" context.</p> <p>The Code Review pipeline consists of several steps:</p> <p>On the master:</p> <ul> <li>Initialization of all objects (Platform, Job, Gerrit, Nexus, Sonar, Application, StageFactory) and loading of the default implementations of EDP stages.</li> </ul> <p>On a particular Jenkins agent that depends on the build tool:</p> <ul> <li>Creating workdir for application sources;</li> <li>Loading build tool implementation for a particular application;</li> <li>Run in a loop all stages (From) and run them either in parallel or one by one.</li> </ul>"},{"location":"user-guide/pipeline-framework/#code-review-pipeline-overview","title":"Code Review Pipeline Overview","text":"<p>Using in pipelines - @Library(['edp-library-pipelines@version'])</p> <p>The corresponding enums, interfaces, classes, and their methods can be used separately from the EDP Pipelines library function (please refer to Table 1 and Table 2).</p> <p>Table 1.  Enums and Interfaces with the respective properties, methods, and examples.</p> <p> Enums Interfaces PlatformType:  - OPENSHIFT  - KUBERNETES  JobType:  - CODEREVIEW  - BUILD  - DEPLOY BuildToolType:  - MAVEN  - GRADLE  - NPM  - DOTNET Platform() - contains methods for working with platform CLI. At the moment only OpenShift is supported. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".  Methods: getJsonPathValue(String k8s_kind, String k8s_kind_name, String jsonPath): return String value of specific parameter of particular object using jsonPath utility. Example: <code>context.platform.getJsonPathValue(''cm'',</code><code>''project-settings'', ''.data.username'')</code>. BuildTool() - contains methods for working with different buildTool from ENUM BuildToolType. Should be invoked on Jenkins build agents. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Nexus object - Object of class Nexus. Methods: init: return parameters of buildTool that are needed for running stages. Example:  <code>context.buildTool = new BuildToolFactory().</code><code>getBuildToolImpl</code><code>(context.application.config.build_tool, this,</code><code>context.nexus) context.buildTool.init()</code>. <p></p> <p>Table 2.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) PlatformFactory() - Class that contains methods getting an implementation of CLI of the platform. At the moment OpenShift and Kubernetes are supported. Methods: <code>getPlatformImpl(PlatformType platform, Script script): return Class Platform</code>. Example:  <code>context.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)</code>. Application(String name, Platform platform, Script script) - Class that describes the application object. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform(). String name - Name for the application for creating an object. Map config - Map of configuration settings for the particular application that is loaded from config map project-settings. String version - Application version, initially empty. Is set on the get-version step. String deployableModule - The name of the deployable module for multi-module applications, initially empty. String buildVersion - Version of the built artifact, contains build number of Job initially empty. String deployableModuleDir - The name of deployable module directory for multi-module applications, initially empty. Array imageBuildArgs - List of arguments for building an application Docker image. Methods: setConfig(String gerrit_autouser, String gerrit_host, String gerrit_sshPort, String gerrit_project): set the config property with values from config map. Example: <code>context.application = new Application(context.job, context.gerrit.project, context.platform, this) context.application.setConfig(context.gerrit.autouser, context.gerrit.host, context.gerrit.sshPort, context.gerrit.project)</code> Job(type: JobType.value, platform: Platform, script: Script) - Class that describes the Gerrit tool. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform(). JobType.value type. String deployTemplatesDirectory - The name of the directory in application repository where deploy templates are located. It can be set for a particular Job through DEPLOY_TEMPLATES_DIRECTORY parameter. String edpName - The name of the EDP Project. Map stages - Contains all stages in JSON format that is retrieved from Jenkins job env variable. String envToPromote - The name of the environment for promoting images. Boolean promoteImages - Defines whether images should be promoted or not. Methods: getParameterValue(String parameter, String defaultValue = null): return parameter of ENV variable of Jenkins job. init(): set all the properties of the Job object. setDisplayName(String displayName): set display name of the Jenkins job. setDescription(String description, Boolean addDescription = false): set new or add to the existing description of the Jenkins job. printDebugInfo(Map context): print context info to the log of Jenkins' job. runStage(String stage_name, Map context): run the particular stage according to its name. Example: <code>context.job = new Job(JobType.CODEREVIEW.value,</code> <code>context.platform, this)</code> <code>context.job.init()</code> <code>context.job.printDebugInfo(context)</code> <code>context.job.setDisplayName(\"test\")</code> <code>context.job.setDescription(\"Name: ${context.application.config.name}\")</code> Gerrit(Job job, Platform platform, Script script) - Class that describes the Gerrit tool. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String credentialsId - Credential Id in Jenkins for Gerrit.String autouser - Username of an auto user in Gerrit for integration with Jenkins.String host - Gerrit host.String project - the project name of the built application.String branch - branch to build the application from.String changeNumber - change number of Gerrit commit.String changeName - change name of Gerrit commit.String refspecName - refspecName of Gerrit commit.String sshPort - Gerrit ssh port number.String patchsetNumber - patchsetNumber of Gerrit commit.Methods: init(): set all the properties of Gerrit object. Example: <code>context.gerrit = new Gerrit(context.job, context.platform, this)</code> <code>context.gerrit.init()</code> Nexus(Job job, Platform platform, Script script) - Class that describes the Nexus tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String autouser - Username of an auto user in Nexus for integration with Jenkins.String credentialsId - Credential Id in Jenkins for Nexus.String host - Nexus host.String port - Nexus http(s) port.String repositoriesUrl - Base URL of repositories in Nexus.String restUrl - URL of Rest API.Methods:init(): set all the properties of Nexus objectExample: <code>context.nexus = new Nexus(context.job, context.platform, this)</code> <code>context.nexus.init()</code> Sonar(Job job, Platform platform, Script script) - Class that describes the Sonar tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String route - External route of the sonar application.Methods:init(): set all the properties of Sonar objectExample: <code>context.sonar = new Sonar(context.job, context.platform, this)</code> <code>context.sonar.init()</code>"},{"location":"user-guide/pipeline-framework/#code-review-pipeline-stages","title":"Code Review Pipeline Stages","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass the \"Map\" context with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>The Code Review pipeline includes the following default stages: Checkout \u2192 Gerrit Checkout \u2192 Compile \u2192 Tests \u2192 Sonar.</p> <p>Info</p> <p>To get the full description of every stage, please refer to the EDP Stages Framework section.</p>"},{"location":"user-guide/pipeline-framework/#how-to-redefine-or-extend-the-edp-pipeline-stages-library","title":"How to Redefine or Extend the EDP Pipeline Stages Library","text":"<p>Inspect the points below to redefine or extend the EDP Pipeline Stages Library:</p> <ul> <li>Create \u201cstage\u201d folder in your App repository.</li> <li>Create a Groovy file with a meaningful name for the custom stage description. For instance \u2013 CustomBuildMavenApplication.groovy.</li> <li>Describe the stage logic.</li> </ul> <p>Redefinition:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"compile\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass CustomBuildMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn CustomBuildMavenApplication\n</code></pre> <p>Extension:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"new-stage\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass NewStageMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn NewStageMavenApplication\n</code></pre>"},{"location":"user-guide/pipeline-framework/#using-edp-stages-library-in-the-pipeline","title":"Using EDP Stages Library in the Pipeline","text":"<p>In order to use the EDP stages, the created pipeline should fit some requirements, that`s why a developer has to do the following:</p> <ul> <li>import library - @Library(['edp-library-stages'])</li> <li>import StageFactory class - import com.epam.edp.stages.StageFactory</li> <li>define context Map \u2013 context = [:]</li> <li>define stagesFactory instance and load EDP stages:</li> </ul> <pre><code>  context.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n</code></pre> <p>After that, there is the ability to run any EDP stage beforehand by defining a necessary context: <code>context.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)</code></p> <p>For instance, the pipeline can look like:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\nnode('maven') {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n\n\n\nstage(\"checkout\") {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n\n\nstage(\"compile\") {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n</code></pre> <p>Or in a declarative way:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\npipeline {\nagent { label 'maven' }\nstages {\nstage('Init'){\nsteps {\nscript {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n}\n}\n}\n\nstage(\"Checkout\") {\nsteps {\nscript {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n}\n}\n\nstage('Compile') {\nsteps {\nscript {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n}\n}\n}\n</code></pre>"},{"location":"user-guide/pipeline-framework/#build-pipeline","title":"Build Pipeline","text":"<p>Build() \u2013 a function that allows using the EDP implementation for the Build pipeline. All values of different parameters that are used during the pipeline execution are stored in the \"Map\" context.</p> <p>The Build pipeline consists of several steps:</p> <p>On the master:</p> <ul> <li>Initialization of all objects (Platform, Job, Gerrit, Nexus, Sonar, Application, StageFactory) and loading default implementations of EDP stages.</li> </ul> <p>On a particular Jenkins agent that depends on the build tool:</p> <ul> <li>Creating workdir for application sources;</li> <li>Loading build tool implementation for a particular application;</li> <li>Run in a loop all stages (From) and run them either in parallel or one by one.</li> </ul>"},{"location":"user-guide/pipeline-framework/#build-pipeline-overview","title":"Build Pipeline Overview","text":"<p>Using in pipelines - @Library(['edp-library-pipelines@version'])</p> <p>The corresponding enums, interfaces, classes, and their methods can be used separately from the EDP Pipelines library function (please refer to Table 3 and Table 4).</p> <p>Table 3.  Enums and Interfaces with the respective properties, methods, and examples.  Enums Interfaces PlatformType:- OPENSHIFT- KUBERNETESJobType:- CODEREVIEW- BUILD- DEPLOYBuildToolType:- MAVEN- GRADLE- NPM- DOTNET Platform() -  contains methods for working with platform CLI. At the moment only OpenShift is supported.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Methods:getJsonPathValue(String k8s_kind, String k8s_kind_name, String jsonPath): return String value of specific parameter of particular object using jsonPath utility.Example:<code>context.platform.getJsonPathValue(\"cm\",\"project-settings\",</code><code>\".data.username\")</code>BuildTool() - contains methods for working with different buildTool from ENUM BuildToolType. Should be invoked on Jenkins build agents.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Nexus object - Object of class Nexus. See description below:Methods:init: return parameters of buildTool that are needed for running stages.Example:<code>context.buildTool = new BuildToolFactory().getBuildToolImpl</code><code>(context.application.config.build_tool, this,</code><code>context.nexus)context.buildTool.init()</code> <p> Table 4.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) PlatformFactory() - Class that contains methods getting an implementation of CLI of the platform. At the moment OpenShift and Kubernetes are supported. Methods:getPlatformImpl(PlatformType platform, Script script): return Class PlatformExample:<code>context.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)</code> Application(String name, Platform platform, Script script) - Class that describes the application object. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().String name - Name for the application for creating an object.Map config - Map of configuration settings for the particular application that is loaded from config map project-settings.String version - Application version, initially empty. Is set on the get-version step.String deployableModule - The name of the deployable module for multi-module applications, initially empty.String buildVersion - Version of the built artifact, contains build number of Job initially empty.String deployableModuleDir - The name of deployable module directory for multi-module applications, initially empty.Array imageBuildArgs - List of arguments for building the application Docker image.Methods:setConfig(String gerrit_autouser, String gerrit_host, String gerrit_sshPort, String gerrit_project): set the config property with values from config map.Example:<code>context.application = new Application(context.job, context.gerrit.project, context.platform, this) context.application.setConfig(context.gerrit.autouser, context.gerrit.host, context.gerrit.sshPort, context.gerrit.project)</code> Job(type: JobType.value, platform: Platform, script: Script) - Class that describes the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().JobType.value type.String deployTemplatesDirectory - The name of the directory in application repository, where deploy templates are located. It can be set for a particular Job through DEPLOY_TEMPLATES_DIRECTORY parameter.String edpName - The name of the EDP Project.Map stages - Contains all stages in JSON format that is retrieved from Jenkins job env variable.String envToPromote - The name of the environment for promoting images.Boolean promoteImages - Defines whether images should be promoted or not.Methods:getParameterValue(String parameter, String defaultValue = null): return parameter of ENV variable of Jenkins job.init(): set all the properties of the Job object.setDisplayName(String displayName): set display name of the Jenkins job.setDescription(String description, Boolean addDescription = false): set new or add to the existing description of the Jenkins job.printDebugInfo(Map context): print context info to the log of Jenkins' job.runStage(String stage_name, Map context): run the particular stage according to its name.Example:<code>context.job = new Job(JobType.CODEREVIEW.value, context.platform, this) context.job.init() context.job.printDebugInfo(context) context.job.setDisplayName(\"test\") context.job.setDescription(\"Name: ${context.application.config.name}\")</code> Gerrit(Job job, Platform platform, Script script) - Class that describes the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String credentialsId - Credentials Id in Jenkins for Gerrit.String autouser - Username of an auto user in Gerrit for integration with Jenkins.String host - Gerrit host.String project - the project name of the built application.String branch - branch to build an application from.String changeNumber - change number of Gerrit commit.String changeName - change name of Gerrit commit.String refspecName - refspecName of Gerrit commit.String sshPort - Gerrit ssh port number.String patchsetNumber - patchsetNumber of Gerrit commit.Methods:init(): set all the properties of Gerrit objectExample: <code>context.gerrit = new Gerrit(context.job, context.platform, this) context.gerrit.init()</code> Nexus(Job job, Platform platform, Script script) - Class that describes the Nexus tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String autouser - Username of an auto user in Nexus for integration with Jenkins.String credentialsId - Credentials Id in Jenkins for Nexus.String host - Nexus host.String port - Nexus http(s) port.String repositoriesUrl - Base URL of repositories in Nexus.String restUrl - URL of Rest API.Methods:init(): set all the properties of the Nexus object.Example:<code>context.nexus = new Nexus(context.job, context.platform, this) context.nexus.init()</code> Sonar(Job job, Platform platform, Script script) - Class that describes the Sonar tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String route - External route of the sonar application.Methods:init(): set all the properties of Sonar object.Example:<code>context.sonar = new Sonar(context.job, context.platform, this) context.sonar.init()</code>"},{"location":"user-guide/pipeline-framework/#build-pipeline-stages","title":"Build Pipeline Stages","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass a context map with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>The Build pipeline includes the following default stages: Checkout \u2192 Gerrit Checkout \u2192 Compile \u2192 Get version \u2192 Tests \u2192 Sonar \u2192 Build \u2192 Build Docker Image \u2192 Push \u2192 Git tag.</p> <p>Info</p> <p>To get the full description of every stage, please refer to the EDP Stages Framework section.</p>"},{"location":"user-guide/pipeline-framework/#how-to-redefine-or-extend-edp-pipeline-stages-library","title":"How to Redefine or Extend EDP Pipeline Stages Library","text":"<p>Inspect the points below to redefine or extend the EDP Pipeline Stages Library:</p> <ul> <li>Create a \u201cstage\u201d folder in the App repository.</li> <li>Create a Groovy file with a meaningful name for the custom stage description. For instance \u2013 CustomBuildMavenApplication.groovy</li> <li>Describe stage logic.</li> </ul> <p>Redefinition:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"compile\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass CustomBuildMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn CustomBuildMavenApplication\n</code></pre> <p>Extension:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"new-stage\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass NewStageMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn NewStageMavenApplication\n</code></pre>"},{"location":"user-guide/pipeline-framework/#using-edp-stages-library-in-the-pipeline_1","title":"Using EDP Stages Library in the Pipeline","text":"<p>In order to use the EDP stages, the created pipeline should fit some requirements, that`s why a developer has to do the following:</p> <ul> <li>import library - @Library(['edp-library-stages'])</li> <li>import StageFactory class - import com.epam.edp.stages.StageFactory</li> <li>define context Map \u2013 context = [:]</li> <li>define stagesFactory instance and load EDP stages:</li> </ul> <pre><code>context.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n</code></pre> <p>After that, there is the ability to run any EDP stage beforehand by defining a requirement context <code>context.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)</code></p> <p>For instance, the pipeline can look like:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\nnode('maven') {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n\n\n\nstage(\"checkout\") {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n\n\nstage(\"compile\") {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n</code></pre> <p>Or in a declarative way:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\npipeline {\nagent { label 'maven' }\nstages {\nstage('Init'){\nsteps {\nscript {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n}\n}\n}\n\nstage(\"Checkout\") {\nsteps {\nscript {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n}\n}\n\nstage('Compile') {\nsteps {\nscript {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n}\n}\n}\n</code></pre>"},{"location":"user-guide/pipeline-framework/#edp-library-stages-description","title":"EDP Library Stages Description","text":"<p>Using in pipelines - @Library(['edp-library-stages@version'])</p> <p>The corresponding enums, classes, interfaces and their methods can be used separately from the EDP Stages library function (please refer to Table 5).</p> <p>Table 5.  Enums and Classes with the respective properties, methods, and examples.</p> Enums Classes ProjectType: - APPLICATION  - AUTOTESTS  - LIBRARY StageFactory() - Class that contains methods getting an implementation of the particular stage either EDP from shared library or custom from application repository.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Map stages - Map of stages implementations.Methods:loadEdpStages(): return a list of Classes that describes EDP stages implementations.loadCustomStages(String directory): return a list of Classes that describes EDP custom stages from application repository from \"directory\". The \"directory\" should have an absolute path to files with classes of custom stages implementations. Should be run from a Jenkins agent.add(Class clazz): register class for some particular stage in stages map of StageFactory class.getStage(String name, String buildTool, String type): return an object of the class for a particular stage from stages property based on stage name and buildTool, type of application.Example:<code>context.factory = new StageFactory(script: this)</code><code>context.factory.loadEdpStages().each() { context.factory.add(it) }</code><code>context.factory.loadCustomStages(\"${context.workDir}/stages\").each() { context.factory.add(it) }</code><code>context.factory.getStage(stageName.toLowerCase(),context.application.config.build_tool.toLowerCase(),</code><code>context.application.config.type).run(context)</code>"},{"location":"user-guide/pipeline-framework/#edp-stages-framework","title":"EDP Stages Framework","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass a context map with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>Inspect the Table 6 and Table 7 that contain the full description of every stage that can be included in Code Review and Build pipelines: Checkout \u2192 Gerrit Checkout \u2192 Compile \u2192 Get version \u2192 Tests \u2192 Sonar \u2192 Build \u2192 Build Docker Image \u2192 Push \u2192 Git tag.</p> <p>Table 6.  The Checkout, Gerrit Checkout, Compile, Get version, and Tests stages description.</p> Checkout Gerrit Checkout Compile Get version Tests name = \"checkout\",buildTool = [\"maven\", \"npm\", \"dotnet\",\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- StageFactory context.factory- String context.gerrit.branch- String context.gerrit.credentialsId- String context.application.config.cloneUrl name = \"gerrit-checkout\",buildTool = [\"maven\", \"npm\", \"dotnet\",\"gradle\"]type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]context required:- String context.workDir- StageFactory context.factory- String context.gerrit.changeName- String context.gerrit.refspecName- String context.gerrit.credentialsId- String context.application.config.cloneUrl name = \"compile\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.sln_filenameoutput:- String context.buildTool.sln_filenamebuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.groupRepository name = \"get-version\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- Map(empty) context.application- String context.gerrit.branch- Job context.joboutput:-String context.application.deplyableModule- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersionbuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.command- Job context.job- String context.gerrit.branchoutput:- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersionbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.command- Job context.job- String context.gerrit.branchoutput:- String context.application.deplyableModule- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersionbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- Job context.job- String context.gerrit.branchoutput:- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersion name = \"tests\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDirbuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.commandbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.commandtype = [ProjectType.AUTOTESTS]context required:- String context.workDir- String context.buildTool.command- String context.application.config.report_frameworkbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir <p>Table 7.  The Sonar, Build, Build Docker Image, Push, and Git tag stages description.</p> Sonar Build Build Docker Image Push Git tag name = \"sonar\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.job.type- String context.application.name- String context.buildTool.sln_filename- String context.sonar.route- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline)buildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.job.type- String context.nexus.credentialsId- String context.buildTool.command- String context.application.name- String context.sonarRoute- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline)buildTool = [\"maven\"]type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]context required:- String context.workDir- String context.job.type- String context.nexus.credentialsId- String context.application.name- String context.buildTool.command- String context.sonar.route- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline)buildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.job.type- String context.sonar.route- String context.application.name- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline) name = \"build\"buildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.groupRepository name = \"build-image\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromotebuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromotebuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromotebuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromote name = \"push\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.gerrit.project- String context.buildTool.sln_filename- String context.buildTool.snugetApiKey- String context.buildTool.hostedRepositorybuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.application.version- String context.buildTool.hostedRepository- String context. buildTool.settingsbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.application.version- String context.buildTool.hostedRepository- String context.buildTool.commandbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.hostedRepository- String context.gerrit.autouser name = \"git-tag\"buildTool = [\"maven\", \"npm\", \"dotnet\",\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.gerrit.credentialsId- String context.gerrit.sshPort- String context.gerrit.host- String context.gerrit.autouser- String context.application.buildVersion"},{"location":"user-guide/pipeline-framework/#deploy-pipeline","title":"Deploy Pipeline","text":"<p>Deploy() \u2013 a function that allows using the EDP implementation for the deploy pipeline. All values of different parameters that are used during the pipeline execution are stored in the \"Map\" context.</p> <p>The deploy pipeline consists of several steps:</p> <p>On the master:</p> <ul> <li>Initialization of all objects (Platform, Job, Gerrit, Nexus, StageFactory) and loading the default implementations of EDP stages;</li> <li>Creating an environment if it doesn`t exist;</li> <li>Deploying the last versions of the applications;</li> <li>Run predefined manual gates.</li> </ul> <p>On a particular autotest Jenkins agent that depends on the build tool:</p> <ul> <li>Creating workdir for autotest sources;</li> <li>Run predefined autotests.</li> </ul>"},{"location":"user-guide/pipeline-framework/#edp-library-pipelines-description","title":"EDP Library Pipelines Description","text":"<p>_Using in pipelines - @Library(['edp-library-pipelines@version']) _</p> <p>The corresponding enums and interfaces with their methods can be used separately from the EDP Pipelines library function (please refer to Table 8 and Table 9).</p> <p>Table 8.  Enums and Interfaces with the respective properties, methods, and examples.</p> <p> Enums Interfaces PlatformType:- OPENSHIFT- KUBERNETESJobType:- CODEREVIEW- BUILD- DEPLOYBuildToolType:- MAVEN- GRADLE- NPM- DOTNET Platform() - contains methods for working with platform CLI. At the moment only OpenShift is supported.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Methods:getJsonPathValue(String k8s_kind, String k8s_kind_name, String jsonPath): return String value of specific parameter of particular object using jsonPath utility. Example: <code>context.platform.getJsonPathValue(\"cm\",\"project-settings\",</code><code>\".data.username\")</code> BuildTool() - contains methods for working with different buildTool from ENUM BuildToolType. (Should be invoked on Jenkins build agents)Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Nexus object - Object of class Nexus.Methods:init: return parameters of buildTool that are needed for running stages. Example:<code>context.buildTool = new BuildToolFactory().getBuildToolImpl</code><code>(context.application.config.build_tool, this, context.nexus)</code><code>context.buildTool.init()</code> <p> Table 9.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) PlatformFactory() - Class that contains methods getting implementation of CLI of platform. At the moment OpenShift and Kubernetes are supported. Methods:getPlatformImpl(PlatformType platform, Script script): return Class PlatformExample: <code>context.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)</code> Application(String name, Platform platform, Script script) - Class that describe the application object. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform()String name - Name for the application for creating objectMap config - Map of configuration settings for particular application that is loaded from config map project-settingsString version - Application version, initially empty. Is set on get-version step.String deployableModule - The name of deployable module for multi module applications, initially empty.String buildVersion - Version of built artifact, contains build number of Job initially emptyString deployableModuleDir - The name of deployable module directory for multi module applications, initially empty.Array imageBuildArgs - List of arguments for building application Docker imageMethods: setConfig(String gerrit_autouser, String gerrit_host, String gerrit_sshPort, String gerrit_project): set the config property with values from config mapExample: <code>context.application = new Application(context.job, context.gerrit.project, context.platform, this)</code> <code>context.application.setConfig(context.gerrit.autouser, context.gerrit.host, context.gerrit.sshPort, context.gerrit.project)</code> Job(type: JobType.value, platform: Platform, script: Script) - Class that describe the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\"Platform platform - Object of a class Platform().JobType.value type.String deployTemplatesDirectory - The name of the directory in application repository, where deploy templates are located. Can be set for particular Job through DEPLOY_TEMPLATES_DIRECTORY parameter.String edpName - The name of the EDP Project.Map stages - Contains all stages in JSON format that is retrieved from Jenkins job env variable.String envToPromote - The name of the environment for promoting images.Boolean promoteImages - Defines whether images should be promoted or not. Methods:getParameterValue(String parameter, String defaultValue = null): return parameter of ENV variable of Jenkins job. init(): set all the properties of Job object. setDisplayName(String displayName): set display name of the Jenkins job. setDescription(String description, Boolean addDescription = false): set new or add to existing description of the Jenkins job. printDebugInfo(Map context): print context info to log of Jenkins job. runStage(String stage_name, Map context): run the particular stage according to its name. Example: <code>context.job = new Job(JobType.DEPLOY.value, context.platform, this)</code> <code>context.job.init()</code> <code>context.job.printDebugInfo(context)</code> <code>context.job.setDisplayName(\"test\")</code> <code>context.job.setDescription(\"Name: ${context.application.config.name}\")</code> Gerrit(Job job, Platform platform, Script script) - Class that describe the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform(). Job job - Object of a class Job().String credentialsId - Credential Id in Jenkins for Gerrit. String autouser - Username of autouser in Gerrit for integration with Jenkins. String host - Gerrit host. String project - project name of built application. String branch - branch to build application from. String changeNumber - change number of Gerrit commit. String changeName - change name of Gerrit commit. String refspecName - refspecName of Gerrit commit. String sshPort - gerrit ssh port number. String patchsetNumber - patchsetNumber of Gerrit commit.Methods:init(): set all the properties of Gerrit object. Example:<code>context.gerrit = new Gerrit(context.job, context.platform, this)</code><code>context.gerrit.init()</code>. Nexus(Job job, Platform platform, Script script) - Class that describe the Nexus tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform(). Job job - Object of a class Job(). String autouser - Username of autouser in Nexus for integration with Jenkins. String credentialsId - Credential Id in Jenkins for Nexus. String host - Nexus host. String port - Nexus http(s) port. String repositoriesUrl - Base URL of repositories in Nexus. String restUrl - URL of Rest API. Methods:init(): set all the properties of Nexus object. Example: <code>context.nexus = new Nexus(context.job, context.platform, this)</code> <code>context.nexus.init()</code>."},{"location":"user-guide/pipeline-framework/#edp-library-stages-description_1","title":"EDP Library Stages Description","text":"<p>Using in pipelines - @Library(['edp-library-stages@version']) _</p> <p>The corresponding classes with methods can be used separately from the EDP Pipelines library function (please refer to Table 10).</p> <p>Table 10.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) StageFactory() - Class that contains methods getting implementation of particular stage either EDP from shared library or custom from application repository. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\"Map stages - Map of stages implementationsMethods:loadEdpStages(): return list of Classes that describes EDP stages implementationsloadCustomStages(String directory): return list of Classes that describes EDP custom stages from application repository from \"directory\". The \"directory\" should be absolute path to files with classes of custom stages implementations. Should be run from Jenkins agent.add(Class clazz): register class for some particular stage in stages map of StageFactory classgetStage(String name, String buildTool, String type): return object of the class for particular stage from stages property based on stage name and buildTool, type of applicationExample:<code>context.factory = new StageFactory(script: this)</code><code>context.factory.loadEdpStages().each() { context.factory.add(it) }</code><code>context.factory.loadCustomStages(\"${context.workDir}/stages\").each() { context.factory.add(it) }</code><code>context.factory.getStage(stageName.toLowerCase(),context.application.config.build_tool.toLowerCase(),</code><code>context.application.config.type).run(context)</code>."},{"location":"user-guide/pipeline-framework/#deploy-pipeline-stages","title":"Deploy Pipeline Stages","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass a context map with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>The stages for the deploy pipeline are independent of the build tool and application type. Find below (see Table 11 ) the full description of every stage: Deploy \u2192 Automated tests \u2192 Promote Images.</p> <p>Table 11.  The Deploy, Automated tests, and Promote Images stages description.</p> Deploy Automated tests Promote Images name = \"deploy\"buildTool = nulltype = nullcontext required:\u2022   String context.workDir\u2022   StageFactory context.factory\u2022 String context.gerrit.autouser\u2022   String context.gerrit.host\u2022   String context.application.config.cloneUrl\u2022   String context.jenkins.token\u2022 String context.job.edpName\u2022   String context.job.buildUrl\u2022  String context.job.jenkinsUrl\u2022    String context.job.metaProject\u2022   List context.job.applicationsList [['name':'application1_name','version':'application1_version],...]\u2022 String context.job.deployTemplatesDirectoryoutput:\u2022   List context.job.updatedApplicaions [['name':'application1_name','version':'application1_version],...]   name = \"automation-tests\", buildTool = null, type = nullcontext required:- String context.workDir- StageFactory context.factory- String context.gerrit.credentialsId- String context.autotest.config.cloneUrl- String context.autotest.name- String context.job.stageWithoutPrefixName- String context.buildTool.settings- String context.autotest.config.report_framework name = \"promote-images\"buildTool = nulltype = nullcontext required:- String context.workDir- String context.buildTool.sln_filename- List context.job.updatedApplicaions [['name':'application1_name','version':'application1_version],...]"},{"location":"user-guide/pipeline-framework/#how-to-redefine-or-extend-edp-pipeline-stages-library_1","title":"How to Redefine or Extend EDP Pipeline Stages Library","text":"<p>Info</p> <p>Currently, the redefinition of Deploy pipeline stages is prohibited.</p>"},{"location":"user-guide/pipeline-framework/#using-edp-library-stages-in-the-pipeline","title":"Using EDP Library Stages in the Pipeline","text":"<p>In order to use the EDP stages, the created pipeline should fit some requirements, that`s why a developer has to do the following:</p> <ul> <li>import libraries - @Library(['edp-library-stages', 'edp-library-pipelines']) _</li> <li>import reference EDP classes(See example below)</li> <li>define context Map \u2013 context = [:]</li> <li>define reference \"init\" stage</li> </ul> <p>After that, there is the ability to run any EDP stage beforehand by defining requirement context <code>context.job.runStage(\"Deploy\", context)</code>.</p> <p>For instance, the pipeline can look like:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nimport com.epam.edp.stages.StageFactory\nimport com.epam.edp.platform.PlatformFactory\nimport com.epam.edp.platform.PlatformType\nimport com.epam.edp.JobType\n\ncontext = [:]\n\nnode('master') {\nstage(\"Init\") {\ncontext.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)\ncontext.job = new com.epam.edp.Job(JobType.DEPLOY.value, context.platform, this)\ncontext.job.init()\ncontext.job.initDeployJob()\nprintln(\"[JENKINS][DEBUG] Created object job with type - ${context.job.type}\")\n\ncontext.nexus = new com.epam.edp.Nexus(context.job, context.platform, this)\ncontext.nexus.init()\n\ncontext.jenkins = new com.epam.edp.Jenkins(context.job, context.platform, this)\ncontext.jenkins.init()\n\ncontext.gerrit = new com.epam.edp.Gerrit(context.job, context.platform, this)\ncontext.gerrit.init()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.environment = new com.epam.edp.Environment(context.job.deployProject, context.platform, this)\ncontext.job.printDebugInfo(context)\ncontext.job.setDisplayName(\"${currentBuild.displayName}-${context.job.deployProject}\")\n\ncontext.job.generateInputDataForDeployJob()\n}\n\nstage(\"Pre Deploy Custom stage\") {\nprintln(\"Some custom pre deploy logic\")\n}\n\ncontext.job.runStage(\"Deploy\", context)\n\nstage(\"Post Deploy Custom stage\") {\nprintln(\"Some custom post deploy logic\")\n}\n}\n</code></pre> <p>Or in a declarative way:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nimport com.epam.edp.stages.StageFactory\nimport com.epam.edp.platform.PlatformFactory\nimport com.epam.edp.platform.PlatformType\nimport com.epam.edp.JobType\n\ncontext = [:]\n\npipeline {\nagent { label 'master'}\nstages {\nstage('Init') {\nsteps {\nscript {\ncontext.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)\ncontext.job = new com.epam.edp.Job(JobType.DEPLOY.value, context.platform, this)\ncontext.job.init()\ncontext.job.initDeployJob()\nprintln(\"[JENKINS][DEBUG] Created object job with type - ${context.job.type}\")\n\ncontext.nexus = new com.epam.edp.Nexus(context.job, context.platform, this)\ncontext.nexus.init()\n\ncontext.jenkins = new com.epam.edp.Jenkins(context.job, context.platform, this)\ncontext.jenkins.init()\n\ncontext.gerrit = new com.epam.edp.Gerrit(context.job, context.platform, this)\ncontext.gerrit.init()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.environment = new com.epam.edp.Environment(context.job.deployProject, context.platform, this)\ncontext.job.printDebugInfo(context)\ncontext.job.setDisplayName(\"${currentBuild.displayName}-${context.job.deployProject}\")\n\ncontext.job.generateInputDataForDeployJob()\n}\n}\n}\nstage('Deploy') {\nsteps {\nscript {\ncontext.factory.getStage(\"deploy\").run(context)\n}\n}\n}\n\nstage('Custom stage') {\nsteps {\nprintln(\"Some custom logic\")\n}\n}\n}\n}\n</code></pre>"},{"location":"user-guide/pipeline-framework/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add CD Pipeline</li> <li>CI Pipeline Details</li> <li>CD Pipeline Details</li> <li>Customize CI Pipeline</li> <li>Customize CD Pipeline</li> <li>EDP Stages</li> <li>Glossary</li> <li>Use Terraform Library in EDP</li> </ul>"},{"location":"user-guide/pipeline-stages/","title":"Pipeline Stages","text":"<p>Get acquainted with EDP CI/CD workflow and stages description.</p>"},{"location":"user-guide/pipeline-stages/#edp-cicd-workflow","title":"EDP CI/CD Workflow","text":"<p>Within EDP, the pipeline framework comprises the following pipelines:</p> <ul> <li>Code Review;</li> <li>Build;</li> <li>Deploy.</li> </ul> <p>Note</p> <p>Please refer to the EDP Pipeline Framework page for details.</p> <p>The diagram below shows the delivery path through these pipelines and the respective stages. Please be aware that stages may differ for different codebase types.</p> <p> stages </p>"},{"location":"user-guide/pipeline-stages/#stages-description","title":"Stages Description","text":"<p>The table below provides the details on all the stages in the EDP pipeline framework:</p> Name Dependency Description Pipeline Application Library Autotest Source code Documentation init Initiates information gathering Create Release, Code Review, Build + + Build.groovy checkout Performs for all files the checkout from a selected branch of the Git repository. For the main branch - from HEAD, for code review - from the commit Create Release, Build + + Checkout.groovy sast Launches vulnerability testing via Semgrep scanner. Pushes a vulnerability report to the DefectDojo. Build + Security compile Compiles the code, includes individual groovy files for each type of app or lib (NPM, DotNet, Python, Maven, Gradle) Code Review, Build + + Compile tests Launches testing procedure, includes individual groovy files for each type of app or lib Code Review, Build + + + Tests sonar Launches testing via SonarQube scanner and includes individual groovy files for each type of app or lib Code Review, Build + + Sonar build Builds the application, includes individual groovy files for each type of app or lib (Go, Maven, Gradle, NPM) Code Review, Build + Build create-branch EDP create-release process Creates default branch in Gerrit during create and clone strategies Create Release + + + CreateBranch.groovy trigger-job EDP create-release process Triggers \"build\" job Create Release + + + TriggerJob.groovy gerrit-checkout Performs checkout to the current project branch in Gerrit Code Review + + + GerritCheckout.groovy commit-validate Optional in EDP Admin Console Takes Jira parameters, when \"Jira Integration\" is enabled for the project in the Admin Console. Code Review + + CommitValidate.groovy dockerfile-lint Launches linting tests for Dockerfile Code Review + LintDockerApplicationLibrary.groovy Use Dockerfile Linters for Code Review dockerbuild-verify \"Build\" stage (if there are no \"COPY\" layers in Dockerfile) Launches build procedure for Dockerfile without pushing an image to the repository Code Review + BuildDockerfileApplicationLibrary.groovy Use Dockerfile Linters for Code Review helm-lint Launches linting tests for deployment charts Code Review + LintHelmApplicationLibrary.groovy Use helm-lint for Code Review helm-docs Checks generated documentation for deployment charts Code Review + HelmDocsApplication.groovy Use helm-docs for Code Review helm-uninstall Helm release deletion step to clear Helm releases Deploy + HelmUninstall.groovy Helm release deletion semi-auto-deploy-input Provides auto deploy with timeout and manual deploy flow Deploy + SemiAutoDeployInput.groovy Semi Auto Deploy get-version Defines the versioning of the project depending on the versioning schema selected in Admin Console Build + + GetVersion terraform-plan AWS credentials added to Jenkins Checks Terraform version, and installs default version if necessary, and launches terraform init, returns AWS username which used for action, and terraform plan command is called with an output of results to .tfplan file Build + TerraformPlan.groovy Use Terraform library in EDP terraform-apply AWS credentials added to Jenkins, the \"Terraform-plan\" stage Checks Terraform version, and installs default version if necessary, and launches terraform init, launches terraform plan from saves before .tfplan file, asks to approve, and run terraform apply from .tfplan file Build + TerraformApply.groovy Use Terraform library in EDP build-image-from-dockerfile Platform: OpenShift Builds Dockerfile Build + + .groovy files for building Dockerfile image build-image-kaniko Platform: k8s Builds Dockerfile using the Kaniko tool Build + BuildImageKaniko.groovy push Pushes an artifact to the Nexus repository Build + + Push create-Jira-issue-metadata \"get-version\" stage Creates a temporary CR in the namespace and after that pushes Jira Integration data to Jira ticket, and delete CR Build + + JiraIssueMetadata.groovy ecr-to-docker DockerHub credentials added to Jenkins Copies the docker image from the ECR project registry to DockerHub via the Crane tool after it is built Build + EcrToDocker.groovy Promote Docker Images From ECR to Docker Hub git-tag \"Get-version\" stage Creates a tag in SCM for the current build Build + + GitTagApplicationLibrary.groovy deploy Deploys the application Deploy + Deploy.groovy manual Works with the manual approve to proceed Deploy + ManualApprove.groovy promote-images Promotes docker images to the registry Deploy + PromoteImage.groovy <p>Note</p> <p>The Create Release pipeline is an internal EDP mechanism for adding, importing or cloning a codebase. It is not a part of the pipeline framework.</p>"},{"location":"user-guide/pipeline-stages/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Jenkins CI Job Provisioner</li> <li>GitLab Webhook Configuration</li> <li>GitHub Webhook Configuration</li> </ul>"},{"location":"user-guide/prepare-for-release/","title":"Prepare for Release","text":"<p>After the necessary applications are added to EDP, they can be managed via the Admin Console. To prepare for the release, create a new branch from a selected commit with a set of CI pipelines (Code Review and Build pipelines), launch the Build pipeline, and add a new CD pipeline as well.</p> <p>Note</p> <p>Please refer to the Add Application and Add CD Pipeline for the details on how to add an application or a CD pipeline.</p> <p>Become familiar with the following preparation steps for release and a CD pipeline structure:</p> <ul> <li>Create a new branch</li> <li>Launch the Build pipeline</li> <li>Add a new CD pipeline</li> <li>Check CD pipeline structure</li> </ul>"},{"location":"user-guide/prepare-for-release/#create-a-new-branch","title":"Create a New Branch","text":"<ol> <li> <p>Open Gerrit via the Admin Console Overview page to have this tab available in a web browser.</p> </li> <li> <p>Being in Admin Console, open the Applications section and click an application from the list to create a new branch.</p> </li> <li> <p>Once clicked the application name, scroll down to the Branches menu and click the Create button to open the Create New Branch dialog box, fill in the Branch Name field by typing a branch name.</p> <ul> <li>Open the Gerrit tab in the web browser, navigate to Projects \u2192 List \u2192 select the application \u2192 Branches \u2192 gitweb for a necessary branch.</li> </ul> <ul> <li>Select the commit that will be the last included to a new branch commit.</li> </ul> <ul> <li>Copy to clipboard the commit hash.</li> </ul> </li> <li> <p>Paste the copied hash to the From Commit Hash field and click Proceed.</p> </li> </ol> <p>Note</p> <p>If the commit hash is not added to the From Commit Hash field, the new branch will be created from the head of the master branch.</p>"},{"location":"user-guide/prepare-for-release/#launch-the-build-pipeline","title":"Launch the Build Pipeline","text":"<ol> <li> <p>After the new branches are added, open the details page of every application and click the CI link that refers to Jenkins.</p> <p>Note</p> <p>The adding of a new branch may take some time. As soon as the new branch is created, it will be displayed in the list of the Branches menu.</p> </li> <li> <p>To build a new version of a corresponding Docker container (an image stream in OpenShift terms) for the new branch, start the Build pipeline. Being in Jenkins, select the new branch tab and click the link to the Build pipeline.</p> </li> <li> <p>Navigate to the Build with Parameters option and click the Build button to launch the Build pipeline.</p> <p>Warning</p> <p>The predefined default parameters should not be changed when triggering the Build pipeline, otherwise, it will lead to the pipeline failure.</p> </li> </ol>"},{"location":"user-guide/prepare-for-release/#add-a-new-cd-pipeline","title":"Add a New CD Pipeline","text":"<ol> <li> <p>Add a new CD pipeline and indicate the new release branch using the Admin console tool. Pay attention to the Applications menu, the necessary application(s) should be selected there, as well as the necessary branch(es) from the drop-down list.</p> <p>Note</p> <p>For the details on how to add a CD pipeline, please refer to the Add CD Pipeline page.</p> </li> <li> <p>As soon as the Build pipelines are successfully passed in Jenkins, the Docker Registry, which is used in EDP by default, will have the new image streams (Docker container in Kubernetes terms) version that corresponds to the current branch.</p> </li> <li> <p>Open the Kubernetes/OpenShift page of the project via the Admin Console Overview page \u2192 go to CodebaseImageStream (in OpenShift, go to Builds \u2192 Images) \u2192 check whether the image streams are created under the specific name (the combination of the application and branch names) and the specific tags are added. Click every image stream link.</p> </li> </ol>"},{"location":"user-guide/prepare-for-release/#check-cd-pipeline-structure","title":"Check CD Pipeline Structure","text":"<p>When the CD pipeline is added through the Admin Console, it becomes available in the CD pipelines list. Every pipeline has the details page with the additional information. To explore the CD pipeline structure, follow the steps below:</p> <ol> <li> <p>Open Admin Console and navigate to Continuous Delivery section, click the newly created CD pipeline name.</p> </li> <li> <p>Discover the CD pipeline components:</p> <ul> <li>Applications - the list of applications with the image streams and links to Jenkins for the respective branch;</li> </ul> <ul> <li>Stages - a set of stages with the defined characteristics and links to Kubernetes/OpenShift project;</li> </ul> <p>Note</p> <p>Initially, an environment is empty and does not have any deployment unit. When deploying the subsequent stages, the artifacts of the selected versions will be deployed to the current project and the environment will display the current stage status. The project has a standard pattern: \u2039edp-name\u203a-\u2039pipeline-name\u203a-\u2039stage-name\u203a.</p> <ul> <li>Deployed Versions - the deployment status of the specific application and the predefined stage.</li> </ul> </li> </ol>"},{"location":"user-guide/prepare-for-release/#launch-cd-pipeline-manually","title":"Launch CD Pipeline Manually","text":"<p>Follow the steps below to deploy the QA and UAT application stages:</p> <ol> <li> <p>As soon as the Build pipelines for both applications are successfully passed, the new version of the Docker container will appear, thus allowing to launch the CD pipeline. Simply navigate to Continuous Delivery and click the pipeline name to open it in Jenkins.</p> </li> <li> <p>Click the QA stage link.</p> </li> <li> <p>Deploy the QA stage by clicking the Build Now option.</p> </li> <li> <p>After the initialization step starts, in case another menu is opened, the Pause for Input option will appear. Select the application version in the drop-down list and click Proceed. The pipeline passes the following stages:</p> <ul> <li>Init - initialization of the Jenkins pipeline outputs with the stages that are the Groovy scripts that execute the current code;</li> <li>Deploy - the deployment of the selected versions of the docker container and third-party services. As soon as the Deployed pipeline stage is completed, the respective environment will be deployed.</li> <li>Approve - the verification stage that enables to Proceed or Abort this stage;</li> <li>Promote-images - the creation of the new image streams for the current versions with the pattern combination: [pipeline name]-[stage name]-[application name]-[verified];</li> </ul> <p>After all the stages are passed, the new image streams will be created in the Kubernetes/OpenShift with the new names.</p> </li> <li> <p>Deploy the UAT stage, which takes the versions that were verified during the QA stage, by clicking the Build Now option, and select the necessary application versions. The launch process is the same as for all the deploy pipelines.</p> </li> <li> <p>To get the status of the pipeline deployment, open the CD pipeline details page and check the Deployed versions state.</p> </li> </ol>"},{"location":"user-guide/prepare-for-release/#cd-pipeline-as-a-team-environment","title":"CD Pipeline as a Team Environment","text":"<p>Admin Console allows creating a CD pipeline with a part of the application set as a team environment. To do this, perform the following steps;</p> <ol> <li>Open the Continuous Delivery section \u2192 click the Create button \u2192 enter the pipeline name (e.g. team-a) \u2192 select ONE application and choose the master branch for it \u2192 add one DEV stage.</li> <li>As soon as the CD pipeline is added to the CD pipelines list, its details page will display the links to Jenkins and Kubernetes/OpenShift.</li> <li>Open Jenkins and deploy the DEV stage by clicking the Build Now option.</li> <li>Kubernetes/OpenShift keeps an independent environment that allows checking the new versions, thus speeding up the developing process when working with several microservices.</li> </ol> <p>As a result, the team will have the same abilities to verify the code changes when developing and during the release.</p>"},{"location":"user-guide/prepare-for-release/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add CD Pipeline</li> <li>Autotest as Quality Gate</li> <li>Build Pipeline</li> <li>CD Pipeline Details</li> <li>Customize CD Pipeline</li> </ul>"},{"location":"user-guide/semi-auto-deploy/","title":"Semi Auto Deploy","text":"<p>The Semi Auto Deploy stage provides the ability to deploy applications with the custom logic that comprises the following behavior:</p> <ul> <li>When the build of an application selected for deploy in the CD pipeline is completed, the Deploy pipeline is automatically triggered;</li> <li>By default, the deploy stage waits for 5 minutes, and if the user does not interfere with the process (cancels or selects certain versions of the application to deploy), then the deploy stage will deploy the latest versions of all applications;</li> <li>The stage can be used in the manual mode.</li> </ul> <p>To enable the Semi Auto Deploy stage during the deploy process, follow the steps below:</p> <ol> <li>Create or update the CD pipeline: make sure the trigger type for the stage is set to auto.</li> <li>Replace the <code>{\"name\":\"auto-deploy-input\",\"step_name\":\"auto-deploy-input\"}</code> step to the <code>{\"name\":\"semi-auto-deploy-input\",\"step_name\":\"semi-auto-deploy-input\"}</code> step in the CD pipeline. Alternatively, it is possible to create a custom job provisioner with this step.</li> <li>Run the Build pipeline for any application selected in the CD pipeline.</li> </ol>"},{"location":"user-guide/semi-auto-deploy/#exceptional-cases","title":"Exceptional Cases","text":"<p>After the timeout starts and in case the pipeline has been interrupted not from the Input requested menu, the automatic deployment will be proceeding. To resolve the issue and stop the pipeline, click the Input requested menu -&gt; Abort or being on the pipeline UI, click the Abort button.</p>"},{"location":"user-guide/semi-auto-deploy/#related-articles","title":"Related Articles","text":"<ul> <li>Add CD Pipeline</li> <li>Customize CD Pipeline</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/terraform-stages/","title":"CI Pipelines for Terraform","text":"<p>EPAM Delivery Platform ensures the implemented Terraform support by adding a separate component type called Infrastructure. The Infrastructure codebase type allows to work with Terraform code that is processed by means of stages in the Code-Review and Build pipelines.</p>"},{"location":"user-guide/terraform-stages/#pipeline-stages-for-terraform","title":"Pipeline Stages for Terraform","text":"<p>Under the hood, Infrastructure codebase type, namely Terraform, looks quite similar to other codebase types. The distinguishing characterstic of the Infrastructure codebase type is that there is a stage called terraform-check in both of Code Review and Build pipelines. This stage runs the pre-commit activities which in their turn run the following commands and tools:</p> <ol> <li> <p>Terraform fmt - the first step of the stage is basically the <code>terraform fmt</code> command. The <code>terraform fmt</code> command automatically updates the formatting of Terraform configuration files to follow the standard conventions and make the code more readable and consistent.</p> </li> <li> <p>Lock provider versions - locks the versions of the Terraform providers used in the project. This ensures that the project uses specific versions of the providers and prevents unexpected changes from impacting the infrastructure due to newer provider versions.</p> </li> <li> <p>Terraform validate - checks the syntax and validity of the Terraform configuration files. It scans the configuration files for all possible issues.</p> </li> <li> <p>Terraform docs - generates human-readable documentation for the Terraform project.</p> </li> <li> <p>Tflint - additional validation step using the <code>tflint</code> linter to provide more in-depth checks in addition to what the <code>terraform validate</code> command does.</p> </li> <li> <p>Checkov - runs the <code>checkov</code> command against the Terraform codebase to identify any security misconfigurations or compliance issues.</p> </li> <li> <p>Tfsec - another security-focused validation step using the <code>tfsec</code> command. Tfsec is a security scanner for Terraform templates that detects potential security issues and insecure configurations in the Terraform code.</p> </li> </ol> <p>Note</p> <p>The commands and their attributes are displayed in the .pre-commit-config.yaml file.</p>"},{"location":"user-guide/terraform-stages/#related-articles","title":"Related Articles","text":"<ul> <li>User Guide Overview</li> <li>Add Infrastructure</li> <li>Manage Infrastructures</li> </ul>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"faq/","title":"FAQ","text":""},{"location":"faq/#how-do-i-set-parallel-reconciliation-for-a-number-of-codebase-branches","title":"How Do I Set Parallel Reconciliation for a Number of Codebase Branches?","text":"<p>Set the CODEBASE_BRANCH_MAX_CONCURRENT_RECONCILES Env variable in codebase-operator by updating Deployment template. For example:</p> <pre><code>          ...\n          env:\n            - name: WATCH_NAMESPACE\n          ...\n\n            - name: CODEBASE_BRANCH_MAX_CONCURRENT_RECONCILES\n              value: 10\n...\n</code></pre> <p>It's not recommended to set the value above 10.</p>"},{"location":"faq/#how-to-change-the-lifespan-of-an-access-token-that-is-used-for-edp-portal-and-oidc-login-plugin","title":"How To Change the Lifespan of an Access Token That Is Used for EDP Portal and 'oidc-login' Plugin?","text":"<p>Change the Access Token Lifespan: go to your Keycloak and select Openshift realm &gt; Realm settings &gt; Tokens &gt; Access Token Lifespan &gt; set a new value to the field and save this change.</p> <p>By default, \"Access Token Lifespan\" value is 5 minutes.</p> <p> Access Token Lifespan </p>"},{"location":"features/","title":"Basic Concepts","text":"<p>Consult EDP Glossary section for definitions mentioned on this page and EDP Toolset to have a full list of tools used with the Platform. The below table contains a full list of features provided by EDP.</p> Features Description Cloud Agnostic EDP runs on Kubernetes cluster, so any Public Cloud Provider which provides Kubernetes can be used. Kubernetes clusters deployed on-premises work as well CI/CD for Microservices EDP is initially designed to support CI/CD for Microservices running as containerized applications inside Kubernetes Cluster. EDP also supports CI for:- Terraform Modules, - Open Policy Rules,- Workflows for Java (8,11,17), JavaScript (React, Vue, Angular, Express, Antora), C# (.NET 6.0), Python (FastAPI, Flask, 3.8), Go (Beego, Operator SDK) Version Control System (VCS) EDP installs Gerrit as a default Source Code Management (SCM) tool. EDP also supports GitHub and GitLab integration Branching Strategy EDP supports Trunk-based development as well as GitHub/GitLab flow. EDP creates two Pipelines per each codebase branch (see Pipeline Framework): Code Review and Build Repository Structure EDP provides separate Git repository per each Codebase and doesn't work with Monorepo. However, EDP does support customization and runs helm-lint, dockerfile-lint steps using Monorepo approach. Artifacts Versioning EDP supports two approaches for Artifacts versioning: - default (BRANCH-[TECH_STACK_VERSION]-BUILD_ID)- EDP (MAJOR.MINOR.PATCH-BUILD_ID), which is SemVer.Custom versioning can be created by implementing get-version stage Application Library EDP provides baseline codebase templates for Microservices, Libraries, within create strategy while onboarding new Codebase Stages Library Each EDP Pipeline consists of pre-defined steps (stages). Consult library documentation for more details CI Pipelines EDP provides CI Pipelines for first-class citizens: - Applications (Microservices) based on Java (8,11,17), JavaScript (React, Vue, Angular, Express, Antora), C# (.NET 6.0), Python (FastAPI, Flask, 3.8), Go (Beego, Operator SDK)- Libraries based on Java (8,11,17), JavaScript (React, Vue, Angular, Express), Python (FastAPI, Flask, 3.8), Groovy Pipeline (Codenarc), Terraform, Rego (OPA), Container (Docker), Helm (Pipeline), C#(.NET 6.0)- Autotests based on Java8, Java11, Java17 CD Pipelines EDP provides capabilities to design CD Pipelines (in Admin Console) for Microservices and defines logic for artifacts flow (promotion) from env to env. Artifacts promotion is performed automatically (Autotests), manually (User Approval) or combining both approaches Autotests EDP provides CI pipeline for autotest implemented in Java. Autotests can be used as Quality Gates in CD Pipelines Custom Pipeline Library EDP can be extended by introducing Custom Pipeline Library Dynamic Environments Each EDP CD Pipeline creates/destroys environment upon user requests"},{"location":"getting-started/","title":"Quick Start","text":""},{"location":"getting-started/#software-requirements","title":"Software Requirements","text":"<ul> <li>Kubernetes cluster 1.23+ or OpenShift 4.9+;</li> <li>Kubectl tool;</li> <li>Helm 3.10.x+;</li> <li>Keycloak 18.0+;</li> <li>(Optional) Kiosk 0.2.11.</li> </ul>"},{"location":"getting-started/#minimal-hardware-requirements","title":"Minimal Hardware Requirements","text":"<p>The system should have the following specifications to run properly:</p> <ul> <li>CPU: 8 Core</li> <li>Memory: 32 Gb</li> </ul>"},{"location":"getting-started/#edp-toolset","title":"EDP Toolset","text":"<p>EPAM Delivery Platform supports the following tools:</p> Domain Related Tools/Solutions Artifacts Management Nexus Repository, Jfrog Artifactory AWS IRSA, AWS ECR, AWS EFS, Parameter Store, S3, ALB/NLB, Route53 Build .NET, Go, Apache Gradle, Apache Maven, NPM Cluster Backup Velero Code Review Gerrit, GitLab, GitHub Container Registry AWS ECR, OpenShift Registry, Harbor, DockerHub Containers Hadolint, Kaniko, Crane Documentation as Code MkDocs, Antora (AsciiDoc) Infrastructure as Code Terraform, TFLint, Terraform Docs, Crossplane, AWS Controllers for Kubernetes Kubernetes Deployment Kubectl, Helm, Helm Docs, Chart Testing, Argo CD, Argo Rollout Kubernetes Multitenancy Kiosk, Capsule Logging OpenSearch, EFK, ELK, Loki, Splunk Monitoring Prometheus, Grafana, VictoriaMetrics Pipeline Orchestration Tekton Policies/Rules Open Policy Agent Secrets Management External Secret Operator, Vault, AWS Parameter Store Secure Development SonarQube, DefectDojo, Dependency Track,  Semgrep, Grype, Trivy, Clair, GitLeaks, CycloneDX Generator, tfsec, checkov SSO Keycloak, oauth2-proxy Test Report Tool ReportPortal, Allure Tracing OpenTelemetry, Jaeger"},{"location":"getting-started/#install-edp","title":"Install EDP","text":"<p>To install EDP with the necessary parameters, please refer to the Install EDP section of the Operator Guide. Mind the parameters in the EDP installation chart. For details, please refer to the values.yaml.</p> <p>Find below the example of the installation command:</p> <pre><code>    helm install edp epamedp/edp-install --wait --timeout=900s \\\n    --set global.dnsWildCard=&lt;cluster_DNS_wildcard&gt; \\\n    --set global.platform=&lt;platform_type&gt; \\\n    --set awsRegion=&lt;region&gt; \\\n    --namespace edp\n</code></pre> <p>Warning</p> <p>Please be aware that the command above is an example.</p>"},{"location":"getting-started/#related-articles","title":"Related Articles","text":"<p>Getting Started</p>"},{"location":"glossary/","title":"Glossary","text":"<p>Get familiar with the definitions and context for the most useful EDP terms presented in table below.</p> Terms Details EDP Component - an item used in CI/CD process EDP Portal UI - an EDP component that helps to manage, set up, and control the business entities. Artifactory - an EDP component that stores all the binary artifacts. NOTE: Nexus is used as a possible implementation of a repository. CI/CD Server - an EDP component that launches pipelines that perform the build, QA, and deployment code logic. NOTE: Jenkins is used as a possible implementation of a CI/CD server. Code Review tool - an EDP component that collaborates with the changes in the codebase. NOTE: Gerrit is used as a possible implementation of a code review tool. Identity Server - an authentication server providing a common way to verify requests to all of the applications. NOTE: Keycloak is used as a possible implementation of an identity server. Security Realm Tenant - a realm in identity server (e.g Keycloak) where all users' accounts and their access permissions are managed. The realm is unique for the identity server instance. Static Code Analyzer - an EDP component that inspects continuously a code quality before the necessary changes appear in a master branch. NOTE: SonarQube is used as a possible implementation of a static code analyzer. VCS (Version Control System) - a replication of the Gerrit repository that displays all the changes made by developers. NOTE: GitHub and GitLab are used as the possible implementation of a repository with the version control system. EDP Business Entity - a part of the CI/CD process (the integration, delivery, and deployment of any codebase changes) Application - a codebase type that is built as the binary artifact and deployable unit with the code that is stored in VCS. As a result, the application becomes a container and can be deployed in an environment. Autotests - a codebase type that inspects a product (e.g. an application set) on a stage. Autotests are not deployed to any container and launched from the respective code stage. CD Pipeline (Continuous Delivery Pipeline) - an EDP business entity that describes the whole delivery process of the selected application set via the respective stages. The main idea of the CD pipeline is to promote the application version between the stages by applying the sequential verification (i.e. the second stage will be available if the verification on the first stage is successfully completed). NOTE: The CD pipeline can include the essential set of applications with its specific stages as well. CD Pipeline Stage - an EDP business entity that is presented as the logical gate required for the application set inspection. Every stage has one OpenShift project where the selected application set is deployed. All stages are sequential and promote applications one-by-one. Codebase - an EDP business entity that possesses a code. Codebase Branch - an EDP business entity that represents a specific version in a Git branch. Every codebase branch has a Codebase Docker Stream entity. Codebase Docker Stream - a deployable component that leads to the application build and displays that the last build was verified on the specific stage. Every CD pipeline stage accepts a set of Codebase Docker Streams (CDS) that are input and output. SAMPLE: if an application1 has a master branch, the input CDS will be named as [app name]-[pipeline name]-[stage name]-[master] and the output after the passing of the DEV stage will be as follows: [app name]-[pipeline name]-[stage name]-[dev]-[verified]. Library - a codebase type that is built as the binary artifact, i.e. it`s stored in the Artifactory and can be uploaded by other applications, autotests or libraries. Quality Gate - an EDP business entity that represents the minimum acceptable results after the testing. Every stage has a quality gate that should be passed to promote the application. The stage quality gate can be a manual approve from a QA specialist OR a successful autotest launch. Quality Gate Type - this value defines trigger type that promotes artifacts (images) to the next environment in CD Pipeline. There are manual and automatic types of quality gates. The manual type means that the promoting process should be confirmed in Jenkins. The automatic type promotes the images automatically in case there are no errors in the Allure Report. NOTE: If any of the test types is not passed, the CD pipeline will fail. Trigger Type - a value that defines a trigger type used for the CD pipeline triggering. There are manual and automatic types of triggering. The manual type means that the CD pipeline should be triggered manually. The automatic type triggers the CD pipeline automatically as soon as the Codebase Docker Stream was changed. EDP CI/CD Pipelines Framework - a library that allows extending the Jenkins pipelines and stages to develop an application. Pipelines are presented as the shared library that can be connected in Jenkins. The library is connected using the Git repository link (a public repository that is supported by EDP) on the GitHub. Allure Report- a tool that represents test results in one brief report in a clear form. Automated Tests - different types of automated tests that can be run on the environment for a specific stage. Build Pipeline - a Jenkins pipeline that builds a corresponding codebase branch in the Codebase. Build Stage - a stage that takes place after the code has been submitted/merged to the repository of the main branch (the pull request from the feature branch is merged to the main one, the Patch set is submitted in Gerrit). Code Review Pipeline - a Jenkins pipeline that inspects the code candidate in the Code Review tool. Code Review Stage - a stage where code is reviewed before it goes to the main branch repository of the version control system (the commit to the feature branch is pushed, the Patch set is created in Gerrit). Deploy Pipeline - a Jenkins pipeline that is responsible for the CD Pipeline Stage deployment with the full set of applications and autotests. Deployment Stage - a part of the Continuous Delivery where artifacts are being deployed to environments. EDP CI/CD Pipelines - an orchestrator for stages that is responsible for the common technical events, e.g. initialization, in Jenkins pipeline. The set of stages for the pipeline is defined as an input JSON file for the respective Jenkins job. NOTE: There is the ability to create the necessary realization of the library pipeline on your own as well. EDP CI/CD Stages - a repository that is launched in the Jenkins pipeline. Every stage is presented as an individual Groovy file in a corresponding repository. Such single responsibility realization allows rewriting of one essential stage without changing the whole pipeline. Environment - a part of the stage where the built and packed into an image application are deployed for further testing. It`s possible to deploy several applications to several environments (Team and Integration environments) within one stage. Integration Environment - an environment type that is always deployed as soon as the new application version is built in order to launch the integration test and promote images to the next stages. The Integration Environment can be triggered manually or in case a new image appears in the Docker registry. Jenkinsfile - a text file that keeps the definition of a Jenkins Pipeline and is checked into source control. Every Job has its Jenkinsfile that is stored in the specific application repository and in Jenkins as the plain text. Jenkins Node - a machine that is a part of the Jenkins environment that is capable of executing a pipeline. Jenkins Pipeline - a user-defined model of a CD pipeline. The pipeline code defines the entire build process. Jenkins Stage - a part of the whole CI/CD process that should pass the source code in order to be released and deployed on the production. Team Environment - an environment type that can be deployed at any time by the manual trigger of the Deploy pipeline where team or developers can check out their applications. NOTE: The promotion from such kind of environment is prohibited and developed only for the local testing. OpenShift / Kubernetes (K8S) ConfigMap - a resource that stores configuration data and processes the strings that do not contain sensitive information. Docker Container - is a lightweight, standalone, and executable package. Docker Registry - a store for the Docker Container that is created for the application after the Build pipeline performance. OpenShift Web Console - a web console that enables to view, manage, and change OpenShift / K8S resources using browser. Operator Framework - a deployable unit in OpenShift that is responsible for one or a set of resources and performs its life circle (adding, displaying, and provisioning). Path - a route component that helps to find a specified path (e.g. /api) at once and skip the other. Pod - the smallest deployable unit of the large microservice application that is responsible for the application launch. The pod is presented as the one launched Docker container. When the Docker container is collected, it will be kept in Docker Registry and then saved as Pod in the OpenShift project. NOTE: The Deployment Config is responsible for the Pod push, restart, and stop processes. PV (Persistent Volume) - a cluster resource that captures the details of the storage implementation and has an independent lifecycle of any individual pod. PVC (Persistent Volume Claim) - a user request for storage that can request specific size and access mode. PV resources are consumed by PVCs. Route - a resource in OpenShift that allows getting the external access to the pushed application. Secret - an object that stores and manages all the sensitive information (e.g. passwords, tokens, and SSH keys). Service - an external connection point with Pod that is responsible for the network. A specific Service is connected to a specific Pod using labels and redirects all the requests to Pod as well. Site - a route component (link name) that is created from the indicated application name and applies automatically the project name and a wildcard DNS record."},{"location":"overview/","title":"Overview","text":"<p>EPAM Delivery Platform (EDP) is an open-source cloud-agnostic SaaS/PaaS solution for software development, licensed under Apache License 2.0. It provides a pre-defined set of CI/CD patterns and tools, which allow a user to start product development quickly with established code review, release, versioning, branching, build processes. These processes include static code analysis, security checks, linters, validators, dynamic feature environments provisioning. EDP consolidates the top Open-Source CI/CD tools by running them on Kubernetes/OpenShift, which enables web/app development either in isolated (on-prem) or cloud environments.</p> <p>EPAM Delivery Platform, which is also called \"The Rocket\", is a platform that allows shortening the time that is passed before an active development can be started from several months to several hours.</p> <p>EDP consists of the following:</p> <ul> <li>The platform based on managed infrastructure and container orchestration</li> <li>Security covering authentication, authorization, and SSO for platform services</li> <li>Development and testing toolset</li> <li>Well-established engineering process and EPAM practices (EngX) reflected in CI/CD pipelines, and delivery analytics</li> <li>Local development with debug capabilities</li> </ul>"},{"location":"overview/#features","title":"Features","text":"<ul> <li>Deployed and configured CI/CD toolset (Tekton, ArgoCD, Jenkins, Nexus, SonarQube, DefectDojo)</li> <li>Gerrit, GitLab or GitHub as a version control system for your code</li> <li>Tekton is a default pipeline orchestrator</li> <li>Jenkins is an optional pipeline orchestrator</li> <li> <p>CI pipelines</p> Tekton (by default)Jenkins (optional) Language Framework Build Tool Application Library Autotest Java Java 8, Java 11, Java 17 Gradle, Maven Python Python 3.8, FastAPI, Flask Python C# .Net 3.1, .Net 6.0 .Net Go Beego, Gin, Operator SDK Go JavaScript React, Vue, Angular, Express, Next.js, Antora NPM HCL Terraform Terraform Helm Helm, Pipeline Helm Groovy Codenarc Codenarc Rego OPA OPA Container Docker Kaniko Language Framework Build Tool Application Library Autotest Java Java 8, Java 11 Gradle, Maven Python Python 3.8 Python .Net .Net 3.1 .Net Go Beego, Operator SDK Go JavaScript React NPM HCL Terraform Terraform Groovy Codenarc Codenarc Rego OPA OPA Container Docker Kaniko </li> </ul> <ul> <li>Portal UI as a single entry point</li> <li>CD pipeline for Microservice Deployment</li> <li>Kubernetes native approach (CRD, CR) to declare CI/CD pipelines</li> </ul>"},{"location":"overview/#whats-inside","title":"What's Inside","text":"<p>EPAM Delivery Platform (EDP) is suitable for all aspects of delivery starting from development including the capability to deploy production environment. EDP architecture is represented on a diagram below.</p> <p> Architecture </p> <p>EDP consists of four cross-cutting concerns:</p> <ol> <li>Infrastructure as a Service;</li> <li>GitOps approach;</li> <li>Container orchestration and centralized services;</li> <li>Security.</li> </ol> <p>On the top of these indicated concerns, EDP adds several blocks that include:</p> <ul> <li>EDP CI/CD Components. EDP component enables a feature in CI/CD or an instance artifacts storage and distribution (Nexus or Artifactory), static code analysis (Sonar), etc.;</li> <li>EDP Artifacts. This element represents an artifact that is being delivered through EDP and presented as a code. <p>Artifact samples: frontend, backend, mobile, applications, functional and non-functional autotests, workloads for 3rd party components that can be deployed together with applications.</p> </li> </ul> <ul> <li>EDP development and production environments that share the same logic. Environments wrap a set of artifacts with a specific version, and allow performing SDLC routines in order to be sure of the artifacts quality;</li> <li>Pipelines. Pipelines cover CI/CD process, production rollout and updates. They also connect three elements indicated above via automation allowing SDLC routines to be non-human;</li> </ul>"},{"location":"overview/#technology-stack","title":"Technology Stack","text":"<p>Explore the EDP technology stack diagram</p> <p> Technology stack </p> <p>The EDP IaaS layer supports most popular public clouds AWS, Azure and GCP keeping the capability to be deployed on private/hybrid clouds based on OpenStack. EDP containers are based on Docker technology, orchestrated by Kubernetes compatible solutions.</p> <p>There are two main options for Kubernetes provided by EDP:</p> <ul> <li>Managed Kubernetes in Public Clouds to avoid installation and management of Kubernetes cluster, and get all benefits of scaling, reliability of this solution;</li> <li>OpenShift that is a Platform as a Service on the top of Kubernetes from Red Hat. OpenShift is the default option for on-premise installation and it can be considered whether the solution built on the top of EDP should be cloud-agnostic or require enterprise support;</li> </ul> <p>There is no limitation to run EDP on vanilla Kubernetes.</p>"},{"location":"overview/#related-articles","title":"Related Articles","text":"<ul> <li>Quick Start</li> <li>Basic Concepts</li> <li>Glossary</li> <li>Supported Versions and Compatibility</li> </ul>"},{"location":"roadmap/","title":"RoadMap","text":"<p>RoadMap consists of three streams:</p> <ul> <li>Community</li> <li>Architecture</li> <li>Building Blocks</li> <li>Admin Console</li> <li>Documentation</li> </ul>"},{"location":"roadmap/#i-community","title":"I. Community","text":"<p>Goals:</p> <ul> <li>Innovation Through Collaboration</li> <li>Improve OpenSource Adoption</li> <li>Build Community around technology solutions EDP is built on</li> </ul>"},{"location":"roadmap/#deliver-operators-on-operatorhub","title":"Deliver Operators on OperatorHub","text":"<p>OperatorHub is a defacto leading solution which consolidates Kubernetes Community around Operators. EDP follows the best practices of delivering Operators in a quick and reliable way. We want to improve Deployment and Management experience for our Customers by publishing all EDP operators on this HUB.</p> <p>Another artifact aggregator which is used by EDP - ArtifactHub, that holds description for both components: stable and under-development.</p> <p>OperatorHub. Keycloak Operator</p> <p>EDP Keycloak Operator is now available from OperatorHub both for Upstream (Kubernetes) and OpenShift deployments.</p>"},{"location":"roadmap/#ii-architecture","title":"II. Architecture","text":"<p>Goals:</p> <ul> <li>Improve reusability for EDP components</li> <li>Integrate Kubernetes Native Deployment solutions</li> <li>Introduce abstraction layer for CI/CD components</li> <li>Build processes around the GitOps approach</li> <li>Introduce secrets management</li> </ul>"},{"location":"roadmap/#kubernetes-multitenancy","title":"Kubernetes Multitenancy","text":"<p>Multiple instances of EDP are run in a single Kubernetes cluster. One way to achieve this is to use Multitenancy. Initially, Kiosk was selected as tools that provides this capability. An alternative option that EDP Team took into consideration is Capsule. Another tool which goes far beyond multitenancy is vcluster going a good candidate for e2e testing scenarios where one needs simple lightweight kubernetes cluster in CI pipelines.</p>"},{"location":"roadmap/#microservice-reference-architecture-framework","title":"Microservice Reference Architecture Framework","text":"<p>EDP provides basic Application Templates for a number of technology stacks (Java, .Net, NPM, Python) and Helm is used as a deployment tool. The goal is to extend this library and provide: Application Templates which are built on pre-defined architecture patterns (e.g., Microservice, API Gateway, Circuit Breaker, CQRS, Event Driven) and Deployment Approaches: Canary, Blue/Green. This requires additional tools installation on cluster as well.</p>"},{"location":"roadmap/#policy-enforcement-for-kubernetes","title":"Policy Enforcement for Kubernetes","text":"<p>Running workload in Kubernetes calls for extra effort from Cluster Administrators to ensure those workloads do follow best practices or specific requirements defined on organization level. Those requirements can be formalized in policies and integrated into: CI Pipelines and Kubernetes Cluster (through Admission Controller approach) - to guarantee proper resource management during development and runtime phases. EDP uses Open Policy Agent (from version 2.8.0), since it supports compliance check for more use-cases: Kubernetes Workloads, Terraform and Java code, HTTP APIs and many others. Kyverno is another option being checked in scope of this activity.</p>"},{"location":"roadmap/#secrets-management","title":"Secrets Management","text":"<p>EDP should provide secrets management as a part of platform. There are multiple tools providing secrets management capabilities. The aim is to be aligned with GitOps and Operator Pattern approaches so HashiCorp Vault, Banzaicloud Bank Vaults, Bitnami Sealed Secrets are currently used for internal projects and some of them should be made publicly available - as a part of EDP Deployment.</p> <p>EDP Release 2.12.x</p> <p>External Secret Operator is a recommended secret management tool for the EDP components.</p>"},{"location":"roadmap/#release-management","title":"Release Management","text":"<p>Conventional Commits and Conventional Changelog are two approaches to be used as part of release process. Today EDP provides only capabilities to manage Release Branches. This activity should address this gap by formalizing and implementing Release Process as a part of EDP. Topics to be covered: Versioning, Tagging, Artifacts Promotion.</p>"},{"location":"roadmap/#kubernetes-native-cicd-pipelines","title":"Kubernetes Native CI/CD Pipelines","text":"<p>EDP uses Jenkins as Pipeline Orchestrator. Jenkins runs workload for CI and CD parts. There is also basic support for GitLab CI, but it provides Docker image build functionality only. EDP works on providing an alternative to Jenkins and use Kubernetes Native Approach for pipeline management. There are a number of tools, which provides such capability:</p> <ul> <li>Argo CD</li> <li>Argo Workflows</li> <li>Argo Rollouts</li> <li>Tekton</li> <li>Drone</li> <li>Flux</li> </ul> <p>This list is under investigation and solution is going to be implemented in two steps:</p> <ol> <li>Introduce tool that provide Continues Delivery/Deployment approach. Argo CD is one of the best to go with.</li> <li>Integrate EDP with tool that provides Continues Integration capabilities.</li> </ol> <p>EDP Release 2.12.x</p> <p>Argo CD is suggested as a solution providing the <code>Continuous Delivery</code> capabilities.</p> <p>EDP Release 3.0</p> <p>Tekton is used as a CI/CD pipelines orchestration tool on the platform. Review edp-tekton GitHub repository that keeps all the logic behind this solution on the EDP (Pipelines, Tasks, TriggerTemplates, Interceptors, etc). Get acquainted with the series of publications on our Medium Page.</p>"},{"location":"roadmap/#advanced-edp-role-based-model","title":"Advanced EDP Role-based Model","text":"<p>EDP has a number of base roles which are used across EDP. In some cases it is necessary to provide more granular permissions for specific users. It is possible to do this using Kubernetes Native approach.</p>"},{"location":"roadmap/#notifications-framework","title":"Notifications Framework","text":"<p>EDP has a number of components which need to report their statuses: Build/Code Review/Deploy Pipelines, changes in Environments, updates with artifacts. The goal for this activity is to onboard Kubernetes Native approach which provides Notification capabilities with different sources/channels integration (e.g. Email, Slack, MS Teams). Some of these tools are Argo Events, Botkube.</p>"},{"location":"roadmap/#reconciler-component-retirement","title":"Reconciler Component Retirement","text":"<p>Persistent layer, which is based on edp-db (PostgreSQL) and reconciler component should be retired in favour of Kubernetes Custom Resource (CR). The latest features in EDP are implemented using CR approach.</p> <p>EDP Release 3.0</p> <p>Reconciler component is deprecated and is no longer supported. All the EDP components are migrated to Kubernetes Custom Resources (CR).</p>"},{"location":"roadmap/#iii-building-blocks","title":"III. Building Blocks","text":"<p>Goals:</p> <ul> <li>Introduce best practices from Microservice Reference Architecture deployment and observability using Kubernetes Native Tools</li> <li>Enable integration with the Centralized Test Reporting Frameworks</li> <li>Onboard SAST/DAST tool as a part of CI pipelines and Non-Functional Testing activities</li> </ul> <p>EDP Release 2.12.x</p> <p>SAST is introduced as a mandatory part of the CI Pipelines. The list of currently supported SAST scanners and the instruction on how to add them are also available.</p>"},{"location":"roadmap/#infrastructure-as-code","title":"Infrastructure as Code","text":"<p>EDP Target tool for Infrastructure as Code (IaC) is Terraform. EDP sees two CI/CD scenarios while working with IaC: Module Development and Live Environment Deployment. Today, EDP provides basic capabilities (CI Pipelines) for Terraform Module Development. At the same time, currently EDP doesn't provide Deployment pipelines for Live Environments and the feature is under development. Terragrunt is an option to use in Live Environment deployment. Another Kubernetes Native approach to provision infrastructure components is Crossplane.</p>"},{"location":"roadmap/#database-schema-management","title":"Database Schema Management","text":"<p>One of the challenges for Application running in Kubernetes is to manage database schema. There are a number of tools which provides such capabilities, e.g. Liquibase, Flyway. Both tools provide versioning control for database schemas. There are different approaches on how to run migration scripts in Kubernetes: in init container, as separate Job or as a separate CD stage. Purpose of this activity is to provide database schema management solution in Kubernetes as a part of EDP. EDP Team investigates SchemaHero tool and use-cases which suits Kubernetes native approach for database schema migrations.</p>"},{"location":"roadmap/#open-policy-agent","title":"Open Policy Agent","text":"<p>Open Policy Agent is introduced in version 2.8.0. EDP now supports CI for Rego Language, so you can develop your own policies. The next goal is to provide pipeline steps for running compliance policies check for Terraform, Java, Helm Chart as a part of CI process.</p>"},{"location":"roadmap/#report-portal","title":"Report Portal","text":"<p>EDP uses Allure Framework as a Test Report tool. Another option is to integrate Report Portal into EDP ecosystem.</p> <p>EDP Release 3.0</p> <p>Use ReportPortal to consolidate and analyze your Automation tests results. Consult our pages on how to perform reporting and Keycloak integration.</p>"},{"location":"roadmap/#carrier","title":"Carrier","text":"<p>Carrier provides Non-functional testing capabilities.</p>"},{"location":"roadmap/#java-17","title":"Java 17","text":"<p>EDP supports two LTS versions of Java: 8 and 11. The goal is to provide Java 17 (LTS) support.</p> <p>EDP Release 3.2.1</p> <p>CI Pipelines for Java 17 is available in EDP.</p>"},{"location":"roadmap/#velero","title":"Velero","text":"<p>Velero is used as a cluster backup tool and is deployed as a part of Platform. Currently, Multitenancy/On-premise support for backup capabilities is in process.</p>"},{"location":"roadmap/#istio","title":"Istio","text":"<p>Istio is to be used as a Service Mesh and to address challenges for Microservice or Distributed Architectures.</p>"},{"location":"roadmap/#kong","title":"Kong","text":"<p>Kong is one of tools which is planned to use as an API Gateway solution provider. Another possible candidate for investigation is Ambassador API Gateway</p>"},{"location":"roadmap/#openshift-4x","title":"OpenShift 4.X","text":"<p>EDP supports the OpenShift 4.9 platform.</p> <p>EDP Release 2.12.x</p> <p>EDP Platform runs on the latest OKD versions: 4.9 and 4.10. Creating the IAM Roles for Service Account is a recommended way to work with AWS Resources from the OKD cluster.</p>"},{"location":"roadmap/#iv-admin-console-ui","title":"IV. Admin Console (UI)","text":"<p>Goals:</p> <ul> <li>Improve U\u0425 for different user types to address their concerns in the delivery model</li> <li>Introduce user management capabilities</li> <li>Enrich with traceability metrics for products</li> </ul> <p>EDP Release 2.12.x</p> <p>EDP Team has introduced a new UI component called EDP Headlamp, which will replace the EDP Admin Console in future releases. EDP Headlamp is based on the Kinvolk Headlamp UI Client.</p> <p>EDP Release 3.0</p> <p>EDP Headlamp is used as a Control Plane UI on the platform.</p> <p>EDP Release 3.4</p> <p>Since EDP v3.4.0, Headlamp UI has been renamed to EDP Portal.</p>"},{"location":"roadmap/#users-management","title":"Users Management","text":"<p>EDP uses Keycloak as an Identity and Access provider. EDP roles/groups are managed inside the Keycloak realm, then these changes are propagated across the EDP Tools. We plan to provide this functionality in EDP Portal using the Kubernetes-native approach (Custom Resources).</p>"},{"location":"roadmap/#the-delivery-pipelines-dashboard","title":"The Delivery Pipelines Dashboard","text":"<p>The CD Pipeline section in EDP Portal provides basic information, such as environments, artifact versions deployed per each environment, and direct links to the namespaces. One option is to enrich this panel with metrics from the Prometheus, custom resources, or events. Another option is to use the existing dashboards and expose EDP metrics to them, for example, plugin for Lens or OpenShift UI Console.</p>"},{"location":"roadmap/#split-jira-and-commit-validation-sections","title":"Split Jira and Commit Validation Sections","text":"<p>Commit Validate step was initially designed to be aligned with Jira Integration and cannot be used as single feature. Target state is to ensure features CommitMessage Validation and Jira Integration both can be used independently. We also want to add support for Conventional Commits.</p> <p>EDP Release 3.2.0</p> <p>EDP Portal has separate sections for Jira Integration and CommitMessage Validation step.</p>"},{"location":"roadmap/#v-documentation-as-code","title":"V. Documentation as Code","text":"<p>Goal:</p> <ul> <li>Transparent documentation and clear development guidelines for EDP customization.</li> </ul> <p>Consolidate documentation in a single repository edp-install, use <code>mkdocs</code> tool to generate docs and GitHub Pages as a hosting solution.</p>"},{"location":"supported-versions/","title":"Supported Versions and Compatibility","text":"<p>EPAM Delivery Platform supports only the three last versions. For a stable performance, the EDP team recommends installing the corresponding Kubernetes and OpenShift versions as indicated in the table below.</p> <p>Get acquainted with the list of the latest releases and component versions on which the platform is tested and verified:</p> EDP Release Version Release Date EKS Version OpenShift Version 3.5 Sep 21, 2023 1.26 4.12 3.4 Aug 18, 2023 1.26 4.12 3.3 May 25, 2023 1.26 4.12 3.2 Mar 26, 2023 1.23 4.10 3.1 Jan 24, 2023 1.23 4.10 3.0 Dec 19, 2022 1.23 4.10 2.12 Aug 30, 2022 1.23 4.10"},{"location":"developer-guide/","title":"Overview","text":"<p>The EDP Developer guide is intended for developers and provides details on the necessary actions to extend the EDP functionality.</p>"},{"location":"developer-guide/edp-workflow/","title":"EDP Project Rules. Working Process","text":"<p>This page contains the details on the project rules and working process for EDP team and contributors. Explore the main points about working with Gerrit, following the main commit flow, as well as the details about commit types and message below.</p>"},{"location":"developer-guide/edp-workflow/#project-rules","title":"Project Rules","text":"<p>Before starting the development, please check the project rules:</p> <ol> <li> <p>It is highly recommended to become familiar with the Gerrit flow. For details, please refer to the Gerrit official documentation and pay attention to the main points:</p> <p>a. Voting in Gerrit.</p> <p>b. Resolution of Merge Conflict.</p> <p>c. Comments resolution.</p> <p>d. One Jira task should have one Merge Request (MR). If there are many changes within one MR, add the next patch set to the open MR by selecting the Amend commit check box.</p> </li> <li> <p>Only the Assignee is responsible for the MR merge and Jira task status.</p> </li> <li> <p>Every MR should be merged in a timely manner.</p> </li> <li> <p>Log time to Jira ticket.</p> </li> </ol>"},{"location":"developer-guide/edp-workflow/#working-process","title":"Working Process","text":"<p>With EDP, the main workflow is based on the getting a Jira task and creating a Merge Request according to the rules described below.</p> <p>Workflow</p> <p>Get Jira task \u2192 implement, verify by yourself the results \u2192 create Merge Request (MR) \u2192 send for review \u2192 resolve comments/add changes, ask colleagues for the final review \u2192 track the MR merge \u2192 verify by yourself the results \u2192 change the status in the Jira ticket to CODE COMPLETE or RESOLVED \u2192 share necessary links with a QA specialist in the QA Verification channel \u2192 QA specialist closes the Jira task after his verification \u2192 Jira task should be CLOSED.</p> <p>Commit Flow</p> <ol> <li> <p>Get a task in the Jira/GitHub dashboard. Please be aware of the following points:</p> JiraGitHub <p>a. Every task has a reporter who can provide more details in case something is not clear.</p> <p>b. The responsible person for the task and code implementation is the assignee who tracks the following:</p> <ul> <li>Actual Jira task status.</li> </ul> <ul> <li>Time logging.</li> </ul> <ul> <li>Add comments, attach necessary files.</li> </ul> <ul> <li>In comments, add link that refers to the merged MR (optional, if not related to many repositories).</li> </ul> <ul> <li>Code review and the final merge.</li> </ul> <ul> <li>MS Teams chats - ping other colleagues, answer questions, etc.</li> </ul> <ul> <li>Verification by a QA specialist.</li> </ul> <ul> <li>Bug fixing.</li> </ul> <p>c. Pay attention to the task Status that differs in different entities, the workflow will help to see the whole task processing:</p> <p> View Jira workflow </p> <p>d. There are several entities that are used on the EDP project: Story, Improvement, Task, Bug.</p> <p>a. Every task has a reporter who can provide more details in case something is not clear.</p> <p>b. The responsible person for the task and code implementation is the assignee who tracks the following:</p> <ul> <li>Actual GitHub task status.</li> </ul> <ul> <li>Add comments, attach necessary files.</li> </ul> <ul> <li>In comments, add link that refers to the merged MR (optional, if not related to many repositories).</li> </ul> <ul> <li>Code review and the final merge.</li> </ul> <ul> <li>MS Teams chats - ping other colleagues, answer questions, etc.</li> </ul> <ul> <li>Verification by a QA specialist.</li> </ul> <ul> <li>Bug fixing.</li> </ul> <p>c. If the task is created on your own, make sure it is populated completely. See an example below:</p> <p> GitHub issue </p> </li> <li> <p>Implement feature, improvement, fix and check the results on your own. If it is impossible to check the results of your work before the merge, verify all later.</p> </li> <li> <p>Create a Merge Request, for details, please refer to the Code Review Process.</p> </li> <li> <p>When committing, use the pattern: commit type: Commit message (#GitHub ticket number).</p> <p>a. commit type:</p> <p><code>feat</code>: (new feature for the user, not a new feature for build script)</p> <p><code>fix</code>: (bug fix for the user, not a fix to a build script)</p> <p><code>docs</code>: (changes to the documentation)</p> <p><code>style</code>: (formatting, missing semicolons, etc; no production code change)</p> <p><code>refactor</code>: (refactoring production code, eg. renaming a variable)</p> <p><code>test</code>: (adding missing tests, refactoring tests; no production code change)</p> <p><code>chore</code>: (updating grunt tasks etc; no production code change)</p> <p><code>!</code>: (added to other commit types to mark breaking changes) For example:</p> <pre><code>feat!: Job provisioner is responsible for the formation of Jenkinsfile (#26)\n\nBREAKING CHANGE: Job provisioner creates Jenkinsfile and configures it in Jenkins pipeline as a pipeline script.\n</code></pre> <p>b. Commit message:</p> <ul> <li> <p>brief, for example:</p> <p><code>fix: Fix Gerrit plugin for Jenkins provisioning (#62)</code></p> <p>or</p> </li> </ul> <ul> <li> <p>descriptive, for example:</p> <pre><code>feat: Provide the ability to configure hadolint check (#88)\n\n*Add configuration files .hadolint.yaml and .hadolint.yml to stash\n</code></pre> <p>Note</p> <p>It is mandatory to start a commit message from a capital letter.</p> </li> </ul> <p>c. GitHub tickets are typically identified using a number preceded by the # sign and enclosed in parentheses.</p> </li> </ol> <p>Note</p> <p>Make sure there is a descriptive commit message for a breaking change Merge Request. For example:</p> <p>feat!: Job provisioner is responsible for the formation of Jenkinsfile</p> <p>BREAKING CHANGE: Job provisioner creates Jenkinsfile and configures it in Jenkins pipeline as a pipeline script.</p> <p>Note</p> <p>If a Merge Request contains both new functionality and breaking changes, make sure the functionality description is placed before the breaking changes. For example:</p> <p>feat!: Update Gerrit to improve access</p> <ul> <li>Implement Developers group creation process</li> <li>Align group permissions</li> </ul> <p>BREAKING CHANGES: Update Gerrit config according to groups</p>"},{"location":"developer-guide/edp-workflow/#related-articles","title":"Related Articles","text":"<ul> <li>Conventional Commits</li> <li>Karma</li> </ul>"},{"location":"developer-guide/local-development/","title":"Workspace Setup Manual","text":"<p>This page is intended for developers with the aim to share details on how to set up the local environment and start coding in Go language for EPAM Delivery Platform.</p>"},{"location":"developer-guide/local-development/#prerequisites","title":"Prerequisites","text":"<ul> <li>Git is installed;</li> </ul> <ul> <li>One of our repositories where you would like to contribute is cloned locally;</li> </ul> <ul> <li>Docker is installed;</li> </ul> <ul> <li>Kubectl is set up;</li> </ul> <ul> <li>Local Kubernetes cluster (Kind is recommended) is installed;</li> </ul> <ul> <li>Helm is installed;</li> </ul> <ul> <li>Any IDE (GoLand is used here as an example) is installed;</li> </ul> <ul> <li>GoLang stable version is installed.</li> </ul> <p>Note</p> <p>Make sure GOPATH and GOROOT environment variables are added in PATH.</p>"},{"location":"developer-guide/local-development/#environment-setup","title":"Environment Setup","text":"<p>Set up your environment by following the steps below.</p>"},{"location":"developer-guide/local-development/#set-up-your-ide","title":"Set Up Your IDE","text":"<p>We recommend using  GoLand  and enabling the  Kubernetes  plugin. Before installing plugins, make sure to save your work because IDE may require restarting.</p>"},{"location":"developer-guide/local-development/#set-up-your-operator","title":"Set Up Your Operator","text":"<p>To set up the cloned operator, follow the three steps below:</p> <ol> <li> <p>Configure Go Build Option. Open folder in GoLand, click the  button and select the <code>Go Build</code> option:</p> <p> Add configuration </p> </li> <li> <p>Fill in the variables in Configuration tab:</p> <ul> <li>In the <code>Files</code> field, indicate the path to the main.go file;</li> </ul> <ul> <li>In the <code>Working directory</code> field, indicate the path to the operator;</li> </ul> <ul> <li>In the <code>Environment field</code>, specify the namespace to watch by setting <code>WATCH_NAMESPACE</code> variable. It should equal <code>default</code> but it can be any other if required by the cluster specifications.</li> </ul> <ul> <li>In the <code>Environment field</code>, also specify the platform type by setting <code>PLATFORM_TYPE</code>. It should equal either <code>kubernetes</code> or <code>openshift</code>.</li> </ul> <p> Build config </p> </li> <li> <p>Check cluster connectivity and variables. Local development implies working within local Kubernetes clusters. Kind (Kubernetes in Docker) is recommended so set this or another environment first before running code.</p> </li> </ol>"},{"location":"developer-guide/local-development/#pre-commit-activities","title":"Pre-commit Activities","text":"<p>Before making commit and sending pull request, take care of precautionary measures to avoid crashing some other parts of the code.</p>"},{"location":"developer-guide/local-development/#testing-and-linting","title":"Testing and Linting","text":"<p>Testing and linting must be used before every single commit with no exceptions. The instructions for the commands below are written here.</p> <p>It is mandatory to run test and lint to make sure the code passes the tests and meets acceptance criteria. Most operators are covered by tests so just run them by issuing the commands \"make test\" and \"make lint\":</p> <pre><code>  make test\n</code></pre> <p>The command \"make test\" should give the output similar to the following:</p> <p> \"make test\" command </p> <pre><code>  make lint\n</code></pre> <p>The command \"make lint\" should give the output similar to the following:</p> <p> \"make lint\" command </p>"},{"location":"developer-guide/local-development/#observe-auto-generated-docs-api-and-manifests","title":"Observe Auto-Generated Docs, API and Manifests","text":"<p>The commands below are especially essential when making changes to API. The code is unsatisfactory if these commands fail.</p> <ul> <li> <p>Generate documentation in the .MD file format so the developer can read it:</p> <pre><code>make api-docs\n</code></pre> <p>The command \"make api-docs\" should give the output similar to the following:</p> </li> </ul> <p> \"make api-docs\" command with the file contents </p> <ul> <li> <p>There are also manifests within the operator that generate zz_generated.deepcopy.go file in /api/v1 directory. This file is necessary for the platform to work but it's time-consuming to fill it by yourself so there is a mechanism that does it automatically. Update it using the following command and check if it looks properly:</p> <pre><code>make generate\n</code></pre> <p>The command \"make generate\" should give the output similar to the following:</p> </li> </ul> <p> \"make generate\" command </p> <ul> <li> <p>Refresh custom resource definitions for Kubernetes, thus allowing the cluster to know what resources it deals with.</p> <pre><code>make manifests\n</code></pre> <p>The command \"make manifests\" should give the output similar to the following:</p> </li> </ul> <p> \"make manifests\" command </p> <p>At the end of the procedure, you can push your code confidently to your branch and create a pull request.</p> <p>That's it, you're all set! Good luck in coding!</p>"},{"location":"developer-guide/local-development/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Project Rules. Working Process</li> </ul>"},{"location":"developer-guide/mk-docs-development/","title":"Documentation Flow","text":"<p>This section defines necessary steps to start developing the EDP documentation in the MkDocs Framework. The framework presents a static site generator with documentation written in Markdown. All the docs are configured with a YAML configuration file.</p> <p>Note</p> <p>For more details on the framework, please refer to the MkDocs official website.</p> <p>There are two options for working with MkDocs:</p> <ul> <li>Work with MkDocs if Docker is installed</li> <li>Work with MkDocs if Docker is not installed</li> </ul> <p>Please see below the detailed description of each options and choose the one that suits you.</p>"},{"location":"developer-guide/mk-docs-development/#mkdocs-with-docker","title":"MkDocs With Docker","text":"<p>Prerequisites:</p> <ul> <li>Docker is installed.</li> </ul> <ul> <li><code>make</code> utility is installed.</li> </ul> <ul> <li>Git is installed. Please refer to the Git downloads.</li> </ul> <p>To work with MkDocs, take the following steps:</p> <ol> <li> <p>Clone the edp-install repository to your local folder.</p> </li> <li> <p>Run the following command:</p> <p><code>make docs</code></p> </li> <li> <p>Enter the localhost:8000 address in the browser and check that documentation pages are available.</p> </li> <li> <p>Open the file editor, navigate to edp-install-&gt;docs and make necessary changes. Check all the changes at localhost:8000.</p> </li> <li> <p>Create a merge request with changes.</p> </li> </ol>"},{"location":"developer-guide/mk-docs-development/#mkdocs-without-docker","title":"MkDocs Without Docker","text":"<p>Prerequisites:</p> <ul> <li>Git is installed. Please refer to the Git downloads.</li> </ul> <ul> <li>Python 3.9.5 is installed.</li> </ul> <p>To work with MkDocs without Docker, take the following steps:</p> <ol> <li> <p>Clone the edp-install repository to your local folder.</p> </li> <li> <p>Run the following command:</p> <pre><code>pip install -r  hack/mkdocs/requirements.txt\n</code></pre> </li> <li> <p>Run the local development command:</p> <pre><code>mkdocs serve --dev-addr 0.0.0.0:8000\n</code></pre> <p>Note</p> <p>This command may not work on Windows, so a quick solution is: <pre><code>python -m mkdocs serve --dev-addr 0.0.0.0:8000\n</code></pre></p> </li> <li> <p>Enter the localhost:8000 address in the browser and check that documentation pages are available.</p> </li> <li> <p>Open the file editor, navigate to edp-install-&gt;docs and make necessary changes. Check all the changes at localhost:8000.</p> </li> <li> <p>Create a merge request with changes.</p> </li> </ol>"},{"location":"operator-guide/","title":"Overview","text":"<p>The EDP Operator guide is intended for DevOps and provides information on EDP installation, configuration and customization, as well as the platform support. Inspect the documentation to adjust the EPAM Delivery Platform according to your business needs:</p> <ul> <li>The Installation section provides the prerequisites for EDP installation, including Kubernetes or OpenShift cluster setup, Keycloak, DefectDojo, Kiosk, and Ingress-nginx setup as well as the subsequent deployment of EPAM Delivery Platform.</li> </ul> <ul> <li>The Configuration section indicates the options to set the project with adding a code language, backup, integrate VCS with Jenkins or Tekton, managing Jenkins pipelines, and logging.</li> </ul> <ul> <li>The Integration section comprises the AWS, GitHub, GitLab, Jira, and Logsight integration options.</li> </ul> <ul> <li>The Tutorials section provides information on working with various aspects, for example, using cert-manager in OpenShift, deploying AWS EKS cluster, deploying OKD 4.9 cluster, deploying OKD 4.10 cluster, managing Jenkins agent, and upgrading Keycloak v.17.0.x-legacy to v.19.0.x on Kubernetes.</li> </ul>"},{"location":"operator-guide/add-jenkins-agent/","title":"Manage Jenkins Agent","text":"<p>Inspect the main steps to add and update Jenkins agent.</p>"},{"location":"operator-guide/add-jenkins-agent/#createupdate-jenkins-agent","title":"Create/Update Jenkins Agent","text":"<p>Every Jenkins agent is based on epamedp/edp-jenkins-base-agent. Check DockerHub for the latest version. Use it to create a new agent (or update an old one). See the example with Dockerfile of gradle-java11-agent below:</p> View: Dockerfile <pre><code>    # Copyright 2021 EPAM Systems.\n    # Licensed under the Apache License, Version 2.0 (the \"License\");\n    # you may not use this file except in compliance with the License.\n    # You may obtain a copy of the License at\n    # http://www.apache.org/licenses/LICENSE-2.0\n    # Unless required by applicable law or agreed to in writing, software\n    # distributed under the License is distributed on an \"AS IS\" BASIS,\n    # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    # See the License for the specific language governing permissions and\n    # limitations under the License.\n\n    FROM epamedp/edp-jenkins-base-agent:1.0.1\n    SHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n    ENV GRADLE_VERSION=7.1 \\\n        PATH=$PATH:/opt/gradle/bin\n\n    # Install Gradle\n    RUN curl -skL -o /tmp/gradle-bin.zip https://services.gradle.org/distributions/gradle-$GRADLE_VERSION-bin.zip &amp;&amp; \\\n        mkdir -p /opt/gradle &amp;&amp; \\\n        unzip -q /tmp/gradle-bin.zip -d /opt/gradle &amp;&amp; \\\n        ln -sf /opt/gradle/gradle-$GRADLE_VERSION/bin/gradle /usr/local/bin/gradle\n\n    RUN yum install java-11-openjdk-devel.x86_64 -y &amp;&amp; \\\n        rpm -V java-11-openjdk-devel.x86_64 &amp;&amp; \\\n        yum clean all -y\n\n    WORKDIR $HOME/.gradle\n\n    RUN chown -R \"1001:0\" \"$HOME\" &amp;&amp; \\\n        chmod -R \"g+rw\" \"$HOME\"\n\n    USER 1001\n</code></pre> <p>After the Docker agent update/creation, build and load the image into the project registry (e.g. DockerHub, AWS ECR, etc.).</p>"},{"location":"operator-guide/add-jenkins-agent/#add-jenkins-agent-configuration","title":"Add Jenkins Agent Configuration","text":"<p>To add a new Jenkins agent, take the steps below:</p> <ol> <li> <p>Run the following command. Please be aware that <code>edp</code> is the name of the EDP tenant.</p> <pre><code>  kubectl edit configmap jenkins-slaves -n edp\n</code></pre> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> <p>Add new agent template.      View: ConfigMap jenkins-slaves <pre><code>  data:\n    docker-template: |-\n     &lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;docker&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;docker&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;IMAGE_NAME:IMAGE_TAG&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <p>Note</p> <p>The name and label properties should be unique(docker in the example above). Insert image name and tag instead of IMAGE_NAME:IMAGE_TAG.</p> <li> <p>Open Jenkins to ensure that everything is added correctly. Click the Manage Jenkins option, navigate to the Manage Nodes and Clouds-&gt;Configure Clouds-&gt;Kubernetes-&gt;Pod Templates..., and scroll down to find new Jenkins agent Pod Template details...:</p> <p> Jenkins pod template </p> <p>As a result, the newly added Jenkins agent will be available in the Advanced Settings block of the Admin Console tool during the codebase creation:</p> <p> Advanced settings </p> </li>"},{"location":"operator-guide/add-jenkins-agent/#modify-existing-agent-configuration","title":"Modify Existing Agent Configuration","text":"<p>If your application is integrated with EDP, take the steps below to change an existing agent configuration:</p> <ol> <li> <p>Run the following command. Please be aware that <code>edp</code> is the name of the EDP tenant.</p> <pre><code>  kubectl edit configmap jenkins-slaves -n edp\n</code></pre> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> </li> <li> <p>Find the agent template in use and change and change the parameters.</p> </li> <li> <p>Open Jenkins and check the correct addition. Click the Manage Jenkins option, navigate to the Manage Nodes and Clouds-&gt;Configure Clouds-&gt;Kubernetes-&gt;Pod Templates..., and scroll down to Pod Template details... with the necessary data.</p> </li> </ol>"},{"location":"operator-guide/add-ons-overview/","title":"Cluster Add-Ons Overview","text":"<p>This page describes the entity of Cluster Add-Ons for EPAM Delivery Platform, as well as their purpose, benefits and usage.</p>"},{"location":"operator-guide/add-ons-overview/#what-are-add-ons","title":"What Are Add-Ons","text":"<p>EDP Add-Ons is basically a Kubernetes-based structure that enables users to quickly install additional components for the platform using Argo CD applications.</p> <p>Add-Ons have been introduced into EDP starting from version 3.4.0. They empower users to seamlessly incorporate the platform with various additional components, such as SonarQube, Nexus, Keycloak, Jira, and more. This eliminates the need for manual installations, as outlined in the Install EDP page.</p> <p>In a nutshell, Add-Ons represent separate Helm Charts that imply to be installed by one click using the Argo CD tool.</p>"},{"location":"operator-guide/add-ons-overview/#add-ons-repository-structure","title":"Add-Ons Repository Structure","text":"<p>All the Add-Ons are stored in our public GitHub repository adhering to the GitOps approach. Apart from default Helm and Git files, it contains both custom resources called Applications for Argo CD and application source code. The repository follows the GitOps approach to enable Add-Ons with the capability to rollback changes when needed. The repository structure is the following:</p> <pre><code>  \u251c\u2500\u2500 CHANGELOG.md\n  \u251c\u2500\u2500 LICENSE\n  \u251c\u2500\u2500 Makefile\n  \u251c\u2500\u2500 README.md\n  \u251c\u2500\u2500 add-ons\n  \u2514\u2500\u2500 chart\n</code></pre> <ul> <li>add-ons - the directory that contains Helm charts of the applications that can be integrated with EDP using Add-Ons.</li> </ul> <ul> <li>chart - the directory that contains Helm charts with application templates that will be used to create custom resources called Applications for Argo CD.</li> </ul>"},{"location":"operator-guide/add-ons-overview/#enable-edp-add-ons","title":"Enable EDP Add-Ons","text":"<p>To enable EDP Add-Ons, it is necessary to have the configured Argo CD, and connect and synchronize the forked repository. To do this, follow the guidelines below:</p> <ol> <li> <p>Fork the Add-Ons repository to your personal account.</p> </li> <li> <p>Provide the parameter values for the values.yaml files of the desired Add-Ons you are going to install.</p> </li> <li> <p>Navigate to Argo CD -&gt; Settings -&gt; Repositories. Connect your forked repository where you have the values.yaml files changed by clicking the + Connect repo button:</p> <p> Connect the forked repository </p> </li> <li> <p>In the appeared window, fill in the following fields and click the Connect button:</p> <ul> <li>Name - select the namespace where the project is going to be deployed;</li> <li>Choose your connection method - choose Via SSH;</li> <li>Type - choose Helm;</li> <li>Repository URL - enter the URL of your forked repository.</li> </ul> <p> Repository parameters </p> </li> <li> <p>As soon as the repository is connected, the new item in the repository list will appear:</p> <p> Connected repository </p> </li> <li> <p>Navigate to Argo CD -&gt; Applications. Click the + New app button:</p> <p> Adding Argo CD application </p> </li> <li> <p>Fill in the required fields:</p> <ul> <li>Application Name - addons-demo;</li> <li>Project name - select the namespace where the project is going to be deployed;</li> <li>Sync policy - select Manual;</li> <li>Repository URL - enter the URL of your forked repository;</li> <li>Revision - Head;</li> <li>Path - select chart;</li> <li>Cluster URL - enter the URL of your cluster;</li> <li>Namespace - enter the namespace which must be equal to the Project name field.</li> </ul> </li> <li> <p>As soon as the repository is synchronized, the list of applications that can be installed by Add-Ons will be shown:</p> <p> Add-Ons list </p> </li> </ol>"},{"location":"operator-guide/add-ons-overview/#install-edp-add-ons","title":"Install EDP Add-Ons","text":"<p>Now that Add-Ons are enabled in Argo CD, they can be installed by following the steps below:</p> <ol> <li> <p>Choose the Add-On to install.</p> </li> <li> <p>On the chosen Add-On, click the \u22ee button and then Details:</p> <p> Open Add-Ons </p> </li> <li> <p>To install the Add-On, click the \u22ee button -&gt; Sync:</p> <p> Install Add-Ons </p> </li> <li> <p>Once the Add-On is installed, the Sync OK message will appear in the Add-On status bar:</p> <p> Sync OK message </p> </li> <li> <p>Open the application details by clicking on the little square with an arrow underneath the Add-On name:</p> <p> Open details </p> </li> <li> <p>Track application resources and status in the App details menu:</p> <p> Application details </p> </li> </ol> <p>As we see, Argo CD offers great observability and monitoring tools for its resources which comes in handy when using EDP Add-Ons.</p>"},{"location":"operator-guide/add-ons-overview/#available-add-ons-list","title":"Available Add-Ons List","text":"<p>The list of the available Add-Ons:</p> Name Description Default Argo CD A GitOps continuous delivery tool that helps automate the deployment, configuration, and lifecycle management of applications in Kubernetes clusters. false AWS EFS CSI Driver A Container Storage Interface (CSI) driver that enables the dynamic provisioning of Amazon Elastic File System (EFS) volumes in Kubernetes clusters. true Cert Manager A native Kubernetes certificate management controller that automates the issuance and renewal of TLS certificates. true DefectDojo A security vulnerability management tool that allows tracking and managing security findings in applications. true DependencyTrack A Software Composition Analysis (SCA) platform that helps identify and manage open-source dependencies and their associated vulnerabilities. true EDP An internal platform created by EPAM to enhance software delivery processes using DevOps principles and tools. false Extensions OIDC EDP Helm chart to provision OIDC clients for different Add-Ons using EDP Keycloak Operator. true External Secrets A Kubernetes Operator that fetches secrets from external secret management systems and injects them as Kubernetes Secrets. true Fluent Bit A lightweight and efficient log processor and forwarder that collects and routes logs from various sources in Kubernetes clusters. false Harbor A cloud-native container image registry that provides support for vulnerability scanning, policy-based image replication, and more. true Nginx ingress An Ingress controller that provides external access to services running within a Kubernetes cluster using Nginx as the underlying server. true Jaeger Operator An operator for deploying and managing Jaeger, an end-to-end distributed tracing system, in Kubernetes clusters. true Keycloak An open-source Identity and Access Management (IAM) solution that enables authentication, authorization, and user management in Kubernetes clusters. true Keycloak PostgreSQL A PostgreSQL database operator that simplifies the deployment and management of PostgreSQL instances in Kubernetes clusters. false MinIO Operator An operator that simplifies the deployment and management of MinIO, a high-performance object storage server compatible with Amazon S3, in Kubernetes clusters. true OpenSearch A community-driven, open-source search and analytics engine that provides scalable and distributed search capabilities for Kubernetes clusters. true OpenTelemetry Operator An operator for automating the deployment and management of OpenTelemetry, a set of observability tools for capturing, analyzing, and exporting telemetry data. true PostgreSQL Operator An operator for running and managing PostgreSQL databases in Kubernetes clusters with high availability and scalability. true Prometheus Operator An operator that simplifies the deployment and management of Prometheus, a monitoring and alerting toolkit, in Kubernetes clusters. true Redis Operator An operator for managing Redis, an in-memory data structure store, in Kubernetes clusters, providing high availability and horizontal scalability. true StorageClass A Kubernetes resource that provides a way to define different classes of storage with different performance characteristics for persistent volumes. true Tekton A flexible and cloud-native framework for building, testing, and deploying applications using Kubernetes-native workflows. true Vault An open-source secrets management solution that provides secure storage, encryption, and access control for sensitive data in Kubernetes clusters. true"},{"location":"operator-guide/add-other-code-language/","title":"Add Other Code Language","text":"<p>There is an ability to extend the default code languages when creating a codebase with the Clone or Import strategy.</p> <p> Other code language </p> <p>Warning</p> <p>The Create strategy does not allow to customize the default code language set.</p> <p>To customize the Build Tool list, perform the following:</p> <ul> <li> <p>Edit the edp-admin-console deployment by adding the necessary code language into the BUILD TOOLS field:</p> <pre><code> kubectl edit deployment edp-admin-console -n edp\n</code></pre> <p>Note</p> <p>Using an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> <p>Info</p> <p><code>edp</code> is the name of the EDP tenant here and in all the following steps.</p> View: edp-admin-console deployment <pre><code>...\nspec:\ncontainers:\n- env:\n...\n- name: BUILD_TOOLS\nvalue: docker # List of custom build tools in Admin Console, e.g. 'docker,helm';\n...\n...\n</code></pre> </li> </ul> <ul> <li>Add the Jenkins agent by following the instruction.</li> </ul> <ul> <li>Add the Custom CI pipeline provisioner by following the instruction.</li> </ul> <ul> <li> <p>As a result, the newly added Jenkins agent will be available in the Select Jenkins Slave dropdown list of the Advanced Settings block during the codebase creation:</p> <p> Advanced settings </p> </li> </ul> <p>If it is necessary to create Code Review and Build pipelines, add corresponding entries (e.g. stages[Build-application-docker], [Code-review-application-docker]). See the example below:</p> <pre><code>...\nstages['Code-review-application-docker'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + ',{\"name\": \"sonar\"}]'\nstages['Build-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build-image-kaniko\"}' + ',{\"name\": \"git-tag\"}]'\n...\n</code></pre> <p> Jenkins job provisioner </p> <p>Note</p> <p>Application is one of the available options. Another option might be to add a library. Please refer to the Add Library page for details.</p>"},{"location":"operator-guide/add-other-code-language/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Manage Jenkins Agent</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> </ul>"},{"location":"operator-guide/add-security-scanner/","title":"Add Security Scanner","text":"<p>In order to add a new security scanner, perform the steps below:</p> <ol> <li> <p>Select a pipeline customization option from the Customize CI Pipeline article. Follow the steps described in this article, to create a new repository.</p> <p>Note</p> <p>This tutorial will focus on adding a new stage using shared library via the custom global pipeline libraries.</p> </li> <li> <p>Open the new repository and create a directory with the <code>/src/com/epam/edp/customStages/impl/ci/impl/stageName/</code> name in the library repository, for example: <code>/src/com/epam/edp/customStages/impl/ci/impl/security/</code>. After that, add a Groovy file with another name to the same stages catalog, for example: <code>CustomSAST.groovy</code>.</p> </li> <li> <p>Copy the logic from <code>SASTMavenGradleGoApplication.groovy</code> stage into the new <code>CustomSAST.groovy</code> stage.</p> </li> <li> <p>Add a new <code>runGoSecScanner</code> function to the stage:</p> <pre><code>@Stage(name = \"sast-custom\", buildTool = [\"maven\",\"gradle\",\"go\"], type = [ProjectType.APPLICATION])\nclass CustomSAST {\n...\ndef runGoSecScanner(context) {\ndef edpName = context.platform.getJsonPathValue(\"cm\", \"edp-config\", \".data.edp_name\")\ndef reportData = [:]\nreportData.active = \"true\"\nreportData.verified = \"false\"\nreportData.path = \"sast-gosec-report.json\"\nreportData.type = \"Gosec Scanner\"\nreportData.productTypeName = \"Tenant\"\nreportData.productName = \"${edpName}\"\nreportData.engagementName = \"${context.codebase.name}-${context.git.branch}\"\nreportData.autoCreateContext = \"true\"\nreportData.closeOldFindings = \"true\"\nreportData.pushToJira = \"false\"\nreportData.environment = \"Development\"\nreportData.testTitle = \"SAST\"\nscript.sh(script: \"\"\"\n                set -ex\n                gosec -fmt=json -out=${reportData.path} ./...\n        \"\"\")\nreturn reportData\n}\n...\n}\n</code></pre> </li> <li> <p>Add function calls for the <code>runGoSecScanner</code> and <code>publishReport</code> functions:</p> <pre><code>...\nscript.node(\"sast\") {\nscript.dir(\"${testDir}\") {\nscript.unstash 'all-repo'\n...\ndef dataFromGoSecScanner = runGoSecScanner(context)\npublishReport(defectDojoCredentials, dataFromGoSecScanner)\n}\n}\n...\n</code></pre> </li> <li> <p>Gosec scanner will be installed on the Jenkins SAST agent. It is based on the <code>epamedp/edp-jenkins-base-agent</code>. Please check DockerHub for its latest version.</p> <p>See below an example of the <code>edp-jenkins-sast-agent</code> Dockerfile:</p> View: Default Dockerfile <pre><code> # Copyright 2022 EPAM Systems.\n\n # Licensed under the Apache License, Version 2.0 (the \"License\");\n # you may not use this file except in compliance with the License.\n # You may obtain a copy of the License at\n # http://www.apache.org/licenses/LICENSE-2.0\n\n # Unless required by applicable law or agreed to in writing, software\n # distributed under the License is distributed on an \"AS IS\" BASIS,\n # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\n # See the License for the specific language governing permissions and\n # limitations under the License.\n\n FROM epamedp/edp-jenkins-base-agent:1.0.31\n\n SHELL [\"/bin/bash\", \"-o\", \"pipefail\", \"-c\"]\n\n USER root\n\n ENV SEMGREP_SCANNER_VERSION=0.106.0 \\\n     GOSEC_SCANNER_VERSION=2.12.0\n\n RUN apk --no-cache add \\\n     curl=7.79.1-r2 \\\n     build-base=0.5-r3 \\\n     python3-dev=3.9.5-r2 \\\n     py3-pip=20.3.4-r1 \\\n     go=1.16.15-r0\n\n # hadolint ignore=DL3059\n RUN pip3 install --no-cache-dir --upgrade --ignore-installed \\\n     pip==22.2.1 \\\n     ruamel.yaml==0.17.21 \\\n     semgrep==${SEMGREP_SCANNER_VERSION}\n\n # Install GOSEC\n RUN curl -Lo /tmp/gosec.tar.gz https://github.com/securego/gosec/releases/download/v${GOSEC_SCANNER_VERSION}/gosec_${GOSEC_SCANNER_VERSION}_linux_amd64.tar.gz &amp;&amp; \\\n     tar xf /tmp/gosec.tar.gz &amp;&amp; \\\n     rm -f /tmp/gosec.tar.gz &amp;&amp; \\\n     mv gosec /bin/gosec\n\n RUN chown -R \"1001:0\" \"$HOME\" &amp;&amp; \\\n     chmod -R \"g+rw\" \"$HOME\"\n\n USER 1001\n</code></pre> </li> </ol>"},{"location":"operator-guide/add-security-scanner/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CI Pipeline</li> <li>Static Application Security Testing Overview</li> <li>Semgrep</li> </ul>"},{"location":"operator-guide/argocd-integration/","title":"Argo CD Integration","text":"<p>EDP uses Jenkins Pipeline as a part of the Continues Delivery/Continues Deployment implementation. Another approach is to use Argo CD tool as an alternative to Jenkins. Argo CD follows the best GitOps practices, uses Kubernetes native approach for the Deployment Management, has rich UI and required RBAC capabilities.</p>"},{"location":"operator-guide/argocd-integration/#argo-cd-deployment-approach-in-edp","title":"Argo CD Deployment Approach in EDP","text":"<p>Argo CD can be installed using two different approaches:</p> <ul> <li>Cluster-wide scope with the cluster-admin access</li> <li>Namespaced scope with the single namespace access</li> </ul> <p>Both approaches can be deployed with High Availability (HA) or Non High Availability (non HA) installation manifests.</p> <p>EDP uses the HA deployment with the cluster-admin permissions, to minimize cluster resources consumption by sharing single Argo CD instance across multiple EDP Tenants. Please follow the installation instructions to deploy Argo CD.</p>"},{"location":"operator-guide/argocd-integration/#edp-argo-cd-integration","title":"EDP Argo CD Integration","text":"<p>See a diagram below for the details:</p> <p> Argo CD Diagram </p> <ul> <li>Argo CD is deployed in a separate <code>argocd</code> namespace.</li> <li>Argo CD uses a <code>cluster-admin</code> role for managing cluster-scope resources.</li> <li>The <code>control-plane</code> application is created using the App of Apps approach, and its code is managed by the <code>control-plane</code> members.</li> <li>The <code>control-plane</code> is used to onboard new Argo CD Tenants (Argo CD Projects - AppProject).</li> <li>The <code>EDP Tenant Member</code> manages <code>Argo CD Applications</code> using <code>kind: Application</code> in the <code>edpTenant</code> namespace.</li> </ul> <p>The App Of Apps approach is used to manage the <code>EDP Tenants</code>. Inspect the edp-grub repository structure that is used to provide the EDP Tenants for the Argo CD Projects:</p> <pre><code>edp-grub\n\u251c\u2500\u2500 LICENSE\n\u251c\u2500\u2500 README.md\n\u251c\u2500\u2500 apps                      ### All Argo CD Applications are stored here\n\u2502\u00a0\u00a0 \u251c\u2500\u2500 grub-argocd.yaml      # Application that provisions Argo CD Resources - Argo Projects (EDP Tenants)\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 grub-keycloak.yaml    # Application that provisions Keycloak Resources - Argo CD Groups (EDP Tenants)\n\u251c\u2500\u2500 apps-configs\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 grub\n\u2502\u00a0\u00a0     \u251c\u2500\u2500 argocd            ### Argo CD resources definition\n\u2502\u00a0\u00a0     \u2502\u00a0\u00a0 \u251c\u2500\u2500 team-bar.yaml\n\u2502\u00a0\u00a0     \u2502\u00a0\u00a0 \u2514\u2500\u2500 team-foo.yaml\n\u2502\u00a0\u00a0     \u2514\u2500\u2500 keycloak          ### Keycloak resources definition\n\u2502\u00a0\u00a0         \u251c\u2500\u2500 team-bar.yaml\n\u2502\u00a0\u00a0         \u2514\u2500\u2500 team-foo.yaml\n\u251c\u2500\u2500 bootstrap\n\u2502\u00a0\u00a0 \u2514\u2500\u2500 root.yaml             ### Root application in App of Apps, which provision Applications from /apps\n\u2514\u2500\u2500 examples                  ### Examples\n\u2514\u2500\u2500 tenant\n        \u2514\u2500\u2500 foo-petclinic.yaml\n</code></pre> <p>The Root Application must be created under the <code>control-plane</code> scope.</p>"},{"location":"operator-guide/argocd-integration/#configuration","title":"Configuration","text":"<p>Note</p> <p>Make sure that both EDP and Argo CD are installed, and that SSO is enabled.</p> <p>To start using Argo CD with EDP, perform the following steps:</p>"},{"location":"operator-guide/argocd-integration/#keycloak","title":"Keycloak","text":"<ol> <li> <p>Create a Keycloak Group.</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmGroup\nmetadata:\nname: argocd-team-foo-users\nspec:\nname: ArgoCD-team-foo-users\nrealm: main\n</code></pre> </li> <li> <p>In Keycloak, add users to the <code>ArgoCD-team-foo-users</code> Keycloak Group.</p> </li> </ol>"},{"location":"operator-guide/argocd-integration/#argo-cd","title":"Argo CD","text":"<ol> <li> <p>Add a credential template for Gerrit, GitHub, GitLab integrations. The credential template must be created for each Git server.</p> GerritGitHub/GitLab <p>Copy existing SSH private key for Gerrit to Argo CD namespace</p> <pre><code>EDP_NAMESPACE=&lt;EPD_NAMESPACE&gt;\nGERRIT_PORT=$(kubectl get gerrit gerrit -n ${EDP_NAMESPACE} -o jsonpath='{.spec.sshPort}')\nGERRIT_ARGOCD_SSH_KEY_NAME=\"gerrit-argocd-sshkey\"\nGERRIT_URL=$(echo \"ssh://argocd@gerrit.${EDP_NAMESPACE}:${GERRIT_PORT}\" | base64)\nkubectl get secret ${GERRIT_ARGOCD_SSH_KEY_NAME} -n ${EDP_NAMESPACE} -o json | jq 'del(.data.username,.metadata.annotations,.metadata.creationTimestamp,.metadata.labels,.metadata.resourceVersion,.metadata.uid,.metadata.ownerReferences)' | jq '.metadata.namespace = \"argocd\"' | jq --arg name \"${EDP_NAMESPACE}\" '.metadata.name = $name' | jq --arg url \"${GERRIT_URL}\" '.data.url = $url' | jq '.data.sshPrivateKey = .data.id_rsa' | jq 'del(.data.id_rsa,.data.\"id_rsa.pub\")' | kubectl apply -f -\nkubectl label --overwrite secret ${EDP_NAMESPACE} -n argocd \"argocd.argoproj.io/secret-type=repo-creds\"\n</code></pre> <p>Generate an SSH key pair and add a public key to GitLab or GitHub account.</p> <p>Warning</p> <p>Use an additional GitHub/GitLab User to access a repository. For example: - GitHub, add a User to a repository with a \"Read\" role. - GitLab, add a User to a repository with a \"Guest\" role.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\" -f argocd\n</code></pre> <p>Copy SSH private key to Argo CD namespace</p> <pre><code>EDP_NAMESPACE=&lt;EDP_NAMESPACE&gt;\nVCS_HOST=\"&lt;github.com_or_gitlab.com&gt;\"\nACCOUNT_NAME=\"&lt;ACCOUNT_NAME&gt;\"\nURL=\"ssh://git@${VCS_HOST}:22/${ACCOUNT_NAME}\"\n\nkubectl create secret generic ${EDP_NAMESPACE} -n argocd \\\n--from-file=sshPrivateKey=argocd \\\n--from-literal=url=\"${URL}\"\nkubectl label --overwrite secret ${EDP_NAMESPACE} -n argocd \"argocd.argoproj.io/secret-type=repo-creds\"\n</code></pre> <p>Add public SSH key to GitHub/GitLab account.</p> </li> <li> <p>Add SSH Known hosts    for Gerrit, GitHub, GitLab integration.</p> GerritGitHub/GitLab <p>Add Gerrit host to Argo CD config map with known hosts</p> <pre><code>EDP_NAMESPACE=&lt;EDP_NAMESPACE&gt;\nKNOWN_HOSTS_FILE=\"/tmp/ssh_known_hosts\"\nARGOCD_KNOWN_HOSTS_NAME=\"argocd-ssh-known-hosts-cm\"\nGERRIT_PORT=$(kubectl get gerrit gerrit -n ${EDP_NAMESPACE} -o jsonpath='{.spec.sshPort}')\n\nrm -f ${KNOWN_HOSTS_FILE}\nkubectl get cm ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd -o jsonpath='{.data.ssh_known_hosts}' &gt; ${KNOWN_HOSTS_FILE}\nkubectl exec -it deployment/gerrit -n ${EDP_NAMESPACE} -- ssh-keyscan -p ${GERRIT_PORT} gerrit.${EDP_NAMESPACE} &gt;&gt; ${KNOWN_HOSTS_FILE}\nkubectl create configmap ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd --from-file ${KNOWN_HOSTS_FILE} -o yaml --dry-run=client | kubectl apply -f -\n</code></pre> <p>Add GitHub/GitLab host to Argo CD config map with known hosts</p> <pre><code>EDP_NAMESPACE=&lt;EPD_NAMESPACE&gt;\nVCS_HOST=\"&lt;VCS_HOST&gt;\"\nKNOWN_HOSTS_FILE=\"/tmp/ssh_known_hosts\"\nARGOCD_KNOWN_HOSTS_NAME=\"argocd-ssh-known-hosts-cm\"\n\nrm -f ${KNOWN_HOSTS_FILE}\nkubectl get cm ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd -o jsonpath='{.data.ssh_known_hosts}' &gt; ${KNOWN_HOSTS_FILE}\nssh-keyscan ${VCS_HOST} &gt;&gt; ${KNOWN_HOSTS_FILE}\nkubectl create configmap ${ARGOCD_KNOWN_HOSTS_NAME} -n argocd --from-file ${KNOWN_HOSTS_FILE} -o yaml --dry-run=client | kubectl apply -f -\n</code></pre> </li> <li> <p>Create an Argo CD Project (EDP Tenant), for example, with the <code>team-foo</code> name:</p> AppProject<pre><code>apiVersion: argoproj.io/v1alpha1\nkind: AppProject\nmetadata:\nname: team-foo\nnamespace: argocd\n# Finalizer that ensures that project is not deleted until it is not referenced by any application\nfinalizers:\n- resources-finalizer.argocd.argoproj.io\nspec:\ndescription: CD pipelines for team-foo\nroles:\n- name: developer\ndescription: Users for team-foo tenant\npolicies:\n- p, proj:team-foo:developer, applications, create, team-foo/*, allow\n- p, proj:team-foo:developer, applications, delete, team-foo/*, allow\n- p, proj:team-foo:developer, applications, get, team-foo/*, allow\n- p, proj:team-foo:developer, applications, override, team-foo/*, allow\n- p, proj:team-foo:developer, applications, sync, team-foo/*, allow\n- p, proj:team-foo:developer, applications, update, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, create, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, delete, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, update, team-foo/*, allow\n- p, proj:team-foo:developer, repositories, get, team-foo/*, allow\ngroups:\n# Keycloak Group name\n- ArgoCD-team-foo-users\ndestinations:\n# ensure we can deploy to ns with tenant prefix\n- namespace: 'team-foo-*'\n# allow to deploy to specific server (local in our case)\nserver: https://kubernetes.default.svc\n# Deny all cluster-scoped resources from being created, except for Namespace\nclusterResourceWhitelist:\n- group: ''\nkind: Namespace\n# Allow all namespaced-scoped resources to be created, except for ResourceQuota, LimitRange, NetworkPolicy\nnamespaceResourceBlacklist:\n- group: ''\nkind: ResourceQuota\n- group: ''\nkind: LimitRange\n- group: ''\nkind: NetworkPolicy\n# we are ok to create any resources inside namespace\nnamespaceResourceWhitelist:\n- group: '*'\nkind: '*'\n# enable access only for specific git server. The example below 'team-foo' - it is namespace where EDP deployed\nsourceRepos:\n- ssh://argocd@gerrit.team-foo:30007/*\n# enable capability to deploy objects from namespaces\nsourceNamespaces:\n- team-foo\n</code></pre> </li> <li> <p>Optional: if the Argo CD controller has not been enabled to manage the Application resources in the specific namespaces    (<code>team-foo</code>, in our case) in the Install Argo CD, modify the <code>argocd-cmd-params-cm</code>    ConfigMap in the Argo CD namespace and add the <code>application.namespaces</code> parameter to the subsection data:</p> argocd-cmd-params-cm<pre><code>...\ndata:\napplication.namespaces: team-foo\n...\n</code></pre> values.yaml file<pre><code>...\nconfigs:\nparams:\napplication.namespaces: team-foo\n...\n</code></pre> </li> <li> <p>Check that your new Repository, Known Hosts, and AppProject are added to the Argo CD UI.</p> </li> </ol> <p>Once Argo CD is successfully integrated, EDP user can utilize Argo CD to deploy CD pipelines.</p>"},{"location":"operator-guide/argocd-integration/#check-argo-cd-integration-optional","title":"Check Argo CD Integration (Optional)","text":"<p>This section provides the information on how to test the integration with Argo CD and is not mandatory to be followed.</p> <ol> <li> <p>Follow the Add Application instruction to deploy a test EDP application with the <code>demo</code> name, which should be stored in a Gerrit private repository:</p> Example: Argo CD Application  <pre><code>apiVersion: argoproj.io/v1alpha1\nkind: Application\nmetadata:\nname: demo\nspec:\nproject: team-foo\ndestination:\nnamespace: team-foo-demo\nserver: https://kubernetes.default.svc\nsource:\nhelm:\nparameters:\n- name: image.tag\nvalue: master-0.1.0-1\n- name: image.repository\nvalue: image-repo\npath: deploy-templates\nrepoURL: ssh://argocd@gerrit.team-foo:30007/demo.git\ntargetRevision: master\nsyncPolicy:\nsyncOptions:\n- CreateNamespace=true\nautomated:\nselfHeal: true\nprune: true\n</code></pre> </li> <li> <p>Check that your new Application is added to the Argo CD UI under the <code>team-foo</code> Project scope.</p> </li> </ol>"},{"location":"operator-guide/argocd-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Install Argo CD</li> </ul>"},{"location":"operator-guide/aws-marketplace-install/","title":"Install via AWS Marketplace","text":"<p>This documentation provides the detailed instructions on how to install the EPAM Delivery Platform via the AWS Marketplace.</p> <p>To initiate the installation process, navigate to our dedicated AWS Marketplace page and commence the deployment of EPAM Delivery Platform.</p> <p>Disclaimer</p> <p>EDP is aligned with industry standards for storing and managing sensitive data, ensuring optimal security. However, the use of custom solutions introduces uncertainties, thus the responsibility for the safety of your data is totally covered by platform administrator.</p>"},{"location":"operator-guide/aws-marketplace-install/#prerequisites","title":"Prerequisites","text":"<p>Please familiarize yourself with the Prerequisites page before deploying the product. To perform a minimal installation, ensure that you meet the following requirements:</p> <ul> <li>The domain name is available and associated with the ingress object in cluster.</li> <li>Cluster administrator access.</li> <li>The Tekton resources are deployed.</li> <li>Access to the cluster via Service Account token is available.</li> </ul>"},{"location":"operator-guide/aws-marketplace-install/#deploy-epam-delivery-platform","title":"Deploy EPAM Delivery Platform","text":"<p>To deploy the platform, follow the steps below:</p> <ol> <li> <p>To apply Tekton stack, deploy Tekton resources by executing the command below:</p> <pre><code> kubectl create ns tekton-pipelines\n kubectl create ns tekton-chains\n kubectl create ns tekton-pipelines-resolvers\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/latest/release.yaml\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/triggers/latest/interceptors.yaml\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/pipeline/latest/release.yaml\n kubectl apply --filename https://storage.googleapis.com/tekton-releases/chains/latest/release.yaml\n</code></pre> </li> <li> <p>Define the mandatory parameters you would like to use for installation using the following command:</p> <pre><code> kubectl create ns edp\n helm install edp-install \\\n--namespace edp ./* \\\n--set global.dnsWildCard=example.com \\\n--set awsRegion=&lt;AWS_REGION&gt;\n</code></pre> </li> <li> <p>(Optional) Provide token to sign in to EDP Portal. Run the following command to create Service Account with cluster admin permissions:</p> <pre><code>kubectl create serviceaccount edp-admin -n edp\nkubectl create clusterrolebinding edp-cluster-admin --clusterrole=cluster-admin --serviceaccount=edp:edp-admin\nkubectl apply -f - &lt;&lt;EOF\napiVersion: v1\nkind: Secret\nmetadata:\n  name: edp-admin-token\n  namespace: edp\n  annotations:\n    kubernetes.io/service-account.name: edp-admin\ntype: kubernetes.io/service-account-token\nEOF\n</code></pre> </li> <li> <p>(Optional) To get access to EDP Portal, run the port-forwarding command:</p> <pre><code> kubectl port-forward service/edp-headlamp 59480:80 -n edp\n</code></pre> </li> <li> <p>(Optional) To open EDP Portal, navigate to the <code>http://localhost:59480</code>.</p> </li> <li> <p>(Optional) To get admin token to sign in to EDP Portal:</p> <pre><code>kubectl get secrets -o jsonpath=\"{.items[?(@.metadata.annotations['kubernetes\\.io/service-account\\.name']=='edp-admin')].data.token}\" -n edp|base64 --decode\n</code></pre> </li> </ol> <p>As a result, you will get access to EPAM Delivery Platform components via EDP Portal UI. Navigate to our Use Cases to try out EDP functionality. Visit other subsections of the Operator Guide to figure out how to configure EDP and integrate it with various tools.</p>"},{"location":"operator-guide/aws-marketplace-install/#related-articles","title":"Related Articles","text":"<ul> <li>EPAM Delivery Platform on AWS Marketplace</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Set Up Kubernetes</li> <li>Set Up OpenShift</li> <li>EDP Installation Prerequisites Overview</li> <li>Headlamp OIDC Integration</li> </ul>"},{"location":"operator-guide/capsule/","title":"Capsule Integration","text":"<p>This documentation guide provides comprehensive instructions of integrating Capsule with the EPAM Delivery Platform to enhance security and resource management.</p> <p>Note</p> <p>When integrating the EPAM Delivery Platform with Capsule, it's essential to understand that the platform needs administrative rights to make and oversee resources. This requirement might raise security concerns, but it's important to clarify that it only pertains to the deployment process within the platform. There is an alternative approach available. You can manually create permissions for each deployment flow. This alternative method can be used to address and lessen these security concerns.</p>"},{"location":"operator-guide/capsule/#installation","title":"Installation","text":"<p>To install the Capsule tool, use the Cluster Add-Ons approach. For more details, please refer to the Capsule official page.</p>"},{"location":"operator-guide/capsule/#configuration","title":"Configuration","text":"<p>To use Capsule in EDP, follow the steps below:</p> <ol> <li> <p>Run the command below to upgrade EDP with Capsule capabilities:</p> <pre><code>helm upgrade --install edp epamedp/edp-install -n edp --values values.yaml --set cd-pipeline-operator.tenancyEngine=capsule\n</code></pre> </li> <li> <p>Open the <code>CapsuleConfiguration</code> custom resource called <code>default</code>:</p> <pre><code>kubectl edit CapsuleConfiguration default\n</code></pre> <p>Add the tenant name (by default, it's the EDP namespace name) to the manifest's spec section as follows:</p> <pre><code>spec:\nuserGroups:\n- system:serviceaccounts:edp\n</code></pre> </li> </ol> <p>As a result, EDP will be using Capsule capabilities to manage tenants, thus providing better access management.</p>"},{"location":"operator-guide/capsule/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP With Values File</li> <li>Cluster Add-Ons Overview</li> <li>Set Up Kiosk</li> <li>EDP Kiosk Usage</li> </ul>"},{"location":"operator-guide/configure-keycloak-oidc-eks/","title":"EKS OIDC With Keycloak","text":"<p>This article provides the instruction of configuring Keycloak as OIDC Identity Provider for EKS. The example is written on Terraform (HCL).</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#prerequisites","title":"Prerequisites","text":"<p>To follow the instruction, check the following prerequisites:</p> <ol> <li>terraform 0.14.10</li> <li>hashicorp/aws = 4.8.0</li> <li>mrparkers/keycloak &gt;= 3.0.0</li> <li>hashicorp/kubernetes ~&gt; 2.9.0</li> <li>kubectl = 1.22</li> <li>kubelogin  &gt;= v1.25.1</li> <li>Ensure that Keycloak has network availability for AWS (not in a private network).</li> </ol> <p>Note</p> <p>To connect OIDC with a cluster, install and configure the kubelogin plugin. For Windows, it is recommended to download the kubelogin as a binary and add it to your PATH.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#solution-overview","title":"Solution Overview","text":"<p>The solution includes three types of the resources - AWS (EKS), Keycloak, Kubernetes. The left part of Keycloak resources remain unchanged after creation, thus allowing us to associate a claim for a user group membership. Other resources can be created, deleted or changed if needed. The most crucial from Kubernetes permissions are Kubernetes RoleBindings and ClusterRoles/Roles. Roles present a set of permissions, in turn RoleBindings map Kubernetes Role to representative Keycloak groups, so a group member can have just appropriate permissions.</p> <p> EKS Keycloak OIDC </p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#keycloak-configuration","title":"Keycloak Configuration","text":"<p>To configure Keycloak, follow the steps described below.</p> <ul> <li>Create a client:</li> </ul> <pre><code>resource \"keycloak_openid_client\" \"openid_client\" {\nrealm_id                                  = \"openshift\"\nclient_id                                 = \"kubernetes\"\naccess_type                               = \"CONFIDENTIAL\"\nstandard_flow_enabled                     = true\nimplicit_flow_enabled                     = false\ndirect_access_grants_enabled              = true\nservice_accounts_enabled                  = true\noauth2_device_authorization_grant_enabled = true\nbackchannel_logout_session_required       = true\n\nroot_url    = \"http://localhost:8000/\"\nbase_url    = \"http://localhost:8000/\"\nadmin_url   = \"http://localhost:8000/\"\nweb_origins = [\"*\"]\n\nvalid_redirect_uris = [\n\"http://localhost:8000/*\"\n]\n}\n</code></pre> <ul> <li>Create the client scope:</li> </ul> <pre><code>resource \"keycloak_openid_client_scope\" \"openid_client_scope\" {\nrealm_id               = &lt;realm_id&gt;\nname                   = \"groups\"\ndescription            = \"When requested, this scope will map a user's group memberships to a claim\"\ninclude_in_token_scope = true\nconsent_screen_text    = false\n}\n</code></pre> <ul> <li>Add scope to the client by selecting all default client scope:</li> </ul> <pre><code>resource \"keycloak_openid_client_default_scopes\" \"client_default_scopes\" {\nrealm_id  = &lt;realm_id&gt;\nclient_id = keycloak_openid_client.openid_client.id\n\ndefault_scopes = [\n\"profile\",\n\"email\",\n\"roles\",\n\"web-origins\",\nkeycloak_openid_client_scope.openid_client_scope.name,\n]\n}\n</code></pre> <ul> <li>Add the following mapper to the client scope:</li> </ul> <pre><code>resource \"keycloak_openid_group_membership_protocol_mapper\" \"group_membership_mapper\" {\nrealm_id            = &lt;realm_id&gt;\nclient_scope_id     = keycloak_openid_client_scope.openid_client_scope.id\nname                = \"group-membership-mapper\"\nadd_to_id_token     = true\nadd_to_access_token = true\nadd_to_userinfo     = true\nfull_path           = false\n\nclaim_name = \"groups\"\n}\n</code></pre> <ul> <li>In the authorization token, get groups membership field with the list of group membership in the realm: <pre><code>...\n\"email_verified\": false,\n\"name\": \"An User\",\n\"groups\": [\n\"&lt;env_prefix_name&gt;-oidc-viewers\",\n\"&lt;env_prefix_name&gt;-oidc-cluster-admins\"\n],\n\"preferred_username\": \"an_user@example.com\",\n\"given_name\": \"An\",\n\"family_name\": \"User\",\n\"email\": \"an_user@example.com\"\n...\n</code></pre></li> </ul> <ul> <li>Create group/groups, e.g. admin group:</li> </ul> <pre><code>resource \"keycloak_group\" \"oidc_tenant_admin\" {\nrealm_id = &lt;realm_id&gt;\nname     = \"kubernetes-oidc-admins\"\n}\n</code></pre>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#eks-configuration","title":"EKS Configuration","text":"<p>To configure EKS, follow the steps described below. In AWS Console, open EKS home page -&gt; Choose a cluster -&gt; Configuration tab -&gt; Authentication tab.</p> <p>The Terraform code for association with Keycloak:</p> <ul> <li>terraform.tfvars <pre><code>...\ncluster_identity_providers = {\nkeycloak = {\nclient_id                     = &lt;keycloak_client_id&gt;\nidentity_provider_config_name = \"Keycloak\"\nissuer_url                    = \"https://&lt;keycloak_url&gt;/auth/realms/&lt;realm_name&gt;\"\ngroups_claim                  = \"groups\"\n}\n...\n</code></pre></li> <li>the resource code <pre><code>resource \"aws_eks_identity_provider_config\" \"keycloak\" {\nfor_each = { for k, v in var.cluster_identity_providers : k =&gt; v if true }\n\ncluster_name = var.platform_name\n\noidc {\nclient_id                     = each.value.client_id\ngroups_claim                  = lookup(each.value, \"groups_claim\", null)\ngroups_prefix                 = lookup(each.value, \"groups_prefix\", null)\nidentity_provider_config_name = try(each.value.identity_provider_config_name, each.key)\nissuer_url                    = each.value.issuer_url\nrequired_claims               = lookup(each.value, \"required_claims\", null)\nusername_claim                = lookup(each.value, \"username_claim\", null)\nusername_prefix               = lookup(each.value, \"username_prefix\", null)\n}\n\ntags = var.tags\n}\n</code></pre></li> </ul> <p>Note</p> <p>The resource creation takes around 20-30 minutes. The resource doesn't support updating, so each change will lead to deletion of the old instance and creation of a new instance instead.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#kubernetes-configuration","title":"Kubernetes Configuration","text":"<p>To connect the created Keycloak resources with permissions, it is necessary to create Kubernetes Roles and RoleBindings:</p> <ul> <li>ClusterRole <pre><code>resource \"kubernetes_cluster_role_v1\" \"oidc_tenant_admin\" {\nmetadata {\nname = \"oidc-admin\"\n}\nrule {\napi_groups = [\"*\"]\nresources  = [\"*\"]\nverbs      = [\"*\"]\n}\n}\n</code></pre></li> <li>ClusterRoleBinding <pre><code>resource \"kubernetes_cluster_role_binding_v1\" \"oidc_cluster_rb\" {\nmetadata {\nname = \"oidc-cluster-admin\"\n}\nrole_ref {\napi_group = \"rbac.authorization.k8s.io\"\nkind      = \"ClusterRole\"\nname      = kubernetes_cluster_role_v1.oidc_tenant_admin.metadata[0].name\n}\nsubject {\nkind      = \"Group\"\nname      = keycloak_group.oidc_tenant_admin.name\napi_group = \"rbac.authorization.k8s.io\"\n    # work-around due https://github.com/hashicorp/terraform-provider-kubernetes/issues/710\nnamespace = \"\"\n}\n}\n</code></pre></li> </ul> <p>Note</p> <p>When creating the Keycloak group, ClusterRole, and ClusterRoleBinding, a user receives cluster admin permissions. There is also an option to provide admin permissions just to a particular namespace or another resources set in another namespace. For details, please refer to the Mixing Kubernetes Roles page.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#kubeconfig","title":"Kubeconfig","text":"<p>Template for kubeconfig:</p> <p><pre><code>apiVersion: v1\npreferences: {}\nkind: Config\n\nclusters:\n- cluster:\nserver: https://&lt;eks_url&gt;.eks.amazonaws.com\ncertificate-authority-data: &lt;certificate_authority_data&gt;\nname: &lt;cluster_name&gt;\n\ncontexts:\n- context:\ncluster: &lt;cluster_name&gt;\nuser: &lt;keycloak_user_email&gt;\nname: &lt;cluster_name&gt;\n\ncurrent-context: &lt;cluster_name&gt;\n\nusers:\n- name: &lt;keycloak_user_email&gt;\nuser:\nexec:\napiVersion: client.authentication.k8s.io/v1beta1\ncommand: kubectl\nargs:\n- oidc-login\n- get-token\n- -v1\n- --oidc-issuer-url=https://&lt;keycloak_url&gt;/auth/realms/&lt;realm&gt;\n- --oidc-client-id=&lt;keycloak_client_id&gt;\n- --oidc-client-secret=&lt;keycloak_client_secret&gt;\n</code></pre> Flag -v1 can be used for debug, in a common case it's not needed and can be deleted.</p> <p>To find the client secret:</p> <ol> <li>Open Keycloak</li> <li>Choose realm</li> <li>Find keycloak_client_id that was previously created</li> <li>Open Credentials tab</li> <li>Copy Secret</li> </ol>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#testing","title":"Testing","text":"<p>Before testing, ensure that a user is a member of the correct Keycloak group. To add a user to a Keycloak group:</p> <ol> <li>Open Keycloak</li> <li>Choose realm</li> <li>Open user screen with search field</li> <li>Find a user and open the configuration</li> <li>Open Groups tab</li> <li>In Available Groups, choose an appropriate group</li> <li>Click the Join button</li> <li>The group should appear in the Group Membership list</li> </ol> <p>Follow the steps below to test the configuration:</p> <ul> <li>Run kubectl command, it is important to specify the correct kubeconfig: <pre><code>KUBECONFIG=&lt;path_to_oidc_kubeconfig&gt; kubectl get ingresses -n &lt;namespace_name&gt;\n</code></pre></li> <li>After the first run and redirection to the Keycloak login page, log in using credentials (login:password) or using SSO Provider. In case of the successful login, you will receive the following notification that can be closed:</li> </ul> <p> OIDC Successful Login </p> <ul> <li>As the result, a respective response from the Kubernetes will appear in the console in case a user is configured correctly and is a member of the correct group and Roles/RoleBindings.</li> </ul> <ul> <li>If something is not set up correctly, the following output error will be displayed: <pre><code>Error from server (Forbidden): ingresses.networking.k8s.io is forbidden:\nUser \"https://&lt;keycloak_url&gt;/auth/realms/&lt;realm&gt;#&lt;keycloak_user_id&gt;\"\ncannot list resource \"ingresses\" in API group \"networking.k8s.io\" in the namespace \"&lt;namespace_name&gt;\"\n</code></pre></li> </ul>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#session-update","title":"Session Update","text":"<p>To update the session, clear cache. The default location for the login cache:</p> <pre><code>rm -rf ~/.kube/cache\n</code></pre>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#access-cluster-via-lens","title":"Access Cluster via Lens","text":"<p>To access the Kubernetes cluster via Lens, follow the steps below to configure it:</p> <ul> <li>Add a new kubeconfig to the location where Lens has access. The default location of the kubeconfig is ~/.kube/config but it can be changed by navigating to File -&gt; Preferences -&gt; Kubernetes -&gt; Kubeconfig Syncs;</li> <li>(Optional) Using Windows, it is recommended to reboot the system after adding a new kubeconfig.</li> <li>Authenticate on the Keycloak login page to be able to access the cluster;</li> </ul> <p>Note</p> <p>Lens does not add namespaces of the project automatically, so it is necessary to add them manually, simply go to Settings -&gt; Namespaces and add the namespaces of a project.</p>"},{"location":"operator-guide/configure-keycloak-oidc-eks/#related-articles","title":"Related Articles","text":"<ul> <li>Headlamp OIDC Configuration</li> </ul>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/","title":"Integrate Harbor With EDP Pipelines","text":"<p>Harbor serves as a tool for storing images and artifacts. This documentation contains instructions on how to create a project in Harbor and set up a robot account for interacting with the registry from CI pipelines.</p>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#overview","title":"Overview","text":"<p>Harbor integration with Tekton enables the centralized storage of container images within the cluster, eliminating the need for external services. By leveraging Harbor as the container registry, users can manage and store their automation results and reports in one place.</p>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#integration-procedure","title":"Integration Procedure","text":"<p>The integration process involves two steps:</p> <ol> <li> <p>Creating a project to store application images.</p> </li> <li> <p>Creating two accounts with different permissions to push (read/write) and pull (read-only) project images.</p> </li> </ol>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#create-new-project","title":"Create New Project","text":"<p>The process of creating new projects is the following:</p> <ol> <li>Log in to the Harbor console using your credentials.</li> <li> <p>Navigate to the Projects menu, click the New Project button:</p> <p> Projects menu </p> </li> <li> <p>On the New Project menu, enter a project name that matches your EDP namespace in the Project Name field. Keep other fields as default and click OK to continue:</p> <p> New Project menu </p> </li> </ol>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#set-up-robot-account","title":"Set Up Robot Account","text":"<p>To make EDP and Harbor project interact with each other, set up a robot account:</p> <ol> <li> <p>Navigate to your newly created project, select Robot Accounts menu and choose New Robot Account:</p> <p> Create Robot Account menu </p> </li> <li> <p>In the pop-up window, fill in the fields as follows:</p> <ul> <li>Name - <code>edp-push</code>;</li> <li>Expiration time -  set the value which is aligned with your organization policy;</li> <li>Description - <code>read/write permissions</code>;</li> <li>Permissions - <code>Pull Repository</code> and <code>Push Repository</code>.</li> </ul> <p>To proceed, click the ADD button:</p> <p> Robot Accounts menu </p> </li> <li> <p>In the appeared window, copy the robot account credentials or click the Export to file button to save the secret and account name locally:</p> <p> New credentials for Robot Account </p> </li> <li> <p>Provision the kaniko-docker-config secrets using kubectl, EDP Portal or with the externalSecrets operator:</p> <p>Example</p> <p>The <code>auth</code> string can be generated by this command: <pre><code>echo -n \"robot\\$edp-project+edp:secret\" | base64\n</code></pre></p> kubectlManual SecretExternal Secrets Operator <pre><code>  apiVersion: v1\nkind: Secret\nmetadata:\nname: kaniko-docker-config\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: registry\ntype: kubernetes.io/dockerconfigjson\nstringData:\n.dockerconfigjson: |\n{\n\"auths\" : {\n\"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Fill in the required fields and click <code>Save</code>.</p> <p> Registry update manual secret </p> <pre><code>\"kaniko-docker-config\":\n{\"auths\" : \"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Here, you will observe the <code>Managed by ExternalSecret</code> message:</p> <p> Registry managed by external secret operator </p> <p>Note</p> <p>More details of External Secrets Operator Integration can be found in the External Secrets Operator Integration page.</p> </li> <li> <p>Repeat steps 2-3 with values below:</p> <ul> <li>Name - <code>edp-pull</code>;</li> <li>Expiration time -  set the value which is aligned with your organization policy;</li> <li>Description - <code>read-only permissions</code>;</li> <li>Permissions - <code>Pull Repository</code>.</li> </ul> </li> <li> <p>Provision the regcred secrets using kubectl, EDP Portal or with the externalSecrets operator:</p> <p>Example</p> <p>The <code>auth</code> string can be generated by this command: <pre><code>echo -n \"robot\\$edp-project+edp-push:secret\" | base64\n</code></pre></p> kubectlManual SecretExternal Secrets Operator <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: regcred\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: registry\ntype: kubernetes.io/dockerconfigjson\nstringData:\n.dockerconfigjson: |\n{\n\"auths\" : {\n\"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Fill in the required fields and click Save.</p> <p> Registry update manual secret </p> <pre><code>\"regcred\":\n{\"auths\" : \"harbor-registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"secret-string\"\n}\n}\n</code></pre> <p>Navigate to <code>EDP Portal UI</code> -&gt; <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Registry</code>. Here, you will observe the <code>Managed by ExternalSecret</code> message:</p> <p> Registry managed by external secret operator </p> <p>Note</p> <p>More details of External Secrets Operator Integration can be found in the External Secrets Operator Integration page.</p> </li> <li> <p>In the values.yaml file for the edp-install Helm chart, set the following values for the specified fields:</p> Manual SecretExternal Secrets Operator <p>If the <code>kaniko-docker-config</code> secret has been created manually:</p> values.yaml<pre><code>...\nkaniko:\nexistingDockerConfig: \"kaniko-docker-config\"\nglobal:\ndockerRegistry:\nurl: harbor-registry.com\ntype: \"harbor\"\n...\n</code></pre> <p>If the <code>kaniko-docker-config</code> secret has been created via External Secrets Operator:</p> values.yaml<pre><code>...\nkaniko:\nexistingDockerConfig: \"kaniko-docker-config\"\nexternalSecrets:\nenabled: true\nglobal:\ndockerRegistry:\nurl: harbor-registry.com\ntype: \"harbor\"\n...\n</code></pre> </li> <li> <p>(Optional)  If you've already deployed the EDP Helm chart, you can update it using the following command:</p> <pre><code>helm update --install edp epamedp/edp-install \\\n--values values.yaml \\\n--namespace edp\n</code></pre> </li> </ol> <p>As a result, application images built in EDP Portal will be stored in Harbor project and will be deployed from the harbor registry.</p> <p>Harbor projects can be added and retained with a retention policy generated through the EDP script in edp-cluster-add-ons.</p>"},{"location":"operator-guide/container-registry-harbor-integration-tekton-ci/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Harbor</li> <li>Adjust Jira Integration</li> <li>Custom SonarQube Integration</li> </ul>"},{"location":"operator-guide/delete-edp/","title":"Uninstall EDP","text":"<p>This tutorial provides detailed instructions on the optimal method to uninstall the EPAM Delivery Platform.</p>"},{"location":"operator-guide/delete-edp/#deletion-procedure","title":"Deletion Procedure","text":"<p>To uninstall EDP, perform the following steps:</p> <ol> <li> <p>It is highly recommended to delete all the resources created via EDP Portal UI first. It can be:</p> <ul> <li>Applications;</li> <li>Libraries;</li> <li>Autotests;</li> <li>Infrastructures;</li> <li>CD Pipelines.</li> </ul> <p>We recommend deleting them via EDP Portal UI respectively, although it is also possible to delete all the EDP Portal resources using the <code>kubectl delete</code> command.</p> </li> <li> <p>Delete application namespaces. They should be called according to the <code>edp-&lt;cd-pipeline&gt;-&lt;stage-name&gt;</code> pattern.</p> </li> <li> <p>Uninstall EDP the same way it was installed.</p> </li> <li> <p>Run the script that deletes the rest of the custom resources:</p> View: CleanEDP.sh <pre><code>#!/bin/sh\n\n###################################################################\n# A POSIX script to remove EDP Kubernetes Custom Resources        #\n#                                                                 #\n# PREREQUISITES                                                   #\n#     kubectl&gt;=1.23.x, awscli (for EKS authentication)            #\n#                                                                 #\n# TESTED                                                          #\n#     OS: Ubuntu, FreeBSD, Windows (GitBash)                      #\n#     Shells: zsh, bash, dash                                     #\n###################################################################\n\n[ -n \"${DEBUG}\" ] &amp;&amp; set -x\n\nset -e\n\nexit_err() {\nprintf '%s\\n' \"$1\" &gt;&amp;2\nexit 1\n}\n\ncheck_kubectl() {\nif ! hash kubectl; then\nexit_err \"Error: kubectl is not installed\"\nfi\n}\n\nget_script_help() {\nself_name=\"$(basename \"$0\")\"\necho \"\\\n${self_name} deletes EDP Kubernetes Custom Resources\n\nUsage: ${self_name}\n\nOptions:\n${self_name} [OPTION] [FILE]\n\n-h, --help          Print Help\n-k, --kubeconfig    Pass Kubeconfig file\n\nDebug:\nDEBUG=true ${self_name}\n\nExamples:\n${self_name} --kubeconfig ~/.kube/custom_config\"\n}\n\nyellow_fg() {\ntput setaf 3 || true\n}\n\nno_color_out() {\ntput sgr0 || true\n}\n\nget_current_context() {\nkubectl config current-context\n}\n\nget_context_ns() {\nkubectl config view \\\n--minify --output jsonpath='{..namespace}' 2&gt; /dev/null\n}\n\nget_ns() {\nkubectl get ns \"${edp_ns}\" --output name --request-timeout='5s'\n}\n\ndelete_ns() {\nkubectl delete ns \"${edp_ns}\" --timeout='30s'\n}\n\nget_edp_crds() {\nkubectl get crds --no-headers=true | awk '/edp.epam.com/ {print $1}'\n}\n\nget_all_edp_crs_manif() {\nkubectl get \"${edp_crds_comma_list}\" -n \"${edp_ns}\" \\\n--output yaml --ignore-not-found --request-timeout='15s'\n}\n\ndel_all_edp_crs() {\nkubectl delete --all \"${edp_crds_comma_list}\" -n \"${edp_ns}\" \\\n--ignore-not-found --timeout='15s'\n}\n\niterate_edp_crs() {\nedp_crds_comma_list=\"$(printf '%s' \"${edp_crds}\" | tr -s '\\n' ',')\"\nget_all_edp_crs_manif \\\n| sed '/finalizers:/,/.*:/{//!d;}' \\\n| kubectl replace -f - || true\ndel_all_edp_crs || true\n}\n\niterate_edp_crds() {\nn=0\nwhile [ \"$n\" -lt 2 ]; do\nn=$((n + 1))\n\nif [ \"$n\" -eq 2 ]; then\n# Delete remaining resources\nedp_crds=\"keycloakclients,codebasebranches,jenkinsfolders\"\niterate_edp_crs\necho \"EDP Custom Resources in NS ${color_ns} have been deleted.\"\nbreak\nfi\n\necho \"Replacing EDP CR Manifests. Wait for output (may take 2min)...\"\nedp_crds=\"$(get_edp_crds)\"\niterate_edp_crs\ndone\n}\n\nselect_ns() {\nis_context=\"$(get_current_context)\" || exit 1\nprintf '%s' \"Current cluster: \"\nprintf '%s\\n' \"$(yellow_fg)${is_context}$(no_color_out)\"\n\ncurrent_ns=\"$(get_context_ns)\" || true\n\nprintf '%s\\n' \"Enter EDP namespace\"\nprintf '%s' \"Skip to use [$(yellow_fg)${current_ns}$(no_color_out)]: \"\nread -r edp_ns\n\nif [ -z \"${edp_ns}\" ]; then\nedp_ns=\"${current_ns}\"\necho \"${edp_ns}\"\nif [ -z \"${edp_ns}\" ]; then\nexit_err \"Error: namespace is not specified\"\nfi\nelse\nget_ns || exit 1\nfi\n\ncolor_ns=\"$(yellow_fg)${edp_ns}$(no_color_out)\"\n}\n\nchoose_delete_ns() {\nprintf '%s\\n' \"Do you want to delete namespace ${color_ns} as well? (y/n)?\"\nprintf '%s' \"Skip or enter [N/n] to keep the namespace: \"\nread -r answer\nif [ \"${answer}\" != \"${answer#[Yy]}\" ]; then\ndelete_edp_ns=true\necho \"Namespace ${color_ns} is marked for deletion.\"\nelse\necho \"Skipped. Deleting EDP Custom Resources only.\"\nfi\n}\n\ndelete_ns_if_true() {\nif [ \"${delete_edp_ns}\" = true ]; then\necho \"Deleting ${color_ns} namespace...\"\ndelete_ns || exit 1\nfi\n}\n\ninvalid_option() {\nexit_err \"Invalid option '$1'. Use -h, --help for details\"\n}\n\nmain_func() {\ncheck_kubectl\nselect_ns\nchoose_delete_ns\niterate_edp_crds\ndelete_ns_if_true\n}\n\nwhile [ \"$#\" -gt 0 ]; do\ncase \"$1\" in\n-h | --help)\nget_script_help\nexit 0\n;;\n-k | --kubeconfig)\nshift\n[ $# = 0 ] &amp;&amp; exit_err \"No Kubeconfig file specified\"\nexport KUBECONFIG=\"$1\"\n;;\n--)\nbreak\n;;\n-k* | --k*)\necho \"Did you mean '--kubeconfig'?\"\ninvalid_option \"$1\"\n;;\n-* | *)\ninvalid_option \"$1\"\n;;\nesac\nshift\ndone\n\nmain_func\n</code></pre> <p>The script will prompt user to specify the namespace where EDP was deployed in and choose if the namespace is going to be deleted. This script will delete EDP custom resources in the namespace specified by user.</p> </li> <li> <p>In Keycloak, delete the <code>edp-main</code> realm, also delete client which is supposed to be called by the <code>edp-main</code> pattern in the openshift realm.</p> </li> </ol>"},{"location":"operator-guide/delete-edp/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install EDP via Helmfile</li> <li>Keycloak Integration</li> </ul>"},{"location":"operator-guide/delete-jenkins-job-provision/","title":"Delete Jenkins Job Provision","text":"<p>To delete the job provisioner, take the following steps:</p> <ol> <li> <p>Delete the job provisioner from Jenkins. Navigate to Admin Console-&gt;Jenkins-&gt;jobs-&gt;job-provisions folder, select the necessary provisioner and click the drop-down right to the provisioner name. Select Delete project.</p> <p> Delete job provisioner </p> </li> </ol>"},{"location":"operator-guide/dependency-track/","title":"Install DependencyTrack","text":"<p>This documentation guide provides comprehensive instructions for installing and integrating DependencyTrack with the EPAM Delivery Platform.</p>"},{"location":"operator-guide/dependency-track/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/dependency-track/#installation","title":"Installation","text":"<p>To install DependencyTrack use EDP addons approach.</p>"},{"location":"operator-guide/dependency-track/#configuration","title":"Configuration","text":"<ol> <li> <p>Open <code>Administration</code> -&gt; <code>Access Management</code> -&gt; <code>Teams</code>. Click <code>Create Team</code> -&gt; <code>Automation</code> and click <code>Create</code>.</p> </li> <li> <p>Click <code>+</code> in <code>Permissions</code> and add:</p> <pre><code>BOM_UPLOAD\nPROJECT_CREATION_UPLOAD\nVIEW_PORTFOLIO\n</code></pre> </li> <li> <p>Click <code>+</code> in <code>API keys</code> to create token:</p> </li> </ol> <p> DependencyTrack settings </p> <ol> <li>Provision secrets using manifest, EDP Portal, or with the externalSecrets operator:</li> </ol> manifestEDP Portal UIExternal Secrets Operator <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-dependency-track\nnamespace: &lt;edp&gt;\nlabels:\napp.edp.epam.com/secret-type: dependency-track\nstringData:\ntoken: &lt;dependency-track-token&gt;\nurl: &lt;dependency-track-api-url&gt;\ntype: Opaque\n</code></pre> <p>Go to the <code>EDP Portal UI</code> open <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>DependencyTrack</code> apply <code>Token</code> and <code>URL</code> click the <code>save</code> button.</p> <p> DependencyTrack update manual secret </p> <p>Store DependencyTrack URL and Token in the AWS Parameter Store with the following format: <pre><code>\"ci-dependency-track\":\n{\n\"token\": \"XXXXXXXXXXXX\",\n\"url\": \"https://dependency-track.example.com\"\n}\n</code></pre></p> <p>Go to the <code>EDP Platform UI</code> open <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>DependencyTrack</code> see the <code>Managed by External Secret</code>.</p> <p> DependencyTrack managed by external secret operator </p> <p>More detail on External Secrets Operator Integration can be found on the following page</p> <p>After following the instructions provided, you should be able to integrate your DependencyTrack with the EPAM Delivery Platform.</p>"},{"location":"operator-guide/dependency-track/#related-articles","title":"Related Articles","text":"<ul> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Cluster Add-Ons Overview</li> </ul>"},{"location":"operator-guide/deploy-aws-eks/","title":"Deploy AWS EKS Cluster","text":"<p>This instruction provides detailed information on the Amazon Elastic Kubernetes Service cluster deployment and contains the additional setup such as Argo CD installation and EDP addons usage for the infrastructure management.</p>"},{"location":"operator-guide/deploy-aws-eks/#prerequisites","title":"Prerequisites","text":"<p>Before the EKS cluster deployment and configuration, make sure to check the prerequisites. Install the required tools listed below:</p> <ul> <li>Git</li> <li>Terraform</li> <li>AWS CLI</li> <li>tfenv</li> </ul> <p>To check the correct tools installation, run the following commands:</p> <pre><code>git --version\nterraform version\naws --version\ntfenv --version\n</code></pre>"},{"location":"operator-guide/deploy-aws-eks/#terraform-backend","title":"Terraform Backend","text":"<p>This step will do the following:</p> <ul> <li>Create S3 bucket with policy to store terraform states.</li> </ul> <ul> <li>Create DynamoDB to support state locking and consistency checking.</li> </ul> <p>To create the required resources, do the following:</p> <ol> <li> <p>Fork and clone git repo with project edp-terraform-aws-platform, rename it in the correspondence with project name.</p> <pre><code>git clone https://github.com/epmd-edp/edp-terraform-aws-platform.git\nmv edp-terraform-aws-platform edp-terraform-aws-platform-edp\ncd edp-terraform-aws-platform-edp/s3-backend\n</code></pre> </li> <li> <p>Fill the input variables for Terraform run in the <code>s3-backend/template.tfvars</code> file, refer to the s3-backend/example.tfvars as an example.</p> <p><pre><code># -- e.g eu-central-1\nregion = \"&lt;REGION&gt;\" # mandatory\n\ntags = {\n\"SysName\"      = \"Terraform-Backend\"\n\"SysOwner\"     = \"owner@example.com\"\n\"Environment\"  = \"EKS-TEST-CLUSTER\"\n} # isn't required\n</code></pre> Find the detailed description of the variables in the s3-backend/variables.tf file.</p> </li> <li> <p>Run Terraform apply. Initialize the backend and apply the changes.</p> <pre><code>terraform init\nterraform apply -var-file=./template.tfvars\n</code></pre> View: Terraform output example <pre><code>Outputs:\n\nterraform_lock_table_dynamodb_id = \"terraform_locks\"\nterraform_states_s3_bucket_name = \"terraform-states-012345678910\"\n</code></pre> </li> <li> <p>(Optional) Commit the local state.</p> <pre><code>git add s3-backend/terraform.tfstate\ngit commit -m \"Terraform state for s3-backend\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-aws-eks/#aws-account-and-iam-roles","title":"AWS Account and IAM Roles","text":"<p>This step will do the following:</p> <ul> <li>Create the AWS IAM role EKSDeployerRole</li> </ul> <ul> <li>Create the AWS IAM role ServiceRoleForEKSWorkerNode</li> </ul> <ul> <li>Create the AWS IAM role AWSServiceRoleEKS</li> </ul> <p>Take the following steps:</p> <ol> <li> <p>Navigate to IAM module directory.</p> <pre><code>cd ../iam\n</code></pre> </li> <li> <p>(Optional) Setup backend for store Terraform states remotely and support state locking and consistency checking via DynamoDB. Insert the missing fields in the file <code>iam/providers.tf</code>.</p> <pre><code>...\nbackend \"s3\" {\nbucket         = \"terraform-states-&lt;ACCOUNT_ID&gt;\"\nkey            = \"&lt;REGION&gt;/&lt;CLUSTER_NAME&gt;/iam/terraform.tfstate\"\nregion         = \"&lt;REGION&gt;\"\nacl            = \"bucket-owner-full-control\"\ndynamodb_table = \"terraform_locks\"\nencrypt        = true\n}\n...\n</code></pre> <p>Note</p> <p>If you plan to work with a local state, then comment out this block (the EDP team does not recommend this approach)</p> </li> <li> <p>Fill in the input variables for Terraform run in the <code>iam/template.tfvars</code> file. Use the iam/example.tfvars as an example. Please find the detailed description of the variables in the iam/variables.tf file.</p> <pre><code># Template file to use as an example to create terraform.tfvars file. Fill the gaps instead of &lt;...&gt;\n# More details on each variable can be found in the variables.tf file\n\n# -- Condition to create or not IAM role for cluster deploy\ncreate_iam_deployer = true\n\n# -- Condition to create or not IAM role for Kaniko deploy\n# -- Need in case if used ECR registry. Create it after deploy EKS CLuster\ncreate_iam_kaniko = false\n\n# -- Worker and Deployer role variables\n\n# -- e.g eu-central-1\nregion = \"&lt;REGION&gt;\" # mandatory\n\n# -- Information about boundary policies\n# -- https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html\niam_permissions_boundary_policy_arn = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:policy/eo_role_boundary\" # mandatory\n\ntags = \"\" # isn't mandatory\n\n# -- Kaniko role variables\n\n# -- More information\n# -- https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers.html\ncluster_oidc_issuer_url = \"https://oidc.eks.&lt;AWS_REGION&gt;.amazonaws.com/id/&lt;AWS_OIDC_ID&gt;\"\n\noidc_provider_arn = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/oidc.eks.&lt;AWS_REGION&gt;.amazonaws.com/id/&lt;AWS_OIDC_ID&gt;\"\n\nnamespace = \"edp\"\n</code></pre> </li> <li> <p>Initialize the backend and apply the changes.</p> <pre><code>terraform init\nterraform apply -var-file=./template.tfvars\n</code></pre> View: Terraform output example <pre><code>Outputs:\n\nkaniko_iam_role_arn = []\nkaniko_iam_role_name = []\ndeployer_iam_role_arn = [\n\"arn:aws:iam::012345678910:role/EKSDeployerRole\",\n]\ndeployer_iam_role_name = [\n\"EKSDeployerRole\",\n]\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-aws-eks/#aws-vpc-configuration-optional","title":"AWS VPC configuration (Optional)","text":"<p>This step will do the following:</p> <ul> <li>Create the AWS VPC</li> </ul> <ul> <li>Create the AWS VPC Subnets for instances and LB</li> </ul> <ul> <li>Create the AWS VPC Routing</li> </ul> <p>Take the following steps:</p> <ol> <li> <p>Navigate to VPC module directory.</p> <pre><code>cd ../vpc\n</code></pre> </li> <li> <p>(Optional) Setup backend for store Terraform states remotely and support state locking and consistency checking via DynamoDB. Insert the missing fields in the file <code>vpc/providers.tf</code>.</p> <pre><code>...\nbackend \"s3\" {\nbucket         = \"terraform-states-&lt;ACCOUNT_ID&gt;\"\nkey            = \"&lt;REGION&gt;/&lt;CLUSTER_NAME&gt;/vpc/terraform.tfstate\"\nregion         = \"&lt;REGION&gt;\"\nacl            = \"bucket-owner-full-control\"\ndynamodb_table = \"terraform_locks\"\nencrypt        = true\n}\n...\n</code></pre> <p>Note</p> <p>If you plan to work with a local state, then comment out this block (the EDP team does not recommend this approach)</p> </li> <li> <p>Fill in the input variables for Terraform run in the <code>vpc/template.tfvars</code> file. Use the vpc/example.tfvars as an example. Please find the detailed description of the variables in the vpc/variables.tf file.</p> <pre><code># -- e.g eu-central-1\nregion   = \"&lt;REGION&gt;\"\n\nrole_arn = \"arn:aws:iam::&lt;ACCOUNT_ID&gt;:role/EKSDeployerRole\"\n\nplatform_name = \"&lt;PLATFORM_NAME&gt;\"\n\n# -- VPC CIDR, e.g. \"10.0.0.0/16\"\nplatform_cidr = \"&lt;PLATFORM_CIDR&gt;\"\n\n# -- VPC Subnets AZs, e.g. [\"eu-central-1a\", \"eu-central-1b\", \"eu-central-1c\"]\nsubnet_azs    = [\"&lt;SUBNET_AZS1&gt;\", \"&lt;SUBNET_AZS2&gt;\"]\n\n# -- Private Subnets CIDR, e.g. [\"10.0.1.0/24\", \"10.0.2.0/24\", \"10.0.3.0/24\"]\nprivate_cidrs = [\"&lt;PRIVATE_CIDRS1&gt;\", \"&lt;PRIVATE_CIDRS2&gt;\"]\n\n# -- Private Subnets CIDR, e.g. [\"10.0.101.0/24\", \"10.0.102.0/24\", \"10.0.103.0/24\"]\npublic_cidrs  = [\"&lt;PUBLIC_CIDRS1&gt;\", \"&lt;PUBLIC_CIDRS2&gt;\"]\n\n# -- Tags for resources, isn't mandatory\ntags = \"\"\n</code></pre> </li> <li> <p>Initialize the backend and apply the changes.</p> <pre><code>terraform init\nterraform apply -var-file=./template.tfvars\n</code></pre> View: Terraform output example <pre><code>Outputs:\n\nprivate_subnets = [\n\"subnet-012345678910\",\n  \"subnet-012345678910\",\n  \"subnet-012345678910\",\n]\npublic_subnets = [\n\"subnet-012345678910\",\n  \"subnet-012345678910\",\n  \"subnet-012345678910\",\n]\nvpc_id = \"vpc-012345678910\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-aws-eks/#deploy-and-preconfigure-aws-eks","title":"Deploy and preconfigure AWS EKS","text":"<p>This step will do the following:</p> <ul> <li>Create the EKS Cluster</li> </ul> <ul> <li>Configure the EKS base configuration</li> </ul> <ul> <li>Deploy base components into EKS cluster</li> </ul> <ul> <li>Instal and configure Argo CD</li> </ul> <ul> <li>Onboard EDP addons on EKS cluster</li> </ul> <p>Take the following steps:</p> <ol> <li> <p>Navigate to EKS module directory.</p> <pre><code>cd ../eks\n</code></pre> </li> <li> <p>(Optional) Setup backend for store Terraform states remotely and support state locking and consistency checking via DynamoDB. Insert the missing fields in the file <code>eks/providers.tf</code>.</p> <pre><code>...\nbackend \"s3\" {\nbucket         = \"terraform-states-&lt;ACCOUNT_ID&gt;\"\nkey            = \"&lt;REGION&gt;/&lt;CLUSTER_NAME&gt;/eks/terraform.tfstate\"\nregion         = \"&lt;REGION&gt;\"\nacl            = \"bucket-owner-full-control\"\ndynamodb_table = \"terraform_locks\"\nencrypt        = true\n}\n...\n</code></pre> <p>Note</p> <p>If you plan to work with a local state, then comment out this block (the EDP team does not recommend this approach)</p> </li> <li> <p>Fill in the input variables for Terraform run in the <code>eks/template.tfvars</code> file. Use the eks/example.tfvars as an example. Please find the detailed description of the variables in the eks/variables.tf file.</p> <pre><code># -- e.g eu-central-1\nregion               = \"&lt;REGION&gt;\"\nplatform_name        = \"&lt;PLATFORM_NAME&gt;\"\nplatform_domain_name = \"&lt;PLATFORM_DNS&gt;\"\n\nrole_arn                      = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/EKSDeployerRole\"\nrole_permissions_boundary_arn = \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:policy/eo_role_boundary\"\n\nvpc_id             = \"&lt;VPC_ID&gt;\" # VPC ID\nprivate_subnets_id = []         # EKS must have two subnets.\npublic_subnets_id  = []         # ALB must have two subnets.\n\ninfra_public_security_group_ids = [] # List with security groups\n\n# -- Parameter in AWS Parameter Store that contain data in format \"account:token\" in base64 format\nadd_userdata = &lt;&lt;EOF\nexport TOKEN=$(aws ssm get-parameter --name &lt;PARAMETER_NAME&gt; --query 'Parameter.Value' --region &lt;REGION&gt; --output text)\ncat &lt;&lt;DATA &gt; /var/lib/kubelet/config.json\n{\n  \"auths\":{\n    \"https://index.docker.io/v1/\":{\n      \"auth\":\"$TOKEN\"\n    }\n  }\n}\nDATA\nEOF\n\nspot_instance_types = [] # list with instance types\n\naws_auth_users = [] # -- AWS List users\ntags           = \"\"\n\nenable_argocd = true\n\nargocd_manage_add_ons = true\n\neks_addons_repo_ssh_key_secret_name = \"&lt;AWS_SECRET_MANAGER_KEY&gt;\" # ssh key with add-ons repository\n\nrepo_url = \"&lt;SSH_REPO_URL&gt;\" # repository with add-ons\n\naddons_path = \"&lt;ADD_ONS_FOLDER&gt;\" # path to add-ons folder at repository\n\n# OIDC Identity provider\ncluster_identity_providers = {}\n</code></pre> <p>This section contains variables to configure addons approach. Please find the detailed description about EDP addons.</p> </li> <li> <p>Setup Argo CD for work with addons and store and management cluster applications using the GitOps approach. Fill in the input variables in the file eks/values/argocd-values.yaml.</p> <pre><code>configs:\nssh:\nknownHosts: |\n# -- list of known host in format:\n# [host]:port key-type key\n# Example\n# [ssh.github.com]:443 ssh-rsa qgSdfOuiYhew/+afhQnvjfjhnhnqgSdfOuiYhew/+afhQnvjfjhnhn\n...\nserver:\ningress:\nhosts:\n- \"argocd.example.com\"\n</code></pre> </li> <li> <p>Update local Kubernetes configuration:</p> <pre><code>aws eks update-kubeconfig --region &lt;REGION&gt; --name &lt;CLUSTER_NAME&gt;\n</code></pre> </li> </ol> <p>After following the instructions provided, you should be able to configure AWS and create an EKS cluster with installed base utilities.</p>"},{"location":"operator-guide/deploy-aws-eks/#related-articles","title":"Related Articles","text":"<ul> <li>Cluster Add-Ons Overview</li> <li>Install EDP</li> </ul>"},{"location":"operator-guide/deploy-okd-4.10/","title":"Deploy OKD 4.10 Cluster","text":"<p>This instruction provides detailed information on the OKD 4.10 cluster deployment in the AWS Cloud and contains the additional setup necessary for the managed infrastructure.</p> <p>A full description of the cluster deployment can be found in the official documentation.</p>"},{"location":"operator-guide/deploy-okd-4.10/#prerequisites","title":"Prerequisites","text":"<p>Before the OKD cluster deployment and configuration, make sure to check the prerequisites.</p>"},{"location":"operator-guide/deploy-okd-4.10/#required-tools","title":"Required Tools","text":"<ol> <li> <p>Install the following tools listed below:</p> <ul> <li>AWS CLI</li> <li>OpenShift CLI</li> <li>Lens (optional)</li> </ul> </li> <li> <p>Create the AWS IAM user with the required permissions. Make sure the AWS account is active, and the user doesn't have a permission boundary. Remove any Service Control Policy (SCP) restrictions from the AWS account.</p> </li> <li> <p>Generate a key pair for cluster node SSH access. Please perform the steps below:</p> <ul> <li>Generate the SSH key. Specify the path and file name, such as ~/.ssh/id_ed25519, of the new SSH key. If there is an existing key pair, ensure that the public key is in the ~/.ssh directory.<pre><code>ssh-keygen -t ed25519 -N '' -f &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key identity to the SSH agent for a local user if it has not already been added.<pre><code>eval \"$(ssh-agent -s)\"\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key to the ssh-agent:<pre><code>ssh-add &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> </li> <li> <p>Build the <code>ccoctl</code> tool:</p> <ul> <li>Clone the <code>cloud-credential-operator</code> repository.<pre><code>git clone https://github.com/openshift/cloud-credential-operator.git\n</code></pre> </li> </ul> <ul> <li>Move to the <code>cloud-credential-operator</code> folder and build the <code>ccoctl</code> tool.<pre><code>cd cloud-credential-operator &amp;&amp; git checkout release-4.10\nGO_PACKAGE='github.com/openshift/cloud-credential-operator'\ngo build -ldflags \"-X $GO_PACKAGE/pkg/version.versionFromGit=$(git describe --long --tags --abbrev=7 --match 'v[0-9]*')\" ./cmd/ccoctl\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#prepare-for-the-deployment-process","title":"Prepare for the Deployment Process","text":"<p>Before deploying the OKD cluster, please perform the steps below:</p>"},{"location":"operator-guide/deploy-okd-4.10/#create-aws-resources","title":"Create AWS Resources","text":"<p>Create the AWS resources with the Cloud Credential Operator utility (the <code>ccoctl</code> tool):</p> <ol> <li> <p>Generate the public and private RSA key files that are used to set up the OpenID Connect identity provider for the cluster:</p> <pre><code>./ccoctl aws create-key-pair\n</code></pre> </li> <li> <p>Create an OpenID Connect identity provider and an S3 bucket on AWS:</p> <pre><code>./ccoctl aws create-identity-provider \\\n--name=&lt;NAME&gt; \\\n--region=&lt;AWS_REGION&gt; \\\n--public-key-file=./serviceaccount-signer.public\n</code></pre> <p>where:</p> <ul> <li>NAME - is the name used to tag any cloud resources created for tracking,</li> <li>AWS_REGION - is the AWS region in which cloud resources will be created.</li> </ul> </li> <li> <p>Create the IAM roles for each component in the cluster:</p> <ul> <li> <p>Extract the list of the <code>CredentialsRequest</code> objects from the OpenShift Container Platform release image:</p> <pre><code>oc adm release extract \\\n--credentials-requests \\\n--cloud=aws \\\n--to=./credrequests \\\n--quay.io/openshift-release-dev/ocp-release:4.10.25-x86_64\n</code></pre> <p>Note</p> <p>A version of the openshift-release-dev docker image can be found in the Quay registry.</p> </li> </ul> <ul> <li>Use the <code>ccoctl</code> tool to process all <code>CredentialsRequest</code> objects in the <code>credrequests</code> directory:<pre><code>ccoctl aws create-iam-roles \\\n--name=&lt;NAME&gt; \\\n--region=&lt;AWS_REGION&gt; \\\n--credentials-requests-dir=./credrequests\n--identity-provider-arn=arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;NAME&gt;-oidc.s3.&lt;AWS_REGION&gt;.amazonaws.com\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#create-okd-manifests","title":"Create OKD Manifests","text":"<p>Before deploying the OKD cluster, please perform the steps below:</p> <ol> <li> <p>Download the OKD installer.</p> </li> <li> <p>Extract the installation program:</p> <pre><code>tar -xvf openshift-install-linux.tar.gz\n</code></pre> </li> <li> <p>Download the installation pull secret for any private registry. This pull secret allows to authenticate with the services that are provided by the authorities, including Quay.io, serving the container images for OKD components. For example, here is a pull secret for Docker Hub:</p> The pull secret for the private registry <pre><code>{\n\"auths\":{\n\"https://index.docker.io/v1/\":{\n\"auth\":\"$TOKEN\"\n}\n}\n}\n</code></pre> </li> <li> <p>Create a deployment directory and the install-config.yaml file:</p> <pre><code>mkdir okd-deployment\ntouch okd-deployment/install-config.yaml\n</code></pre> <p>To specify more details about the OKD cluster platform or to modify the values of the required parameters, customize the install-config.yaml file for the AWS. Please see below an example of the customized file:</p> install-config.yaml - OKD cluster\u2019s platform installation configuration file <pre><code>apiVersion: v1\nbaseDomain: &lt;YOUR_DOMAIN&gt;\ncredentialsMode: Manual\ncompute:\n- architecture: amd64\nhyperthreading: Enabled\nname: worker\nplatform:\naws:\nrootVolume:\nsize: 30\nzones:\n- eu-central-1a\ntype: r5.large\nreplicas: 3\ncontrolPlane:\narchitecture: amd64\nhyperthreading: Enabled\nname: master\nplatform:\naws:\nrootVolume:\nsize: 50\nzones:\n- eu-central-1a\ntype: m5.xlarge\nreplicas: 3\nmetadata:\ncreationTimestamp: null\nname: 4-10-okd-sandbox\nnetworking:\nclusterNetwork:\n- cidr: 10.128.0.0/14\nhostPrefix: 23\nmachineNetwork:\n- cidr: 10.0.0.0/16\nnetworkType: OVNKubernetes\nserviceNetwork:\n- 172.30.0.0/16\nplatform:\naws:\nregion: eu-central-1\nuserTags:\nuser:tag: 4-10-okd-sandbox\npublish: External\npullSecret: &lt;PULL_SECRET&gt;\nsshKey: |\n&lt;SSH_KEY&gt;\n</code></pre> <p>where:</p> <ul> <li>YOUR_DOMAIN - is a base domain,</li> <li>PULL_SECRET - is a created pull secret for a private registry,</li> <li>SSH_KEY - is a created SSH key.</li> </ul> </li> <li> <p>Create the required OpenShift Container Platform installation manifests:</p> <pre><code>./openshift-install create manifests --dir okd-deployment\n</code></pre> </li> <li> <p>Copy the manifests generated by the <code>ccoctl</code> tool to the <code>manifests</code> directory created by the installation program:</p> <pre><code>cp ./manifests/* ./okd-deployment/manifests/\n</code></pre> </li> <li> <p>Copy the private key generated in the <code>tls</code> directory by the <code>ccoctl</code> tool to the installation directory:</p> <pre><code>cp -a ./tls ./okd-deployment\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#deploy-the-cluster","title":"Deploy the Cluster","text":"<p>To initialize the cluster deployment, run the following command:</p> <pre><code>./openshift-install create cluster --dir okd-deployment --log-level=info\n</code></pre> <p>Note</p> <p>If the cloud provider account configured on the host does not have sufficient permissions to deploy the cluster, the installation process stops, and the missing permissions are displayed.</p> <p>When the cluster deployment is completed, directions for accessing the cluster are displayed in the terminal, including a link to the web console and credentials for the kubeadmin user. The <code>kubeconfig</code> for the cluster will be located in okd-deployment/auth/kubeconfig.</p> Example output <pre><code>...\nINFO Install complete!\nINFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'\nINFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com\nINFO Login to the console with the user: \"kubeadmin\", and password: \"4vYBz-Ee6gm-ymBZj-Wt5AL\"\nINFO Time elapsed: 36m22s:\n</code></pre> <p>Warning</p> <p>The Ignition config files contain certificates that expire after 24 hours, which are then renewed at that time. Do not turn off the cluster for this time, or you will have to update the certificates manually. See OpenShift Container Platform documentation for more information.</p>"},{"location":"operator-guide/deploy-okd-4.10/#log-into-the-cluster","title":"Log Into the Cluster","text":"<p>To log into the cluster, export the <code>kubeconfig</code>:</p> <pre><code>  export KUBECONFIG=&lt;installation_directory&gt;/auth/kubeconfig\n</code></pre> <p>Optionally, use the Lens tool for further work with the Kubernetes cluster.</p> <p>Note</p> <p>To install and manage the cluster, refer to Lens documentation.</p>"},{"location":"operator-guide/deploy-okd-4.10/#manage-okd-cluster-without-the-inbound-rules","title":"Manage OKD Cluster Without the Inbound Rules","text":"<p>In order to manage the OKD cluster without the <code>0.0.0.0/0</code> inbound rules, please perform the steps below:</p> <ol> <li> <p>Create a Security Group with a list of your external IPs:</p> <pre><code>aws ec2 create-security-group --group-name &lt;SECURITY_GROUP_NAME&gt; --description \"&lt;DESCRIPTION_OF_SECURITY_GROUP&gt;\" --vpc-id &lt;VPC_ID&gt;\naws ec2 authorize-security-group-ingress \\\n--group-id '&lt;SECURITY_GROUP_ID&gt;' \\\n--ip-permissions 'IpProtocol=all,PrefixListIds=[{PrefixListId=&lt;PREFIX_LIST_ID&gt;}]'\n</code></pre> </li> <li> <p>Manually attach this new Security Group to all master nodes of the cluster.</p> </li> <li> <p>Create another Security Group with an Elastic IP of the Cluster VPC:</p> <pre><code>aws ec2 create-security-group --group-name custom-okd-4-10 --description \"Cluster Ip to 80, 443\" --vpc-id &lt;VPC_ID&gt;\naws ec2 authorize-security-group-ingress \\\n--group-id '&lt;SECURITY_GROUP_ID&gt;' \\\n--protocol all \\\n--port 80 \\\n--cidr &lt;ELASTIC_IP_OF_CLUSTER_VPC&gt;\naws ec2 authorize-security-group-ingress \\\n--group-id '&lt;SECURITY_GROUP_ID&gt;' \\\n--protocol all \\\n--port 443 \\\n--cidr &lt;ELASTIC_IP_OF_CLUSTER_VPC&gt;\n</code></pre> </li> <li> <p>Modify the cluster load balancer via the <code>router-default</code> svc in the <code>openshift-ingress</code> namespace, paste two Security Groups created on previous steps:</p> The pull secret for the private registry <pre><code>apiVersion: v1\nkind: Service\nmetadata:\n  name: router-default\n  namespace: openshift-ingress\n  annotations:\n    service.beta.kubernetes.io/aws-load-balancer-additional-resource-tags: \"tag_name=some_value\"\n    service.beta.kubernetes.io/aws-load-balancer-security-groups: \"&lt;SECURITY_GROUP_IDs&gt;\"\n    ...\n</code></pre> </li> </ol>"},{"location":"operator-guide/deploy-okd-4.10/#optimize-spot-instances-usage","title":"Optimize Spot Instances Usage","text":"<p>In order to optimize the usage of Spot Instances on the AWS, add the following line under the <code>providerSpec</code> field in the MachineSet of Worker Nodes:</p> <pre><code>providerSpec:\nvalue:\nspotMarketOptions: {}\n</code></pre>"},{"location":"operator-guide/deploy-okd-4.10/#related-articles","title":"Related Articles","text":"<ul> <li>Deploy AWS EKS Cluster</li> <li>Manage Jenkins Agent</li> <li>Associate IAM Roles With Service Accounts</li> <li>Deploy OKD 4.9 Cluster</li> </ul>"},{"location":"operator-guide/deploy-okd/","title":"Deploy OKD 4.9 Cluster","text":"<p>This instruction provides detailed information on the OKD 4.9 cluster deployment in the AWS Cloud and contains the additional setup necessary for the managed infrastructure.</p> <p>A full description of the cluster deployment can be found in the official documentation.</p>"},{"location":"operator-guide/deploy-okd/#prerequisites","title":"Prerequisites","text":"<p>Before the OKD cluster deployment and configuration, make sure to check the prerequisites.</p>"},{"location":"operator-guide/deploy-okd/#required-tools","title":"Required Tools","text":"<ol> <li> <p>Install the following tools listed below:</p> <ul> <li>AWS CLI</li> <li>OpenShift CLI</li> <li>Lens (optional)</li> </ul> </li> <li> <p>Create the AWS IAM user with the required permissions. Make sure the AWS account is active, and the user doesn't have a permission boundary. Remove any Service Control Policy (SCP) restrictions from the AWS account.</p> </li> <li> <p>Generate a key pair for cluster node SSH access. Please perform the steps below:</p> <ul> <li>Generate the SSH key. Specify the path and file name, such as ~/.ssh/id_ed25519, of the new SSH key. If there is an existing key pair, ensure that the public key is in the ~/.ssh directory.<pre><code> ssh-keygen -t ed25519 -N '' -f &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key identity to the SSH agent for a local user if it has not already been added.<pre><code> eval \"$(ssh-agent -s)\"\n</code></pre> </li> </ul> <ul> <li>Add the SSH private key to the ssh-agent:<pre><code> ssh-add &lt;path&gt;/&lt;file_name&gt;\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd/#prepare-for-the-deployment-process","title":"Prepare for the Deployment Process","text":"<p>Before deploying the OKD cluster, please perform the steps below:</p> <ol> <li> <p>Download the OKD installer.</p> </li> <li> <p>Extract the installation program:</p> <pre><code>tar -xvf openshift-install-linux.tar.gz\n</code></pre> </li> <li> <p>Download the installation pull secret for any private registry.</p> <p>This pull secret allows to authenticate with the services that are provided by the included authorities, including Quay.io serving container images for OKD components. For example, here is a pull secret for Docker Hub:</p> The pull secret for the private registry <pre><code>{\n  \"auths\":{\n    \"https://index.docker.io/v1/\":{\n      \"auth\":\"$TOKEN\"\n    }\n  }\n}\n</code></pre> </li> <li> <p>Create the deployment directory and the install-config.yaml file:</p> <pre><code>mkdir okd-deployment\ntouch okd-deployment/install-config.yaml\n</code></pre> <p>To specify more details about the OKD cluster platform or to modify the values of the required parameters, customize the install-config.yaml file for AWS. Please see an example of the customized file below:</p> install-config.yaml - OKD cluster\u2019s platform installation configuration file <pre><code>apiVersion: v1\nbaseDomain: &lt;YOUR_DOMAIN&gt;\ncompute:\n- architecture: amd64\n  hyperthreading: Enabled\n  name: worker\n  platform:\n    aws:\n      zones:\n        - eu-central-1a\n      rootVolume:\n        size: 50\n      type: r5.large\n  replicas: 3\ncontrolPlane:\n  architecture: amd64\n  hyperthreading: Enabled\n  name: master\n  platform:\n    aws:\n      rootVolume:\n        size: 50\n      zones:\n        - eu-central-1a\n      type: m5.xlarge\n  replicas: 3\nmetadata:\n  creationTimestamp: null\n  name: 4-9-okd-sandbox\nplatform:\n  aws:\n    region: eu-central-1\n    userTags:\n      user:tag: 4-9-okd-sandbox\npublish: External\npullSecret: &lt;PULL_SECRET&gt;\nsshKey: |\n  &lt;SSH_KEY&gt;\n</code></pre> <p>where:</p> <ul> <li>YOUR_DOMAIN - is a base domain,</li> <li>PULL_SECRET - is a created pull secret for a private registry,</li> <li>SSH_KEY - is a created SSH key.</li> </ul> </li> </ol>"},{"location":"operator-guide/deploy-okd/#deploy-the-cluster","title":"Deploy the Cluster","text":"<p>To initialize the cluster deployment, run the following command:</p> <pre><code>./openshift-install create cluster --dir &lt;installation_directory&gt; --log-level=info\n</code></pre> <p>Note</p> <p>If the cloud provider account configured on the host does not have sufficient permissions to deploy the cluster, the installation process stops, and the missing permissions are displayed.</p> <p>When the cluster deployment is completed, directions for accessing the cluster are displayed in the terminal, including a link to the web console and credentials for the kubeadmin user. The <code>kubeconfig</code> for the cluster will be located in okd-deployment/auth/kubeconfig.</p> Example output <pre><code>...\nINFO Install complete!\nINFO To access the cluster as the system:admin user when using 'oc', run 'export KUBECONFIG=/home/myuser/install_dir/auth/kubeconfig'\nINFO Access the OpenShift web-console here: https://console-openshift-console.apps.mycluster.example.com\nINFO Login to the console with the user: \"kubeadmin\", and password: \"4vYBz-Ee6gm-ymBZj-Wt5AL\"\nINFO Time elapsed: 36m22s:\n</code></pre> <p>Warning</p> <p>The Ignition config files contain certificates that expire after 24 hours, which are then renewed at that time. Do not turn off the cluster for this time, or you will have to update the certificates manually. See OpenShift Container Platform documentation for more information.</p>"},{"location":"operator-guide/deploy-okd/#log-into-the-cluster","title":"Log Into the Cluster","text":"<p>To log into the cluster, export the <code>kubeconfig</code>:</p> <pre><code>  export KUBECONFIG=&lt;installation_directory&gt;/auth/kubeconfig\n</code></pre> <p>Optionally, use the Lens tool for further work with the Kubernetes cluster.</p> <p>Note</p> <p>To install and manage the cluster, refer to Lens documentation.</p>"},{"location":"operator-guide/deploy-okd/#related-articles","title":"Related Articles","text":"<ul> <li>Deploy AWS EKS Cluster</li> <li>Manage Jenkins Agent</li> <li>Deploy OKD 4.10 Cluster</li> </ul>"},{"location":"operator-guide/ebs-csi-driver/","title":"Install Amazon EBS CSI Driver","text":"<p>The Amazon Elastic Block Store (Amazon EBS) Container Storage Interface (CSI) driver allows Amazon Elastic Kubernetes Service (Amazon EKS) clusters to manage the lifecycle of Amazon EBS volumes for Kubernetes Persistent Volumes.</p>"},{"location":"operator-guide/ebs-csi-driver/#prerequisites","title":"Prerequisites","text":"<p>An existing AWS Identity and Access Management (IAM) OpenID Connect (OIDC) provider for your cluster. To determine whether you already have an OIDC provider or to create a new one, see Creating an IAM OIDC provider for your cluster.</p> <p>To add an Amazon EBS CSI add-on, please follow the steps below:</p> <ol> <li> <p>Check your cluster details (the random value in the cluster name will be required in the next step):</p> <pre><code>kubectl cluster-info\n</code></pre> </li> <li> <p>Create Kubernetes IAM Trust Policy for Amazon EBS CSI Driver. Replace <code>AWS_ACCOUNT_ID</code> with your account ID, <code>AWS_REGION</code> with your AWS Region, and <code>EXAMPLED539D4633E53DE1B71EXAMPLE</code> with the value that was returned in the previous step. Save this Trust Policy into a file <code>aws-ebs-csi-driver-trust-policy.json</code>.</p> aws-ebs-csi-driver-trust-policy.json <pre><code>  {\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Principal\": {\n\"Federated\": \"arn:aws:iam::AWS_ACCOUNT_ID:oidc-provider/oidc.eks.AWS_REGION.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE\"\n},\n\"Action\": \"sts:AssumeRoleWithWebIdentity\",\n\"Condition\": {\n\"StringEquals\": {\n\"oidc.eks.AWS_REGION.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:aud\": \"sts.amazonaws.com\",\n\"oidc.eks.AWS_REGION.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:sub\": \"system:serviceaccount:kube-system:ebs-csi-controller-sa\"\n}\n}\n}\n]\n}\n</code></pre> <p>To get the notion of the IAM Role creation, please refer to the official documentation.</p> </li> <li> <p>Create the IAM role, for example:</p> <pre><code>aws iam create-role \\\n--role-name AmazonEKS_EBS_CSI_DriverRole \\\n--assume-role-policy-document file://\"aws-ebs-csi-driver-trust-policy.json\"\n</code></pre> </li> <li> <p>Attach the required AWS Managed Policy <code>AmazonEBSCSIDriverPolicy</code> to the role with the following command:</p> <pre><code>aws iam attach-role-policy \\\n--policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy \\\n--role-name AmazonEKS_EBS_CSI_DriverRole\n</code></pre> </li> <li> <p>Add the Amazon EBS CSI add-on using the AWS CLI. Replace <code>my-cluster</code> with the name of your cluster, <code>AWS_ACCOUNT_ID</code> with your account ID, and <code>AmazonEKS_EBS_CSI_DriverRole</code> with the name of the role that was created earlier:</p> <pre><code>aws eks create-addon --cluster-name my-cluster --addon-name aws-ebs-csi-driver \\\n--service-account-role-arn arn:aws:iam::AWS_ACCOUNT_ID:role/AmazonEKS_EBS_CSI_DriverRole\n</code></pre> <p>Note</p> <p>When the plugin is deployed, it creates the <code>ebs-csi-controller-sa</code> service account. The service account is bound to a Kubernetes <code>ClusterRole</code> with the required Kubernetes permissions. The <code>ebs-csi-controller-sa</code> service account should already be annotated with <code>arn:aws:iam::AWS_ACCOUNT_ID:role/AmazonEKS_EBS_CSI_DriverRole</code>. To check the annotation, please run:</p> <pre><code>kubectl get sa ebs-csi-controller-sa -n kube-system -o=jsonpath='{.metadata.annotations}'\n</code></pre> <p>In case pods have errors, restart the <code>ebs-csi-controller</code> deployment:</p> <pre><code>kubectl rollout restart deployment ebs-csi-controller -n kube-system\n</code></pre> </li> </ol>"},{"location":"operator-guide/ebs-csi-driver/#related-articles","title":"Related Articles","text":"<ul> <li>Creating an IAM OIDC provider for your cluster</li> <li>Creating the Amazon EBS CSI driver IAM role for service accounts</li> <li>Managing the Amazon EBS CSI driver as an Amazon EKS add-on</li> </ul>"},{"location":"operator-guide/edp-access-model/","title":"EDP Access Model","text":"<p>EDP uses two different methods to regulate access to resources, each tailored to specific scenarios:</p> <ul> <li>The initial method involves <code>roles</code> and <code>groups</code> in Keycloak and is used for SonarQube, Jenkins and partly for Nexus.</li> </ul> <ul> <li>The second method of resource access control in EDP involves <code>EDP custom resources</code>. This approach requires modifying custom resources that outline the required access privileges for every user or group and is used to govern access to Gerrit, Nexus, EDP Portal, EKS Cluster and Argo CD.</li> </ul> <p>Info</p> <p>These two approaches are not interchangeable, as each has its unique capabilities.</p>"},{"location":"operator-guide/edp-access-model/#keycloak","title":"Keycloak","text":"<p>This section explains what realm roles and realm groups are and how they function within Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#realm-roles","title":"Realm Roles","text":"<p>The Keycloak realm of <code>edp</code> has two realm roles with a composite types named <code>administrator</code> and <code>developer</code>:</p> <ul> <li>The <code>administrator</code> realm role is designed for users who need administrative access to the tools used in the project. This realm role contains two roles: <code>jenkins-administrators</code> and <code>sonar-administrators</code>. Users who are assigned the <code>administrator</code> realm role will be granted these two roles automatically.</li> </ul> <ul> <li>The <code>developer</code> realm role, on the other hand, is designed for users who need access to the development tools used in the project. This realm role also contains two roles: <code>jenkins-users</code> and <code>sonar-developers</code>. Users who are assigned the <code>developer</code> realm role will be granted these two roles automatically.</li> </ul> <p>These realm roles have been defined to make it easier to assign groups of rights to users.</p> <p>The table below shows the realm roles and the composite types they relate to.</p> Realm Role Name Regular Role Composite role administrator developer jenkins-administrators jenkins-users sonar-administrators sonar-developers"},{"location":"operator-guide/edp-access-model/#realm-groups","title":"Realm Groups","text":"<p>EDP uses two different realms for group management, <code>edp</code> and <code>openshift</code>:</p> <ul> <li>The <code>edp</code> realm contains two groups that are specifically used for controlling access to Argo CD. These groups are named <code>ArgoCDAdmins</code> and <code>ArgoCD-edp-users</code>.</li> </ul> <ul> <li>The <code>openshift</code> realm contains five groups that are used for access control in both the EDP Portal and EKS cluster. These groups are named <code>edp-oidc-admins</code>, <code>edp-oidc-builders</code>, <code>edp-oidc-deployers</code>,<code>edp-oidc-developers</code> and <code>edp-oidc-viewers</code>.</li> </ul> Realm Group Name Realm Name ArgoCDAdmins <code>edp</code> <code>ArgoCD-edp-users</code> <code>edp</code> <code>edp-oidc-admins</code> openshift <code>edp-oidc-builders</code> openshift <code>edp-oidc-deployers</code> openshift <code>edp-oidc-developers</code> openshift <code>edp-oidc-viewers</code> openshift"},{"location":"operator-guide/edp-access-model/#sonarqube","title":"SonarQube","text":"<p>In the case of SonarQube, there are two ways to manage access: via Keycloak and via EDP approach. This sections describes both of the approaches.</p>"},{"location":"operator-guide/edp-access-model/#manage-access-via-keycloak","title":"Manage Access via Keycloak","text":"<p>SonarQube access is managed using Keycloak roles in the <code>edp</code> realm. The <code>sonar-developers</code> and <code>sonar-administrators</code> realm roles are the two available roles that determine user access levels. To grant access, the corresponding role must be added to the user in Keycloak.</p> <p>For example, a user who needs developer access to SonarQube should be assigned the <code>sonar-developers</code> or <code>developer</code> composite role in Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#edp-approach-for-managing-access","title":"EDP Approach for Managing Access","text":"<p>EDP provides its own SonarQube Permission Template, which is used to manage user access and permissions for SonarQube projects.</p> <p>The template is stored in the custom SonarQube resource of the operator, an example of a custom resource can be found below.</p> <p>SonarPermissionTemplate</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: SonarPermissionTemplate\nmetadata:\nname: edp-default\nspec:\ndescription: EDP permission templates (DO NOT REMOVE)\ngroupPermissions:\n- groupName: non-interactive-users\npermissions:\n- user\n- groupName: sonar-administrators\npermissions:\n- admin\n- user\n- groupName: sonar-developers\npermissions:\n- codeviewer\n- issueadmin\n- securityhotspotadmin\n- user\nname: edp-default\nprojectKeyPattern: .+\nsonarOwner: sonar\n</code></pre> <p>The SonarQube Permission Template contains three groups: <code>non-interactive-users</code>, <code>sonar-administrators</code> and <code>sonar-developers</code>:</p> <ul> <li><code>non-interactive-users</code> are users who do not require direct access to the SonarQube project but need to be informed about the project's status and progress. This group has read-only access to the project, which means that they can view the project's data and metrics but cannot modify or interact with it in any way.</li> </ul> <ul> <li><code>sonar-administrators</code> are users who have full control over the SonarQube project. They have the ability to create, modify, and delete projects, as well as manage user access and permissions. This group also has the ability to configure SonarQube settings and perform other administrative tasks.</li> </ul> <ul> <li><code>sonar-developers</code> are users who are actively working on the SonarQube project. They have read and write access to the project, which means that they can modify the project's data and metrics. This group also has the ability to configure project-specific settings and perform other development tasks.</li> </ul> <p>These groups are designed to provide different levels of access to the SonarQube project, depending on the user's role and responsibilities.</p> <p>Info</p> <p>If a user has no group, it will have the <code>sonar-users</code> group by default. This group does not have any permissions in the <code>edp-default</code> Permission Template.</p> <p>The permissions that are attached to each of the groups are described below in the table:</p> Group Name Permissions <code>non-interactive-users</code> user <code>sonar-administrators</code> admin, user <code>sonar-developers</code> codeviewer, issueadmin, securityhotspotadmin, user <code>sonar-users</code> -"},{"location":"operator-guide/edp-access-model/#nexus","title":"Nexus","text":"<p>Users authenticate to Nexus using their Keycloak credentials.</p> <p>During the authentication process, the OAuth2-Proxy receives the user's role from Keycloak.</p> <p>Info</p> <p>Only users with either the <code>administrator</code> or <code>developer</code> role in Keycloak can access Nexus.</p> <p>Nexus has four distinct roles available, including <code>edp-admin</code>, <code>edp-viewer</code>, <code>nx-admin</code> and <code>nx-anonymous</code>. To grant the user access to one or more of these roles, an entry must be added to the custom Nexus resource.</p> <p>For instance, in the context of the custom Nexus resource, the user \"user_1@example.com\" has been assigned the \"nx-admin\" role. An example can be found below:</p> <p>Nexus</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: Nexus\nmetadata:\nname: nexus\nspec:\nbasePath: /\nedpSpec:\ndnsWildcard: example.com\nkeycloakSpec:\nenabled: false\nroles:\n- developer\n- administrator\nusers:\n- roles:\n- nx-admin\nusername: user_1@example.com\n</code></pre>"},{"location":"operator-guide/edp-access-model/#gerrit","title":"Gerrit","text":"<p>The user should use their credentials from Keycloak when authenticating to Gerrit.</p> <p>After logging into Gerrit, the user is not automatically attached to any groups. To add a user to a group, the <code>GerritGroupMember</code> custom resource must be created. This custom resource specifies the user's email address and the name of the group to which they should be added.</p> <p>The ConfigMap below is an example of the <code>GerritGroupMember</code> resource:</p> <p>GerritGroupMember</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: GerritGroupMember\nmetadata:\nname: user-admins\nspec:\naccountId: user@user.com\ngroupId: Administrators\n</code></pre> <p>After the <code>GerritGroupMember</code> resource is created, the user will have the permissions and access levels associated with that group.</p>"},{"location":"operator-guide/edp-access-model/#edp-portal-and-eks-cluster","title":"EDP Portal and EKS Cluster","text":"<p>Both Portal and EKS Cluster use Keycloak groups for controlling access. Users need to be added to the required group in Keycloak to get access. The groups that are used for access control are in the <code>openshift</code> realm.</p> <p>Note</p> <p>The <code>openshift</code> realm is used because a Keycloak client for OIDC is in this realm.</p>"},{"location":"operator-guide/edp-access-model/#keycloak-groups","title":"Keycloak Groups","text":"<p>There are two types of groups provided for users:</p> <ul> <li>Independent group: provides the minimum required permission set.</li> <li>Extension group: extends the rights of an independent group.</li> </ul> <p>For example, the <code>edp-oidc-viewers</code> group can be extended with rights from the <code>edp-oidc-builders</code> group.</p> Group Name Independent Group Extension Group <code>edp-oidc-admins</code> <code>edp-oidc-developers</code> <code>edp-oidc-viewers</code> <code>edp-oidc-builders</code> <code>edp-oidc-deployers</code> Name Action List View Getting of all namespaced resources Build Starting a PipelineRun from EDP Portal UI Deploy Deploying a new version of application via Argo CD Application Group Name View Build Deploy Full Namespace Access <code>edp-oidc-admins</code> <code>edp-oidc-developers</code> <code>edp-oidc-viewers</code> <code>edp-oidc-builders</code> <code>edp-oidc-deployers</code>"},{"location":"operator-guide/edp-access-model/#cluster-rbac-resources","title":"Cluster RBAC Resources","text":"<p>The <code>edp</code> namespace has five role bindings that provide the necessary permissions for the Keycloak groups described above.</p> Role Binding Name Role Name Groups tenant-admin cluster-admin <code>edp-oidc-admins</code> tenant-builder tenant-builder <code>edp-oidc-builders</code> tenant-deployer tenant-deployer <code>edp-oidc-deployers</code> tenant-developer tenant-developer <code>edp-oidc-developers</code> tenant-viewer view <code>edp-oidc-viewers</code> , <code>edp-oidc-developers</code> <p>Note</p> <p>EDP provides an aggregate ClusterRole with permissions to view custom EDP resources. ClusterRole is named <code>edp-aggregate-view-edp</code></p> <p>Info</p> <p>The <code>tenant-admin</code> RoleBinding will be created in a created namespace by <code>cd-pipeline-operator</code>. <code>tenant-admin</code> RoleBinding assign the <code>admin</code> role to <code>edp-oidc-admins</code> and <code>edp-oidc-developers</code> groups.</p>"},{"location":"operator-guide/edp-access-model/#grant-user-access-to-the-created-namespaces","title":"Grant User Access to the Created Namespaces","text":"<p>To provide users with admin or developer privileges for project namespaces, they need to be added to the <code>edp-oidc-admins</code> and <code>edp-oidc-developers</code> groups in Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#argo-cd","title":"Argo CD","text":"<p>In Argo CD, groups are specified when creating an AppProject to restrict access to deployed applications. To gain access to deployed applications within a project, the user must be added to their corresponding Argo CD group in Keycloak. This ensures that only authorized users can access and modify applications within the project.</p> <p>Info</p> <p>By default, only the <code>ArgoCDAdmins</code> group is automatically created in Keycloak.</p>"},{"location":"operator-guide/edp-access-model/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Portal Overview</li> <li>EKS OIDC With Keycloak</li> <li>Argo CD Integration</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/","title":"EDP Kiosk Usage","text":"<p>Explore the way Kiosk, a multi-tenancy extension for Kubernetes, is used in EDP.</p>"},{"location":"operator-guide/edp-kiosk-usage/#prerequisites","title":"Prerequisites","text":"<ul> <li>Installed Kiosk 0.2.11.</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/#diagram-of-using-kiosk-by-edp","title":"Diagram of using Kiosk by EDP","text":"<p> Kiosk usage </p> <p>Agenda</p> <ul> <li>blue - created by Helm chart;</li> <li>grey - created manually</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/#usage","title":"Usage","text":"<ul> <li>EDP installation area on a diagram is described by following link;</li> </ul> <ul> <li>Once the above step is executed, edp-cd-pipeline-operator service account will be linked to kiosk-edit ClusterRole   to get an ability for leveraging Kiosk specific resources (e.g. Space);</li> </ul> <ul> <li>Newly created stage in <code>edp</code> installation of EDP generates new Kiosk Space resource that is linked to edp Kiosk Account;</li> </ul> <ul> <li>According to Kiosk doc the Space resource creates namespace with RoleBinding that contains relation between service account   which is linked to Kiosk Account and kiosk-space-admin ClusterRole.   As cd-pipeline-operator ServiceAccount is linked to Account, it has admin permissions in all generated by him namespaces.</li> </ul>"},{"location":"operator-guide/edp-kiosk-usage/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Set Up Kiosk</li> </ul>"},{"location":"operator-guide/eks-oidc-integration/","title":"EKS OIDC Integration","text":"<p>This page is a detailed guide on integrating Keycloak with the edp-keycloak-operator to serve as an identity provider for AWS Elastic Kubernetes Service (EKS). It provides step-by-step instructions for creating necessary realms, users, roles, and client configurations for a seamless Keycloak-EKS collaboration. Additionally, it includes guidelines on installing the edp-keycloak-operator using Helm charts.</p>"},{"location":"operator-guide/eks-oidc-integration/#prerequisites","title":"Prerequisites","text":"<ul> <li>EKS Configuration is performed;</li> <li>Helm v3.10.0 is installed;</li> <li>Keycloak is installed.</li> </ul>"},{"location":"operator-guide/eks-oidc-integration/#configure-keycloak","title":"Configure Keycloak","text":"<p>To prepare Keycloak for integration with the edp-keycloak-operator, follow the steps below:</p> <ol> <li> <p>Ensure that the openshift realm is created.</p> </li> <li> <p>Create the orchestrator user and set the password in the Master realm.</p> </li> <li> <p>In the Role Mapping tab, assign the proper roles to the user:</p> <ul> <li> <p>Realm Roles:</p> <ul> <li>create-realm;</li> </ul> <ul> <li>offline_access;</li> </ul> <ul> <li>uma_authorization.</li> </ul> </li> </ul> <ul> <li> <p>Client Roles <code>openshift-realm</code>:</p> <ul> <li>impersonation;</li> </ul> <ul> <li>manage-authorization;</li> </ul> <ul> <li>manage-clients;</li> </ul> <ul> <li>manage-users.</li> </ul> </li> </ul> </li> </ol> <p> Role mappings </p>"},{"location":"operator-guide/eks-oidc-integration/#install-keycloak-operator","title":"Install Keycloak Operator","text":"<p>To install the Keycloak operator, follow the steps below:</p> <ol> <li> <p>Add the <code>epamedp</code> Helm chart to a local client:</p> <pre><code>helm repo add epamedp https://epam.github.io/edp-helm-charts/stable\nhelm repo update\n</code></pre> </li> <li> <p>Install the Keycloak operator:</p> <pre><code>helm install keycloak-operator epamedp/keycloak-operator --namespace security --set name=keycloak-operator\n</code></pre> </li> </ol>"},{"location":"operator-guide/eks-oidc-integration/#connect-keycloak-operator-to-keycloak","title":"Connect Keycloak Operator to Keycloak","text":"<p>The next stage after installing Keycloak is to integrate it with the Keycloak operator. It can be implemented with the following steps:</p> <ol> <li> <p>Create the keycloak secret that will contain username and password to perform the integration. Set your own password. The username must be orchestrator:</p> <pre><code>kubectl -n security create secret generic keycloak \\\n--from-literal=username=orchestrator \\\n--from-literal=password=&lt;password&gt;\n</code></pre> </li> <li> <p>Create the Keycloak Custom Resource with the Keycloak instance URL and the secret created in the previous step:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: Keycloak\nmetadata:\nname: main\nnamespace: security\nspec:\nsecret: keycloak                   # Secret name\nurl: https://keycloak.example.com  # Keycloak URL\n</code></pre> </li> <li> <p>Create the KeycloakRealm Custom Resource:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealm\nmetadata:\nname: control-plane\nnamespace: security\nspec:\nrealmName: control-plane\nkeycloakOwner: main\n</code></pre> </li> <li> <p>Create the KeycloakRealmGroup Custom Resource for both administrators and developers:</p> administratorsdevelopers <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmGroup\nmetadata:\nname: administrators\nnamespace: security\nspec:\nrealm: control-plane\nname: eks-oidc-administrator\n</code></pre> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmGroup\nmetadata:\nname: developers\nnamespace: security\nspec:\nrealm: control-plane\nname: eks-oidc-developers\n</code></pre> </li> <li> <p>Create the KeycloakClientScope Custom Resource:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClientScope\nmetadata:\nname: groups-keycloak-eks\nnamespace: security\nspec:\nname: groups\nrealm: control-plane\ndescription: \"Group Membership\"\nprotocol: openid-connect\nprotocolMappers:\n- name: groups\nprotocol: openid-connect\nprotocolMapper: \"oidc-group-membership-mapper\"\nconfig:\n\"access.token.claim\": \"true\"\n\"claim.name\": \"groups\"\n\"full.path\": \"false\"\n\"id.token.claim\": \"true\"\n\"userinfo.token.claim\": \"true\"\n</code></pre> </li> <li> <p>Create the KeycloakClient Custom Resource:</p> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: eks\nnamespace: security\nspec:\nadvancedProtocolMappers: true\nclientId: eks\ndirectAccess: true\npublic: false\ndefaultClientScopes:\n- groups\ntargetRealm: control-plane\nwebUrl: \"http://localhost:8000\"\n</code></pre> </li> <li> <p>Create the KeycloakRealmUser Custom Resource for both administrator and developer roles:</p> administrator roledeveloper role <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmUser\nmetadata:\nname: keycloakrealmuser-sample\nnamespace: security\nspec:\nrealm: control-plane\nusername: \"administrator\"\nfirstName: \"John\"\nlastName: \"Snow\"\nemail: \"administrator@example.com\"\nenabled: true\nemailVerified: true\npassword: \"12345678\"\nkeepResource: true\nrequiredUserActions:\n- UPDATE_PASSWORD\ngroups:\n- eks-oidc-administrator\n</code></pre> <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakRealmUser\nmetadata:\nname: keycloakrealmuser-sample\nnamespace: security\nspec:\nrealm: control-plane\nusername: \"developers\"\nfirstName: \"John\"\nlastName: \"Snow\"\nemail: \"developers@example.com\"\nenabled: true\nemailVerified: true\npassword: \"12345678\"\nkeepResource: true\nrequiredUserActions:\n- UPDATE_PASSWORD\ngroups:\n- eks-oidc-developers\n</code></pre> </li> <li> <p>As a result, Keycloak is integrated with the AWS Elastic Kubernetes Service. This integration enables users to log in to the EKS cluster effortlessly using their kubeconfig files while managing permissions through Keycloak.</p> </li> </ol>"},{"location":"operator-guide/eks-oidc-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Keycloak Installation</li> <li>EKS OIDC With Keycloak</li> </ul>"},{"location":"operator-guide/enable-irsa/","title":"Associate IAM Roles With Service Accounts","text":"<p>This page contains accurate information on how to associate an IAM role with the service account (IRSA) in EPAM Delivery Platform.</p> <p>Get acquainted with the AWS Official Documentation on the subject before proceeding.</p>"},{"location":"operator-guide/enable-irsa/#common-configuration-of-iam-roles-with-service-accounts","title":"Common Configuration of IAM Roles With Service Accounts","text":"<p>To successfully associate the IAM role with the service account, follow the steps below:</p> <ol> <li> <p>Create an IAM role that will further be associated with the service account. This role must have the following trust policy:</p> <p>IAM Role</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:&lt;SERVICE_ACCOUNT_NAMESPACE&gt;:&lt;SERVICE_ACCOUNT_NAME&gt;\"\n        }\n      }\n    }\n  ]\n}\n</code></pre> <p>View cluster's \u2039OIDC_PROVIDER\u203a URL.</p> <pre><code>  aws eks describe-cluster --name &lt;CLUSTER_NAME&gt; --query \"cluster.identity.oidc.issuer\" --output text\n</code></pre> <p>Example output:</p> <pre><code>  https://oidc.eks.us-west-2.amazonaws.com/id/EXAMPLED539D4633E53DE1B716D3041E\n</code></pre> <p>\u2039OIDC_PROVIDER\u203a in this example will be:</p> <pre><code>  oidc.eks.us-west-2.amazonaws.com/id/EXAMPLED539D4633E53DE1B716D3041E\n</code></pre> </li> <li> <p>Deploy the amazon-eks-pod-identity-webhook v0.2.0.</p> <p>Note</p> <p>The amazon-eks-pod-identity-webhook functionality is provided out of the box in EKS v1.21 and higher. This does not apply if the cluster has been upgraded from older versions. Therefore, skip step 2 and continue from step 3 in this documentation.</p> <p>2.1. Provide the stable(ed8c41f) version of the Docker image in the deploy/deployment-base.yaml file.</p> <p>2.2. Provide ${CA_BUNDLE}_in the_deploy/mutatingwebhook.yaml file:</p> <pre><code>  secret_name=$(kubectl -n default get sa default -o jsonpath='{.secrets[0].name}') \\\n  CA_BUNDLE=$(kubectl -n default get secret/$secret_name -o jsonpath='{.data.ca\\.crt}' | tr -d '\\n')\n</code></pre> <p>2.3. Deploy the Webhook:</p> <pre><code>  kubectl apply -f deploy/\n</code></pre> <p>2.4. Approve the csr:</p> <pre><code>  csr_name=$(kubectl get csr -o jsonpath='{.items[?(@.spec.username==\"system:serviceaccount:default:pod-identity-webhook\")].metadata.name}')\n  kubectl certificate approve $csr_name\n</code></pre> </li> <li> <p>Annotate the created service account with the IAM role:</p> <p>Service Account</p> <pre><code>  apiVersion: v1\n  kind: ServiceAccount\n  metadata:\n    name: &lt;SERVICE_ACCOUNT_NAME&gt;\n    namespace: &lt;NAMESPACE&gt;\n    annotations:\n      eks.amazonaws.com/role-arn: \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/&lt;IAM_ROLE_NAME&gt;\"\n</code></pre> </li> <li> <p>All newly launched pods with this service account will be modified and then use the associated IAM role. Find below the pod specification template:</p> <p>Pod Template</p> <pre><code>  apiVersion: v1\n  kind: Pod\n  metadata:\n    name: irsa-test\n    namespace: &lt;POD_NAMESPACE&gt;\n  spec:\n    serviceAccountName: &lt;SERVICE_ACCOUNT_NAME&gt;\n    securityContext:\n      fsGroup: 65534\n    containers:\n    - name: terraform\n      image: epamedp/edp-jenkins-terraform-agent:3.0.9\n      command: ['sh', '-c', 'aws sts \"get-caller-identity\" &amp;&amp; sleep 3600']\n</code></pre> </li> <li> <p>Check the logs of the created pod from the template above.</p> <p>Example output:</p> <pre><code>  {\n  \"UserId\": \"XXXXXXXXXXXXXXXXXXXXX:botocore-session-XXXXXXXXXX\",\n  \"Account\": \"XXXXXXXXXXXX\",\n  \"Arn\": \"arn:aws:sts::XXXXXXXXXXXX:assumed-role/AWSIRSATestRole/botocore-session-XXXXXXXXXX\"\n  }\n</code></pre> <p>As a result, it is possible to perform actions in AWS under the AWSIRSATestRole role.</p> </li> </ol>"},{"location":"operator-guide/enable-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Use Terraform Library in EDP</li> </ul>"},{"location":"operator-guide/external-secrets-operator-integration/","title":"External Secrets Operator Integration","text":"<p>External Secrets Operator (ESO) can be integrated with EDP.</p> <p>There are multiple Secrets Providers that can be used within ESO. EDP is integrated with two major providers:</p> <ul> <li>Kubernetes Secrets</li> <li>AWS Systems Manager Parameter Store</li> </ul> <p>EDP uses various secrets to integrate various applications. Below is a list of secrets that are used in the EDP platform and their description.</p> Secret Name Field Description keycloak username Admin username for keycloak, used by keycloak operator keycloak password Admin password for keycloak, used by keycloak operator defectdojo-ciuser-token token Defectdojo token with admin permissions defectdojo-ciuser-token url Defectdojo url kaniko-docker-config registry.com Change to registry url kaniko-docker-config username Registry username kaniko-docker-config password Registry password kaniko-docker-config auth Base64 encoded 'user:secret' string regcred registry.com Change to registry url regcred username Registry username regcred password Registry password regcred auth Base64 encoded 'user:secret' string github-config id_rsa Private key from github repo in base64 github-config token Api token github-config secretString Random string gitlab-config id_rsa Private key from gitlab repo in base64 gitlab-config token Api token gitlab-config secretString Random string jira-user username Jira username in base64 jira-user password Jira password in base64 sonar-ciuser-token username Sonar service account username sonar-ciuser-token secret Sonar service account secret nexus-ci-user username Nexus service account username nexus-ci-user password Nexus service accountpassword oauth2-proxy-cookie-secret cookie-secret Secret key for keycloak client in base64 nexus-proxy-cookie-secret cookie-secret Secret key for keycloak client in base64 keycloak-client-headlamp-secret Secret key for keycloak client in base64 keycloak-client-argo-secret Secret key for keycloak client in base64"},{"location":"operator-guide/external-secrets-operator-integration/#kubernetes-provider","title":"Kubernetes Provider","text":"<p>All secrets are stored in Kubernetes in pre-defined namespaces. EDP suggests using the following approach for secrets management:</p> <ul> <li><code>EDP_NAMESPACE-vault</code>, where EDP_NAMESPACE is a name of the namespace where EDP is deployed, such as <code>edp-vault</code>. This namespace is used by EDP platform. Access to secrets in the <code>edp-vault</code> is permitted only for <code>EDP Administrators</code>.</li> </ul> <ul> <li><code>EDP_NAMESPACE-cicd-vault</code>, where EDP_NAMESPACE is a name of the namespace where EDP is deployed, such as <code>edp-cicd-vault</code>. Development team uses access to secrets in the <code>edp-cicd-vault</code>for microservices development.</li> </ul> <p>See a diagram below for more details:</p> <p></p> <p>In order to install EDP, a list of passwords must be created. Secrets are provided automatically when using ESO.</p> <ol> <li> <p>Create a common namespace for secrets and EDP:</p> <pre><code>kubectl create namespace edp-vault\nkubectl create namespace edp\n</code></pre> </li> <li> <p>Create secrets in the <code>edp-vault</code> namespace:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: keycloak\nnamespace: edp-vault\ndata:\npassword: cGFzcw==  # pass in base64\nusername: dXNlcg==  # user in base64\ntype: Opaque\n</code></pre> </li> <li> <p>In the <code>edp-vault</code> namespace, create a Role with a permission to read secrets:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: Role\nmetadata:\nnamespace: edp-vault\nname: external-secret-store\nrules:\n- apiGroups: [\"\"]\nresources:\n- secrets\nverbs:\n- get\n- list\n- watch\n- apiGroups:\n- authorization.k8s.io\nresources:\n- selfsubjectrulesreviews\nverbs:\n- create\n</code></pre> </li> <li> <p>In the <code>edp-vault</code> namespace, create a ServiceAccount used by <code>SecretStore</code>:</p> <pre><code>apiVersion: v1\nkind: ServiceAccount\nmetadata:\nname: secret-manager\nnamespace: edp\n</code></pre> </li> <li> <p>Connect the Role from the <code>edp-vault</code> namespace with the ServiceAccount in the <code>edp</code> namespace:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\nname: eso-from-edp\nnamespace: edp-vault\nsubjects:\n- kind: ServiceAccount\nname: secret-manager\nnamespace: edp\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: Role\nname: external-secret-store\n</code></pre> </li> <li> <p>Create a SecretStore in the <code>edp</code> namespace, and use ServiceAccount for authentication:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: SecretStore\nmetadata:\nname: edp-vault\nnamespace: edp\nspec:\nprovider:\nkubernetes:\nremoteNamespace: edp-vault  # namespace with secrets\nauth:\nserviceAccount:\nname: secret-manager\nserver:\ncaProvider:\ntype: ConfigMap\nname: kube-root-ca.crt\nkey: ca.crt\n</code></pre> </li> <li> <p>Each secret must be defined by the <code>ExternalSecret</code> object. A code example below creates the <code>keycloak</code> secret in the <code>edp</code> namespace based on a secret with the same name in the <code>edp-vault</code> namespace:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: ExternalSecret\nmetadata:\nname: keycloak\nnamespace: edp\nspec:\nrefreshInterval: 1h\nsecretStoreRef:\nkind: SecretStore\nname: edp-vault\n# target:\n#   name: secret-to-be-created  # name of the k8s Secret to be created. metadata.name used if not defined\ndata:\n- secretKey: username       # key to be created\nremoteRef:\nkey: keycloak           # remote secret name\nproperty: username      # value will be fetched from this field\n- secretKey: password       # key to be created\nremoteRef:\nkey: keycloak           # remote secret name\nproperty: password      # value will be fetched from this field\n</code></pre> </li> </ol> <p>Apply the same approach for enabling secrets management in the namespaces used for microservices development, such as <code>sit</code> and <code>qa</code> on the diagram above.</p>"},{"location":"operator-guide/external-secrets-operator-integration/#aws-systems-manager-parameter-store","title":"AWS Systems Manager Parameter Store","text":"<p>AWS SSM Parameter Store can be used as a Secret Provider for ESO. For EDP, it is recommended to use the IAM Roles For Service Accounts approach (see a diagram below).</p> <p></p>"},{"location":"operator-guide/external-secrets-operator-integration/#aws-parameter-store-in-edp-scenario","title":"AWS Parameter Store in EDP Scenario","text":"<p>In order to install EDP, a list of passwords must be created. Follow the steps below, to get secrets from the SSM:</p> <ol> <li> <p>In the AWS, create an AWS IAM policy and an IAM role used by <code>ServiceAccount</code> in <code>SecretStore</code>. The IAM role must have permissions to get values from the SSM Parameter Store.</p> <p>a. Create an IAM policy that allows to get values from the Parameter Store with the <code>edp/</code> path. Use your <code>AWS Region</code> and <code>AWS Account Id</code>:</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Sid\": \"VisualEditor0\",\n\"Effect\": \"Allow\",\n\"Action\": \"ssm:GetParameter*\",\n\"Resource\": \"arn:aws:ssm:eu-central-1:012345678910:parameter/edp/*\"\n}\n]\n}\n</code></pre> <p>b. Create an AWS IAM role with trust relationships (defined below) and attach the IAM policy. Put your string for <code>Federated</code> value (see more on IRSA enablement for EKS Cluster) and AWS region.</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Principal\": {\n\"Federated\": \"arn:aws:iam::012345678910:oidc-provider/oidc.eks.eu-central-1.amazonaws.com/id/XXXXXXXXXXXXXXXXXX\"\n},\n\"Action\": \"sts:AssumeRoleWithWebIdentity\",\n\"Condition\": {\n\"StringLike\": {\n\"oidc.eks.eu-central-1.amazonaws.com/id/XXXXXXXXXXXXXXXXXX:sub\": \"system:serviceaccount:edp:*\"\n}\n}\n}\n]\n}\n</code></pre> </li> <li> <p>Create a secret in the AWS Parameter Store with the name <code>/edp/my-json-secret</code>. This secret is represented as a parameter of type string within the AWS Parameter Store:</p> View: Parameter Store JSON <pre><code>{\n\"keycloak\":\n{\n\"username\": \"keycloak-username\",\n\"password\": \"keycloak-password\"\n},\n\"defectdojo-ciuser-token\":\n{\n\"token\": \"XXXXXXXXXXXX\",\n\"url\": \"https://defectdojo.example.com\"\n},\n\"kaniko-docker-config\":\n{\n\"auths\" :\n{\n\"registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\": \"&lt;base64 encoded 'user:secret' string&gt;\"\n}\n}},\n\"regcred\":\n{\n\"auths\":\n{\n\"registry.com\":\n{\n\"username\":\"registry-username\",\n\"password\":\"registry-password\",\n\"auth\":\"&lt;base64 encoded 'user:secret' string&gt;\"\n}\n}},\n\"github-config\":\n{\n\"id_rsa\": \"id-rsa-key\",\n\"token\": \"github-token\",\n\"secretString\": \"XXXXXXXXXXXX\"\n},\n\"gitlab-config\":\n{\n\"id_rsa\": \"id-rsa-key\",\n\"token\": \"gitlab-token\",\n\"secretString\": \"XXXXXXXXXXXX\"\n},\n\"jira-user\":\n{\n\"username\": \"jira-username\",\n\"password\": \"jira-password\"\n},\n\"sonar-ciuser-token\": { \"username\": \"&lt;ci-user&gt;\",  \"secret\": \"&lt;secret&gt;\" },\n\"nexus-ci-user\": { \"username\": \"&lt;ci.user&gt;\",  \"password\": \"&lt;secret&gt;\" },\n\"oauth2-proxy-cookie-secret\": { \"cookie-secret\": \"XXXXXXXXXXXX\" },\n\"nexus-proxy-cookie-secret\": { \"cookie-secret\": \"XXXXXXXXXXXX\" },\n\"keycloak-client-headlamp-secret\":  \"XXXXXXXXXXXX\",\n\"keycloak-client-argo-secret\":  \"XXXXXXXXXXXX\"\n}\n</code></pre> </li> <li> <p>Set External Secret operator enabled by updating the values.yaml file:</p> EDP install values.yaml<pre><code>externalSecrets:\nenabled: true\n</code></pre> </li> <li> <p>Install/upgrade edp-install:</p> <pre><code>helm upgrade --install edp epamedp/edp-install --wait --timeout=900s \\\n--version &lt;edp_version&gt; \\\n--values values.yaml \\\n--namespace edp \\\n--atomic\n</code></pre> </li> </ol>"},{"location":"operator-guide/external-secrets-operator-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Install External Secrets Operator</li> </ul>"},{"location":"operator-guide/github-debug-webhooks/","title":"Debug GitHub Webhooks in Jenkins","text":"<p>A webhook enables third-party services like GitHub to send real-time updates to an application. Updates are triggered by an event or an action by the webhook provider (for example, a push to a repository, a Pull Request creation), and pushed to the application via HTTP requests, namely, Jenkins. The GitHub Jenkins job provisioner creates a webhook in the GitHub repository during the Create release pipeline once the Integrate GitHub/GitLab in Jenkins is enabled and the GitHub Webhook Configuration is completed.</p> <p>The Jenkins setup in EDP uses the following plugins responsible for listening on GitHub webhooks:</p> <ul> <li>GitHub plugin is configured to listen on Push events.</li> </ul> <ul> <li>GitHub Pull Request Builder is configured to listen on Pull Request events.</li> </ul> <p>In case of any issues with webhooks, try the following solutions:</p> <ol> <li> <p>Check that the firewalls are configured to accept the incoming traffic from the IP address range that is described in the GitHub documentation.</p> </li> <li> <p>Check that GitHub Personal Access Token is correct and has sufficient scope permissions.</p> </li> <li> <p>Check that the job has run at least once before using the hook (once an application is created in EDP, the build job should be run automatically in Jenkins).</p> </li> <li> <p>Check that both Push and issue comment and Pull Request webhooks are created on the GitHub side (unlike GitLab, GitHub does not need separate webhooks for each branch):</p> <ul> <li>Go to the GitHub repository -&gt; Settings -&gt; Webhooks.</li> </ul> <p> Webhooks settings </p> </li> <li> <p>Click each webhook and check if the event delivery is successful:</p> <ul> <li>The URL payload must be <code>https://jenkins-the-host.com/github-webhook/</code> for the GitHub plugin and <code>https://jenkins-the-host.com/ghprbhook/</code> for the GitHub Pull Request Builder.</li> <li>The content type must be application/json for Push events and application/x-www-form-urlencoded for Pull Request events.</li> <li>The html_url in the Payload request must match the repository URL and be without .git at the end of the URL.</li> </ul> </li> <li> <p>Check that the X-Hub-Signature secret is verified. It is provided by the Jenkins GitHub plugin for Push events and by the GitHub Pull Request Builder plugin for Pull Request events. The Secret field is optional. Nevertheless, if incorrect, it can prevent webhook events.</p> <p>For the GitHub plugin (Push events):</p> <ul> <li>Go to Jenkins -&gt; Manage Jenkins -&gt; Configure System, and find the GitHub plugin section.</li> <li>Select Advanced -&gt; Shared secrets to add the secret via the Jenkins Credentials Provider.</li> </ul> <p>For the GitHub Pull Request Builder (Pull Request events):</p> <ul> <li>Go to Jenkins -&gt; Manage Jenkins -&gt; Configure System, and find the GitHub Pull Request Builder plugin section.</li> <li>Check Shared secret that can be added manually.</li> </ul> </li> <li> <p>Redeliver events by clicking the Redeliver button and check the Response body.</p> <p> Manage webhook </p> <p>Note</p> <p>Use Postman to debug webhooks. Add all headers to Postman from the webhook Request -&gt; Headers field and send the payload (Request body) using the appropriate content type.</p> <p>Examples for Push and Pull Request events:</p> <p> Postman push event payload headers GitHub plugin push events </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 8:51:14 AM INFO org.jenkinsci.plugins.github.webhook.subscriber.PingGHEventSubscriber onEvent\nPING webhook received from repo &lt;https://github.com/user-profile/user-repo&gt;!\n</code></pre> <p> Postman pull request event payload headers GitHub pull request builder </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 8:17:53 AM FINE org.jenkinsci.plugins.ghprb.GhprbRootAction\nGot payload event: ping\n</code></pre> </li> <li> <p>Check that the repo pushing to Jenkins, the GitHub project URL in the project configuration, and the repos in the pipeline Job must be lined up.</p> </li> <li> <p>Enable the GitHub hook trigger for GITScm polling for the Build job.</p> <p> GitHub hook trigger </p> </li> <li> <p>Enable the GitHub Pull Request Builder for the Code Review job.</p> <p> GitHub pull request builder </p> </li> <li> <p>Filter through Jenkins log by using Jenkins custom log recorder:</p> <ul> <li>Go to Manage Jenkins -&gt; System log -&gt; Add new log recorder.</li> <li> <p>The Push events for the GitHub:</p> Logger Log Level org.jenkinsci.plugins.github.webhook.subscriber.DefaultPushGHEventSubscriber ALL com.cloudbees.jenkins.GitHubPushTrigger ALL com.cloudbees.jenkins.GitHubWebHook ALL org.jenkinsci.plugins.github.webhook.WebhookManager ALL org.jenkinsci.plugins.github.webhook.subscriber.PingGHEventSubscriber ALL </li> </ul> <ul> <li> <p>The Pull Request events for the GitHub Pull Request Builder:</p> Logger Log Level org.jenkinsci.plugins.ghprb.GhprbRootAction ALL org.jenkinsci.plugins.ghprb.GhprbTrigger ALL org.jenkinsci.plugins.ghprb.GhprbPullRequest ALL org.jenkinsci.plugins.ghprb.GhprbRepository ALL </li> </ul> <p>Note</p> <p>Below is an example of using the Pipeline script with webhooks for the GitHub plugin implemented in the EDP pipelines:</p> <pre><code>properties([pipelineTriggers([githubPush()])])\n\nnode {\n    git credentialsId: 'github-sshkey', url: 'https://github.com/someone/something.git', branch: 'master'\n}\n</code></pre> <p>Push events may not work correctly with the Job Pipeline script from SCM option in the current version of the GitHub plugin 1.34.1.</p> </li> </ol>"},{"location":"operator-guide/github-debug-webhooks/#related-articles","title":"Related Articles","text":"<ul> <li>GitHub Webhooks</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>GitHub Webhook Configuration</li> <li>Manage Jenkins CI Pipeline Job Provision</li> <li>GitHub Plugin</li> <li>GitHub Pull Request Builder</li> </ul>"},{"location":"operator-guide/github-integration/","title":"GitHub Webhook Configuration","text":"<p>Follow the steps below to automatically integrate Jenkins with GitHub webhooks.</p> <p>Note</p> <p>Before applying the GitHub integration, make sure you have already visited the Integrate GitHub/GitLab in Jenkins page.</p> <ol> <li> <p>Ensure the new job provisioner is created, as well as Secret with SSH key and GitServer custom resources.</p> </li> <li> <p>Ensure the access token for GitHub is created.</p> </li> <li> <p>Navigate to Dashboard -&gt; Manage Jenkins -&gt; Manage Credentials -&gt; Global -&gt; Add Credentials, and create new credentials with the Secret text kind. In the Secret field, provide the GitHub API token, fill in the ID field with the <code>github-access-token</code> value:</p> <p> Jenkins github credentials </p> </li> <li> <p>Navigate to Jenkins -&gt; Manage Jenkins -&gt; Configure system -&gt; GitHub, and configure the GitHub server:</p> <p> GitHub plugin config GitHub plugin Shared secrets config </p> <p>Note</p> <p>Keep the Manage hooks checkbox clear since the Job Provisioner automatically creates webhooks in the repository regardless of the checkbox selection. Select Advanced to see the shared secrets that can be used in a webhook Secret field to authenticate payloads from GitHub to Jenkins. The Secret field is optional.</p> </li> <li> <p>Configure the GitHub Pull Request Builder plugin. This plugin is responsible for listening on Pull Request webhook events and triggering Code Review jobs:</p> <p>Note</p> <p>The Secret field is optional and is used in a webhook Secret field to authenticate payloads from GitHub to Jenkins. For details, please refer to the official GitHub pull request builder plugin documentation.</p> <p> GitHub pull plugin config </p> </li> </ol>"},{"location":"operator-guide/github-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Adjust Jira Integration</li> <li>Manage Jenkins CI Pipeline Job Provision</li> </ul>"},{"location":"operator-guide/gitlab-debug-webhooks/","title":"Debug GitLab Webhooks in Jenkins","text":"<p>A webhook enables third-party services like GitLab to send real-time updates to the application. Updates are triggered by an event or action by the webhook provider (for example, a push to a repository, a Merge Request creation), and pushed to the application via the HTTP requests, namely, Jenkins. The GitLab Jenkins job provisioner creates a webhook in the GitLab repository during the Create release pipeline once the Integrate GitHub/GitLab in Jenkins is enabled and the GitLab Integration is completed.</p> <p>The Jenkins setup in EDP uses the GitLab plugin responsible for listening on GitLab webhook Push and Merge Request events.</p> <p>In case of any issues with webhooks, try the following solutions:</p> <ol> <li> <p>Check that the firewalls are configured to accept incoming traffic from the IP address range that is described in the GitLab documentation.</p> </li> <li> <p>Check that GitLab Personal Access Token is correct and has the api scope. If you have used the Project Access Token, make sure that the role is Owner or Maintainer, and it has the api scope.</p> </li> <li> <p>Check that the job has run at least once before using the hook (once an application is created in EDP, the build job should be run automatically in Jenkins).</p> </li> <li> <p>Check that both Push Events, Note Events and Merge Requests Events, Note Events webhooks are created on the GitLab side for each branch (unlike GitHub, GitLab must have separate webhooks for each branch).</p> <ul> <li>Go to the GitLab repository -&gt; Settings -&gt; Webhooks:</li> </ul> <p> Webhooks list </p> </li> <li> <p>Click Edit next to each webhook and check if the event delivery is successful. If the webhook is sent, the Recent Deliveries list becomes available. Click View details.</p> <p> Webhooks settings </p> <ul> <li>The URL payload must be similar to the job URL on Jenkins. For example: <code>https://jenkins-server.com/project/project-name/MAIN-Build-job</code> is for the Push events. <code>https://jenkins-server.com/project/project-name/MAIN-Code-review-job</code> is for the Merge Request events.</li> <li>The content type must be application/json for both events.</li> <li>The \"web_url\" in the Request body must match the repository URL.</li> <li>Project \"web_url\", \"path_with_namespace\", \"homepage\" links must be without .git at the end of the URL.</li> </ul> </li> <li> <p>Verify the Secret token (X-Gitlab-Token). This token comes from the Jenkins job due to the Jenkins GitLab Plugin and is created by our Job Provisioner:</p> <ul> <li>Go to the Jenkins job and select Configure.</li> <li>Select Advanced under the Build Triggers and check the Secret token.</li> </ul> <p>Secret token is optional and can be empty. Nevertheless, if incorrect, it can prevent webhook events.</p> </li> <li> <p>Redeliver events by clicking the Resend Request button and check the Response body.</p> <p>Note</p> <p>Use Postman to debug webhooks. Add all headers to Postman from the webhook Request Headers field and send the payload (Request body) using the appropriate content type.</p> <p>Examples for Push and Merge Request events:</p> <p> Postman push request payload headers Push request build pipeline </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 11:26:34 AM INFO com.dabsquared.gitlabjenkins.webhook.GitLabWebHook getDynamic\nWebHook call ed with url: /project/project-name/MAIN-Build-job\nJan 17, 2022 11:26:34 AM INFO com.dabsquared.gitlabjenkins.trigger.handler.AbstractWebHookTriggerHandler handle\nproject-name/MAIN-Build-job triggered for push.\n</code></pre> <p> Postman merge request payload headers Merge request code review pipeline </p> <p>The response in the Jenkins log:</p> <pre><code>Jan 17, 2022 11:14:58 AM INFO com.dabsquared.gitlabjenkins.webhook.GitLabWebHook getDynamic\nWebHook called with url: /project/project-name/MAIN-Code-review-job\n</code></pre> </li> <li> <p>Check that the repository pushing to Jenkins and the repository(ies) in the pipeline Job are lined up. GitLab Connection must be defined in the job settings.</p> </li> <li> <p>Check that the settings in the Build Triggers for the Build job are as follows:</p> <p> Build triggers build pipeline </p> </li> <li> <p>Check that the settings in the Build Triggers for the Code Review job are as follows:</p> <p> Build triggers code review pipeline </p> </li> <li> <p>Filter through Jenkins log by using Jenkins custom log recorder:</p> <ul> <li>Go to Manage Jenkins -&gt; System Log -&gt; Add new log recorder.</li> <li> <p>The Push and Merge Request events for the GitLab:</p> Logger Log Level com.dabsquared.gitlabjenkins.webhook.GitLabWebHook ALL com.dabsquared.gitlabjenkins.trigger.handler.AbstractWebHookTriggerHandler ALL com.dabsquared.gitlabjenkins.trigger.handler.merge.MergeRequestHookTriggerHandlerImpl ALL com.dabsquared.gitlabjenkins.util.CommitStatusUpdater ALL </li> </ul> </li> </ol>"},{"location":"operator-guide/gitlab-debug-webhooks/#related-articles","title":"Related Articles","text":"<ul> <li>GitLab Webhooks</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Jenkins Integration With GitLab</li> <li>GitLab Integration</li> <li>Manage Jenkins CI Pipeline Job Provision</li> <li>GitLab Plugin</li> </ul>"},{"location":"operator-guide/gitlab-integration/","title":"GitLab Webhook Configuration","text":"<p>Follow the steps below to automatically create and integrate Jenkins GitLab webhooks.</p> <p>Note</p> <p>Before applying the GitLab integration, make sure to enable Integrate GitHub/GitLab in Jenkins. For details, please refer to the Integrate GitHub/GitLab in Jenkins page.</p> <ol> <li> <p>Ensure the new job provisioner is created, as well as Secret with SSH key and GitServer custom resources.</p> </li> <li> <p>Ensure the access token for GitLab is created.</p> </li> <li> <p>Create the Jenkins Credential ID by navigating to Dashboard -&gt; Manage Jenkins -&gt; Manage Credentials -&gt; Global -&gt; Add Credentials:</p> <ul> <li>Select the Secret text kind.</li> <li>Select the Global scope.</li> <li>Secret is the access token that was created earlier.</li> <li>ID is the gitlab-access-token ID.</li> <li>Use the description of the current Credential ID.</li> </ul> <p> Jenkins credential </p> <p>Warning</p> <p>When using the GitLab integration, a webhook is automatically created. After the removal of the application, the webhook stops working but is not deleted. If necessary, it must be deleted manually.</p> <p>Note</p> <p>The next step is necessary if it is needed to see the status of Jenkins Merge Requests builds in the GitLab CI/CD Pipelines section.</p> </li> <li> <p>In order to see the status of Jenkins Merge Requests builds in the GitLab CI/CD Pipelines section, configure the    GitLab plugin by navigating to Manage Jenkins -&gt; Configure System and filling in the GitLab plugin settings:</p> <ul> <li>Connection name is gitlab.</li> <li>GitLab host URL is a host URL to GitLab.</li> <li>Use the gitlab-access-token credentials.</li> </ul> <p> GitLab plugin configuration </p> <p>Find below an example of the Merge Requests build statuses in the GitLab CI/CD Pipelines section:</p> <p> GitLab pipelines statuses </p> </li> </ol>"},{"location":"operator-guide/gitlab-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Adjust Jira Integration</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Grant Jenkins Access to the Gitlab Project</li> <li>Manage Jenkins CI Pipeline Job Provision</li> </ul>"},{"location":"operator-guide/harbor-oidc/","title":"Harbor OIDC Configuration","text":"<p>This page provides instructions for configuring OIDC authorization for Harbor. This enables the use of Single Sign-On (SSO) for authorization in Harbor and allows centralized control over user access and rights through a single configuration point.</p>"},{"location":"operator-guide/harbor-oidc/#prerequisites","title":"Prerequisites","text":"<p>Before the beginning, ensure your cluster meets the following requirements:</p> <ul> <li>Keycloak is installed;</li> <li>EPAM Delivery Platform is installed.</li> </ul>"},{"location":"operator-guide/harbor-oidc/#configure-keycloak","title":"Configure Keycloak","text":"<p>To start from, configure Keycloak by creating two Kubernetes resources. Follow the steps below to succeed:</p> <ol> <li> <p>Generate the keycloak-client-harbor-secret for Keycloak using either the commands below or using the External Secrets Operator:</p> <pre><code>keycloak_client_harbor_secret=$(openssl rand -base64 32 | head -c 32)\n</code></pre> <pre><code>kubectl -n edp create secret generic keycloak-client-harbor-secret \\\n--from-literal=cookie-secret=${keycloak_client_harbor_secret}\n</code></pre> </li> <li> <p>Create the KeycloakClient custom resource by applying the HarborKeycloakClient.yaml file in the edp namespace. This custom resource will use the <code>keycloak-client-harbor-secret</code> to include the harbor client. After the download, you will receive the created harbor client, and the password that is actually the value of the Kubernetes secret from the step 1:</p> View: HarborKeycloakClient.yaml <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: harbor\nspec:\nadvancedProtocolMappers: true\nclientId: harbor\ndirectAccess: true\npublic: false\nsecret: keycloak-client-harbor-secret\ndefaultClientScopes:\n- profile\n- email\n- roles\ntargetRealm: control-plane\nwebUrl: &lt;harbor_endpoint&gt;\nprotocolMappers:\n- name: roles\nprotocol: openid-connect\nprotocolMapper: oidc-usermodel-realm-role-mapper\nconfig:\naccess.token.claim: true\nclaim.name: roles\nid.token.claim: true\nuserinfo.token.claim: true\nmultivalued: true\n</code></pre> </li> </ol>"},{"location":"operator-guide/harbor-oidc/#configure-harbor","title":"Configure Harbor","text":"<p>The next stage is to configure Harbor. Proceed with following the steps below:</p> <ol> <li> <p>Log in to Harbor UI with an account that has Harbor system administrator privileges. To get the administrator password, execute the command below:</p> <pre><code>kubectl get secret harbor -n harbor -o jsonpath='{.data.HARBOR_ADMIN_PASSWORD}' | base64 --decode\n</code></pre> </li> <li> <p>Navigate to Administration -&gt; Configuration -&gt; Authentication. Configure OIDC using the parameters below:</p> <pre><code>auth_mode: oidc_auth\noidc_name: keycloak\noidc_endpoint: &lt;keycloak_endpoint&gt;/auth/realms/control-plane\noidc_client_id: harbor\noidc_client_secret: &lt;keycloak-client-harbor-secret&gt;\noidc_groups_claim: roles\noidc_admin_group: administrator\noidc_scope: openid,email,profile,roles\nverify_certificate: true\noidc_auto_onboard: true\noidc_user_claim: preferred_username\n</code></pre> <p> Harbor Authentication Configuration </p> </li> </ol> <p>As a result, users will be prompted to authenticate themselves when logging in to Harbor UI.</p>"},{"location":"operator-guide/harbor-oidc/#related-articles","title":"Related Articles","text":"<ul> <li>Configure Access Token Lifetime</li> <li>EKS OIDC With Keycloak</li> <li>External Secrets Operator Integration</li> <li>Integrate Harbor With EDP Pipelines</li> </ul>"},{"location":"operator-guide/headlamp-oidc/","title":"Headlamp OIDC Configuration","text":"<p>This page provides the instructions of configuring the OIDC authorization for EDP Portal UI, thus allowing using SSO for authorization in Portal and controlling user access and rights from one configuration point.</p>"},{"location":"operator-guide/headlamp-oidc/#prerequisites","title":"Prerequisites","text":"<p>Ensure the following values are set first before starting the Portal OIDC configuration:</p> <ol> <li> <p><code>realm_id</code>  = openshift</p> </li> <li> <p><code>client_id</code> = kubernetes</p> </li> <li> <p><code>keycloak_client_key</code>= keycloak_client_secret_key (received from: <code>Openshift realm</code> -&gt; <code>clients</code> -&gt; <code>kubernetes</code> -&gt; <code>Credentials</code> -&gt; <code>Client secret</code>)</p> </li> <li> <p><code>group</code> = <code>edp-oidc-admins</code>, <code>edp-oidc-builders</code>, <code>edp-oidc-deployers</code>, <code>edp-oidc-developers</code>, <code>edp-oidc-viewers</code> (Should be created manually in the realm from point 1)</p> </li> </ol> <p>Note</p> <p>The values indicated above are the result of the Keycloak configuration as an OIDC identity provider. To receive them, follow the instructions on the Keycloak OIDC EKS Configuration page.</p>"},{"location":"operator-guide/headlamp-oidc/#configure-keycloak","title":"Configure Keycloak","text":"<p>To proceed with the Keycloak configuration, perform the following:</p> <ol> <li> <p>Add the URL of the Headlamp to the <code>valid_redirect_uris</code> variable in Keycloak:</p> View: keycloak_openid_client <pre><code>  valid_redirect_uris = [\n\"https://edp-headlamp-edp.&lt;dns_wildcard&gt;/*\"\n\"http://localhost:8000/*\"\n]\n</code></pre> <p>Make sure to define the following Keycloak client values as indicated:</p> <p> Keycloak client configuration </p> </li> <li> <p>Configure the Keycloak client key in Kubernetes using the Kubernetes secrets or the External Secrets Operator:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: keycloak-client-headlamp-secret\nnamespace: edp\ntype: Opaque\nstringData:\nclientSecret: &lt;keycloak_client_secret_key&gt;\n</code></pre> </li> <li> <p>Assign user to one or more groups in Keycloak.</p> </li> </ol>"},{"location":"operator-guide/headlamp-oidc/#integrate-headlamp-with-kubernetes","title":"Integrate Headlamp With Kubernetes","text":"<p>Headlamp can be integrated in Kubernetes in three steps:</p> <ol> <li> <p>Update the values.yaml file by enabling OIDC:</p> View: values.yaml <pre><code>edp-headlamp:\nconfig:\noidc:\nenabled: true\n</code></pre> </li> <li> <p>Navigate to Headlamp and log in by clicking the <code>Sign In</code> button:</p> <p> Headlamp login page </p> </li> <li> <p>Go to <code>EDP</code> section -&gt; <code>Account</code> -&gt; <code>Settings</code>, and set up a namespace:</p> <p> Headlamp namespace settings </p> </li> </ol> <p>As a result, it is possible to control access and rights from the Keycloak endpoint.</p>"},{"location":"operator-guide/headlamp-oidc/#related-articles","title":"Related Articles","text":"<ul> <li>Configure Access Token Lifetime</li> <li>EKS OIDC With Keycloak</li> <li>External Secrets Operator</li> </ul>"},{"location":"operator-guide/import-strategy-jenkins/","title":"Integrate GitHub/GitLab in Jenkins","text":"<p>This page describes how to integrate EDP with GitLab or GitHub in case of following the Jenkins deploy scenario.</p>"},{"location":"operator-guide/import-strategy-jenkins/#integration-procedure","title":"Integration Procedure","text":"<p>To start from, it is required to add both Secret with SSH key and GitServer custom resources by taking the steps below:</p> <ol> <li> <p>Generate an SSH key pair and add a public key to GitLab    or GitHub    account.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\"\n</code></pre> </li> <li> <p>Generate access token for GitLab    or GitHub    account with read/write access to the API. Both personal and project access tokens are applicable.</p> GitHubGitLab <p>To create access token in GitHub, follow the steps below:</p> <ul> <li>Log in to GitHub.</li> <li>Click the profile account and navigate to Settings -&gt; Developer Settings.</li> <li>Select Personal access tokens (classic) and generate a new token with the following parameters:</li> </ul> <p> Repo permission </p> <p>Note</p> <p>The access below is required for the GitHub Pull Request Builder plugin to get Pull Request commits, their status, and author info.</p> <p> Admin permission User permission </p> <p>Warning</p> <p>Make sure to save a new personal access token because it won`t be displayed later.</p> <p>To create access token in GitLab, follow the steps below:</p> <ul> <li>Log in to GitLab.</li> <li>In the top-right corner, click the avatar and select Settings.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Personal access tokens </p> <ul> <li>Click the Create personal access token button.</li> </ul> <p>Note</p> <p>Make sure to save the access token as there will not be any ability to access it once again.</p> <p>In case you want to create a project access token instead of a personal one, the GitLab Jenkins plugin will be able to accept payloads from webhooks for the project only:</p> <ul> <li>Log in to GitLab and navigate to the project.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>Choose a role: Owner or Maintainer.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Project access tokens </p> <ul> <li>Click the Create project access token button.</li> </ul> </li> <li> <p>Create secret in the <code>edp</code> namespace for the Git account with the id_rsa, username, and token fields. We recommend using EDP Portal to implement this:</p> <ul> <li> <p>Open EDP Portal URL. Use the Sign-In option:</p> <p> Logging screen </p> </li> </ul> <ul> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and set the <code>Default namespace</code>. The <code>Allowed namespaces</code> field is optional. All the resources created via EDP Portal are created in the <code>Default namespace</code> whereas <code>Allowed namespaces</code> means the namespaces you are allowed to access in this cluster:</p> <p> Cluster settings </p> </li> </ul> <ul> <li> <p>Log into EDP Portal UI, select <code>EDP</code> -&gt; <code>Git Servers</code> -&gt; <code>+</code> to see the <code>Create Git Server</code> menu:</p> <p> Git Servers overview </p> </li> </ul> <ul> <li> <p>Choose your Git provider, insert Host, Access token, Private SSH key. Adjust SSH port, User and HTTPS port if needed and click <code>Apply</code>:</p> <p>Note</p> <p>Do not forget to press enter at the very end of the private key to have the last row empty.</p> <p> Create Git Servers menu </p> </li> </ul> <ul> <li> <p>After performing the steps above, two Kubernetes custom resources will be created in the default namespace: secret and GitServer. EDP Portal appends random symbols to both the secret and the GitServer to provide names with uniqueness. Also, the attempt to connect to your actual Git server will be performed. If the connection with the server is established, the Git server status should be green:</p> <p> Git server status </p> <p>Note</p> <p>The value of the nameSshKeySecret property is the name of the Secret that is indicated in the first step above.</p> </li> </ul> </li> <li> <p>Create the <code>JenkinsServiceAccount</code> custom resource with the credentials field that corresponds to the nameSshKeySecret property above:</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: JenkinsServiceAccount\nmetadata:\nname: gitlab # It can also be github.\nnamespace: edp\nspec:\ncredentials: &lt;nameSshKeySecret&gt;\nownerName: ''\ntype: ssh\n</code></pre> </li> <li> <p>Double-check that the new SSH credentials called <code>gitlab</code>/<code>github</code> are created in Jenkins using the SSH key. Navigate to <code>Jenkins</code> -&gt; <code>Manage Jenkins</code> -&gt; <code>Manage Credentials</code> -&gt; <code>(global)</code>:</p> <p> Jenkins credentials </p> </li> <li> <p>Create a new job provisioner by following the instructions for GitHub or GitLab. The job provisioner will create a job suite for an application added to EDP. The job provisioner will also create webhooks for the project in GitLab using a GitLab token.</p> </li> <li> <p>Configure GitHub or GitLab plugins in Jenkins.</p> </li> </ol>"},{"location":"operator-guide/import-strategy-jenkins/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> </ul>"},{"location":"operator-guide/import-strategy-tekton/","title":"Integrate GitHub/GitLab in Tekton","text":"<p>This page describes how to integrate EDP with GitLab or GitHub Version Control System.</p> <p></p>"},{"location":"operator-guide/import-strategy-tekton/#integration-procedure","title":"Integration Procedure","text":"<p>To start from, it is required to add both Secret with SSH key, API token, and GitServer resources by taking the steps below.</p> <ol> <li> <p>Generate an SSH key pair and add a public key to GitLab    or GitHub    account.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\"\n</code></pre> </li> <li> <p>Generate access token for GitLab    or GitHub    account with read/write access to the API. Both personal and project access tokens are applicable.</p> GitHubGitLab <p>To create access token in GitHub, follow the steps below:</p> <ul> <li>Log in to GitHub.</li> <li>Click the profile account and navigate to Settings -&gt; Developer Settings.</li> <li>Select Personal access tokens (classic) and generate a new token with the following parameters:</li> </ul> <p> Repo permission </p> <p>Note</p> <p>The access below is required for the GitHub Pull Request Builder plugin to get Pull Request commits, their status, and author info.</p> <p> Admin permission User permission </p> <p>Warning</p> <p>Make sure to save a new personal access token because it won`t be displayed later.</p> <p>To create access token in GitLab, follow the steps below:</p> <ul> <li>Log in to GitLab.</li> <li>In the top-right corner, click the avatar and select Settings.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Personal access tokens </p> <ul> <li>Click the Create personal access token button.</li> </ul> <p>Note</p> <p>Make sure to save the access token as there will not be any ability to access it once again.</p> <p>In case you want to create a project access token instead of a personal one, take the following steps:</p> <ul> <li>Log in to GitLab and navigate to the project.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>Choose a role: Owner or Maintainer.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Project access tokens </p> <ul> <li>Click the Create project access token button.</li> </ul> </li> <li> <p>Create a secret in the <code>edp</code> namespace for the Git account with the id_rsa, username, and token fields. Take the following template as an example (use ci-github instead of ci-gitlab for GitHub):</p> <pre><code>kubectl create secret generic ci-gitlab -n edp \\\n--from-file=id_rsa=id_rsa \\\n--from-literal=username=git \\\n--from-literal=token=your_gitlab_access_token\n</code></pre> </li> </ol>"},{"location":"operator-guide/import-strategy-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>GitHub WebHook Configuration</li> <li>GitLab WebHook Configuration</li> </ul>"},{"location":"operator-guide/import-strategy/","title":"Enable VCS Import Strategy","text":"<p>Enabling the VCS Import strategy is a prerequisite to integrate EDP with GitLab or GitHub.</p>"},{"location":"operator-guide/import-strategy/#general-steps","title":"General Steps","text":"<p>In order to use the Import strategy, it is required to add both Secret with SSH key and GitServer custom resources by taking the steps below.</p> <ol> <li> <p>Generate an SSH key pair and add a public key to GitLab    or GitHub    account.</p> <pre><code>ssh-keygen -t ed25519 -C \"email@example.com\"\n</code></pre> </li> <li> <p>Generate access token for GitLab    or GitHub    account with read/write access to the API. Both personal and project access tokens are applicable.</p> </li> </ol> GitHubGitLab <p>To create access token in GitHub, follow the steps below:</p> <ul> <li>Log in to GitHub.</li> <li>Click the profile account and navigate to Settings -&gt; Developer Settings.</li> <li>Select Personal access tokens (classic) and generate a new token with the following parameters:</li> </ul> <p> Repo permission </p> <p>Note</p> <p>The access below is required for the GitHub Pull Request Builder plugin to get Pull Request commits, their status, and author info.</p> <p> Admin permission User permission </p> <p>Warning</p> <p>Make sure to save a new personal access token because it won`t be displayed later.</p> <p>To create access token in GitLab, follow the steps below:</p> <ul> <li>Log in to GitLab.</li> <li>In the top-right corner, click the avatar and select Settings.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Personal access tokens </p> <ul> <li>Click the Create personal access token button.</li> </ul> <p>Note</p> <p>Make sure to save the access token as there will not be any ability to access it once again.</p> <p>In case you want to create a project access token instead of a personal one, the GitLab Jenkins plugin will be able to accept payloads from webhooks for the project only:</p> <ul> <li>Log in to GitLab and navigate to the project.</li> <li>On the User Settings menu, select Access Tokens.</li> <li>Choose a name and an optional expiry date for the token.</li> <li>Choose a role: Owner or Maintainer.</li> <li>In the Scopes block, select the api scope for the token.</li> </ul> <p> Project access tokens </p> <ul> <li>Click the Create project access token button.</li> </ul>"},{"location":"operator-guide/import-strategy/#ci-tool-specific-steps","title":"CI Tool Specific Steps","text":"<p>The further steps depend on the CI tool used.</p> Tekton CI toolJenkins CI tool <ol> <li> <p>Create a secret in the <code>edp-project</code> namespace for the Git account with the id_rsa, username, and token fields.   Take the following template as an example (use github instead of gitlab for GitHub):</p> <pre><code>kubectl create secret generic gitlab -n edp \\\n--from-file=id_rsa=id_rsa \\\n--from-literal=username=git \\\n--from-literal=token=your_gitlab_access_token\n</code></pre> </li> <li> <p>After completing the steps above, you can get back and continue installing EDP.</p> </li> </ol> <ol> <li> <p>Create secret in the <code>edp</code> namespace for the Git account with the id_rsa, username, and token fields. We recommend using EDP Portal to implement this:</p> <p>Open EDP Portal URL. Use the Sign-In option:</p> <p> Logging screen </p> <p>In the top right corner, enter the <code>Cluster settings</code> and set the <code>Default namespace</code>. The <code>Allowed namespaces</code> field is optional. All the resources created via EDP Portal are created in the <code>Default namespace</code> whereas <code>Allowed namespaces</code> means the namespaces you are allowed to access in this cluster:</p> <p> Cluster settings </p> <p>Log into EDP Portal UI, select <code>EDP</code> -&gt; <code>Git Servers</code> -&gt; <code>+</code> to see the <code>Create Git Server</code> menu:</p> <p> Git Servers overview </p> <p>Choose your Git provider, insert Host, Access token, Private SSH key. Adjust SSH port, User and HTTPS port if needed and click <code>Apply</code>:</p> <p>Note</p> <p>Do not forget to press enter at the very end of the private key to have the last row empty.</p> <p> Create Git Servers menu </p> <p>When everything is done, two custom resources will be created in the default namespace: secret and Git server. EDP Portal appends random symbols to both the secret and the server to provide names with uniqueness. Also, the attempt to connect to your Git server will be performed. If everything is correct, the Git server status should be green:</p> <p> Git server status </p> <p>Note</p> <p>The value of the nameSshKeySecret property is the name of the Secret that is indicated in the first step above.</p> </li> <li> <p>Create the <code>JenkinsServiceAccount</code> custom resource with the credentials field that corresponds to the nameSshKeySecret property above:</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: JenkinsServiceAccount\nmetadata:\nname: gitlab # It can also be github.\nnamespace: edp\nspec:\ncredentials: &lt;nameSshKeySecret&gt;\nownerName: ''\ntype: ssh\n</code></pre> </li> <li> <p>Double-check that the new SSH credentials called <code>gitlab</code>/<code>github</code> are created in Jenkins using the SSH key. Navigate to <code>Jenkins</code> -&gt; <code>Manage Jenkins</code> -&gt; <code>Manage Credentials</code> -&gt; <code>(global)</code>:</p> <p> Jenkins credentials </p> </li> <li> <p>The next step is to create a new job provisioner by following the instructions for GitHub or GitLab. The job provisioner will create a job suite for an application added to EDP. It will also create webhooks for the project in GitLab using a GitLab token.</p> </li> <li> <p>The next step is to integrate Jenkins with GitHub or GitLab by setting their plugins.</p> </li> </ol>"},{"location":"operator-guide/import-strategy/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> </ul>"},{"location":"operator-guide/install-argocd/","title":"Install Argo CD","text":"<p>Inspect the prerequisites and the main steps to perform for enabling Argo CD in EDP.</p>"},{"location":"operator-guide/install-argocd/#prerequisites","title":"Prerequisites","text":"<p>The following tools must be installed:</p> <ul> <li>Keycloak</li> <li>EDP</li> <li>Kubectl version 1.23.0</li> <li>Helm version 3.10.0</li> </ul>"},{"location":"operator-guide/install-argocd/#installation","title":"Installation","text":"<p>Argo CD enablement for EDP consists of two major steps:</p> <ul> <li>Argo CD integration with EDP (SSO enablement, codebase onboarding, etc.)</li> <li>Argo CD installation</li> </ul> <p>Info</p> <p>It is also possible to install Argo CD using the Helmfile. For details, please refer to the Install via Helmfile page.</p>"},{"location":"operator-guide/install-argocd/#integrate-with-edp","title":"Integrate With EDP","text":"<p>To enable Argo CD integration, ensure that the <code>argocd.enabled</code> flag values.yaml is set to <code>true</code></p>"},{"location":"operator-guide/install-argocd/#install-with-helm","title":"Install With Helm","text":"<p>Argo CD can be installed in several ways, please follow the official documentation for more details.</p> <p>Follow the steps below to install Argo CD using Helm:</p> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, apply the <code>SecurityContextConstraints</code> resource. Change the namespace in the <code>users</code> section if required.</p> <p> View: argocd-scc.yaml <p><pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 99\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: argo-redis-ha\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nseccompProfiles:\n- '*'\nusers:\n- system:serviceaccount:argocd:argo-redis-ha\n- system:serviceaccount:argocd:argo-redis-ha-haproxy\n- system:serviceaccount:argocd:argocd-notifications-controller\n- system:serviceaccount:argocd:argo-argocd-repo-server\n- system:serviceaccount:argocd:argocd-server\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </p> <ol> <li> <p>Check out the values.yaml file sample of the Argo CD customization, which is based on the <code>HA mode without autoscaling</code>:</p> View: kubernetes-values.yaml <pre><code>redis-ha:\nenabled: true\n\ncontroller:\nenableStatefulSet: true\n\nserver:\nreplicas: 2\nextraArgs:\n- \"--insecure\"\nenv:\n- name: ARGOCD_API_SERVER_REPLICAS\nvalue: '2'\ningress:\nenabled: true\nhosts:\n- \"argocd.&lt;Values.global.dnsWildCard&gt;\"\nconfig:\n# required when SSO is enabled\nurl: \"https://argocd.&lt;.Values.global.dnsWildCard&gt;\"\napplication.instanceLabelKey: argocd.argoproj.io/instance-edp\noidc.config: |\nname: Keycloak\nissuer: https://&lt;.Values.global.keycloakEndpoint&gt;/auth/realms/edp-main\nclientID: argocd\nclientSecret: $oidc.keycloak.clientSecret\nrequestedScopes:\n- openid\n- profile\n- email\n- groups\nrbacConfig:\n# users may be still be able to login,\n# but will see no apps, projects, etc...\npolicy.default: ''\nscopes: '[groups]'\npolicy.csv: |\n# default global admins\ng, ArgoCDAdmins, role:admin\n\nconfigs:\nparams:\napplication.namespaces: edp\n\nrepoServer:\nreplicas: 2\n\n# we use Keycloak so no DEX is required\ndex:\nenabled: false\n\n# Disabled for multitenancy env with single instance deployment\napplicationSet:\nenabled: false\n</code></pre> View: openshift-values.yaml <pre><code>redis-ha:\nenabled: true\n\ncontroller:\nenableStatefulSet: true\n\nserver:\nreplicas: 2\nextraArgs:\n- \"--insecure\"\nenv:\n- name: ARGOCD_API_SERVER_REPLICAS\nvalue: '2'\nroute:\nenabled: true\nhostname: \"argocd.&lt;.Values.global.dnsWildCard&gt;\"\ntermination_type: edge\ntermination_policy: Redirect\nconfig:\n# required when SSO is enabled\nurl: \"https://argocd.&lt;.Values.global.dnsWildCard&gt;\"\napplication.instanceLabelKey: argocd.argoproj.io/instance-edp\noidc.config: |\nname: Keycloak\nissuer: https://&lt;.Values.global.keycloakEndpoint&gt;/auth/realms/edp-main\nclientID: argocd\nclientSecret: $oidc.keycloak.clientSecret\nrequestedScopes:\n- openid\n- profile\n- email\n- groups\nrbacConfig:\n# users may be still be able to login,\n# but will see no apps, projects, etc...\npolicy.default: ''\nscopes: '[groups]'\npolicy.csv: |\n# default global admins\ng, ArgoCDAdmins, role:admin\n\nconfigs:\nparams:\napplication.namespaces: edp\n\nrepoServer:\nreplicas: 2\n\n# we use Keycloak so no DEX is required\ndex:\nenabled: false\n\n# Disabled for multitenancy env with single instance deployment\napplicationSet:\nenabled: false\n</code></pre> <p>Populate Argo CD values with the values from the EDP values.yaml:</p> <ul> <li>&lt;.Values.global.dnsWildCard&gt; is the EDP DNS WildCard.</li> <li>&lt;.Values.global.keycloakEndpoint&gt; is the Keycloak Hostname.</li> <li>We use <code>edp</code> namespace.</li> </ul> </li> <li> <p>Run the installation:</p> <pre><code>kubectl create ns argocd\nhelm repo add argo https://argoproj.github.io/argo-helm\nhelm install argo --version 5.33.1 argo/argo-cd -f values.yaml -n argocd\n</code></pre> </li> <li> <p>Update the <code>argocd-secret</code> secret in the <code>argocd</code> namespace by providing the correct Keycloak client secret (<code>oidc.keycloak.clientSecret</code>)    with the value from the <code>keycloak-client-argocd-secret</code> secret in the EDP namespace. Then restart the deployment:</p> <pre><code>ARGOCD_CLIENT=$(kubectl -n edp get secret keycloak-client-argocd-secret  -o jsonpath='{.data.clientSecret}')\nkubectl -n argocd patch secret argocd-secret -p=\"{\\\"data\\\":{\\\"oidc.keycloak.clientSecret\\\": \\\"${ARGOCD_CLIENT}\\\"}}\" -v=1\nkubectl -n argocd rollout restart deployment argo-argocd-server\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-argocd/#related-articles","title":"Related Articles","text":"<ul> <li>Argo CD Integration</li> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/install-defectdojo/","title":"Install DefectDojo","text":"<p>Inspect the main steps to perform for installing DefectDojo via Helm Chart.</p> <p>Info</p> <p>It is also possible to install DefectDojo using the EDP addons approach. For details, please refer to the EDP addons approach.</p>"},{"location":"operator-guide/install-defectdojo/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/install-defectdojo/#installation","title":"Installation","text":"<p>Info</p> <p>Please refer to the DefectDojo Helm Chart and Deploy DefectDojo into the Kubernetes cluster sections for details.</p> <p>To install DefectDojo, follow the steps below:</p> <ol> <li> <p>Check that a security namespace is created. If not, run the following command to create it:</p> <pre><code>kubectl create namespace defectdojo\n</code></pre> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, install the <code>SecurityContextConstraints</code> resource. In case of using a custom namespace for <code>defectdojo</code>, change the namespace in the <code>users</code> section.</p> <p> View: defectdojo-scc.yaml <p><pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: defectdojo\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:defectdojo:defectdojo\n- system:serviceaccount:defectdojo:defectdojo-rabbitmq\n- system:serviceaccount:defectdojo:default\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </p> <li> <p>Add a chart repository:</p> <pre><code>helm repo add defectdojo 'https://raw.githubusercontent.com/DefectDojo/django-DefectDojo/helm-charts'\nhelm repo update\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-postgresql-specific \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Note</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Create Rabbitmq admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-rabbitmq-specific \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Note</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long.</p> <p>The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Create DefectDojo admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo \\\n--from-literal=DD_ADMIN_PASSWORD=&lt;dd_admin_password&gt; \\\n--from-literal=DD_SECRET_KEY=&lt;dd_secret_key&gt; \\\n--from-literal=DD_CREDENTIAL_AES_256_KEY=&lt;dd_credential_aes_256_key&gt; \\\n--from-literal=METRICS_HTTP_AUTH_PASSWORD=&lt;metric_http_auth_password&gt;\n</code></pre> <p>Note</p> <p>The <code>dd_admin_password</code> password must be 22 characters long.</p> <p>The <code>dd_secret_key</code> password must be 128 characters long.</p> <p>The <code>dd_credential_aes_256_key</code> password must be 128 characters long.</p> <p>The <code>metric_http_auth_password</code> password must be 32 characters long.</p> </li> <li> <p>Install DefectDojo v.2.22.4 using defectdojo/defectdojo Helm chart v.1.6.69:</p> <pre><code>helm upgrade --install \\\ndefectdojo \\\n--version 1.6.69 \\\ndefectdojo/defectdojo \\\n--namespace defectdojo \\\n--values values.yaml\n</code></pre> <p>Check out the values.yaml file sample of the DefectDojo customization:</p> View: values.yaml <pre><code>tag: 2.22.4\nfullnameOverride: defectdojo\nhost: defectdojo.&lt;ROOT_DOMAIN&gt;\nsite_url: https://defectdojo.&lt;ROOT_DOMAIN&gt;\nalternativeHosts:\n- defectdojo-django.defectdojo\n\ninitializer:\n# should be false after initial installation was performed\nrun: true\ndjango:\ningress:\nenabled: true # change to 'false' for OpenShift\nactivateTLS: false\nuwsgi:\nlivenessProbe:\n# Enable liveness checks on uwsgi container. Those values are use on nginx readiness checks as well.\n# default value is 120, so in our case 20 is just fine\ninitialDelaySeconds: 20\n</code></pre> </li> <li> <p>For the OpenShift platform, install a Route:</p> View: defectdojo-route.yaml <pre><code>kind: Route\napiVersion: route.openshift.io/v1\nmetadata:\nname: defectdojo\nnamespace: defectdojo\nspec:\nhost: defectdojo.&lt;ROOT_DOMAIN&gt;\npath: /\ntls:\ninsecureEdgeTerminationPolicy: Redirect\ntermination: edge\nto:\nkind: Service\nname: defectdojo-django\nport:\ntargetPort: http\nwildcardPolicy: None\n</code></pre> </li>"},{"location":"operator-guide/install-defectdojo/#configuration","title":"Configuration","text":"<p>To prepare DefectDojo for integration with EDP, follow the steps below:</p> <ol> <li> <p>Create ci user in DefectDojo UI:</p> <ul> <li>Login to DefectDojo UI using admin credentials:  <pre><code>echo \"DefectDojo admin password: $(kubectl \\\nget secret defectdojo \\\n--namespace=defectdojo \\\n--output jsonpath='{.data.DD_ADMIN_PASSWORD}' \\\n| base64 --decode)\"\n</code></pre></li> <li>Go to User section</li> </ul> <ul> <li>Create new user with write permission: DefectDojo set user permission </li> </ul> </li> <li> <p>Get a token of the DefectDojo user:</p> <ul> <li>Login to the DefectDojo UI using the credentials from previous steps.</li> </ul> <ul> <li>Go to the API v2 key (token).</li> </ul> <ul> <li>Copy the API key.</li> </ul> </li> <li> <p>Provision the secret using <code>EDP Portal</code>, <code>Manifest</code> or with the <code>externalSecrets</code> operator:</p> </li> </ol> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; DefectDojo. Update or fill in the URL and Token and click the Save button.</p> <p> DefectDojo update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-defectdojo\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: defectdojo\nstringData:\nurl: https://defectdojo.example.com\ntoken: &lt;token&gt;\n</code></pre> <p>Store defectdojo URL and Token in AWS Parameter Store with following format:</p> <p><pre><code>\"ci-defectdojo\":\n{\n\"url\": \"https://defectdojo.example.com\",\n\"token\": \"XXXXXXXXXXXX\"\n}\n</code></pre> Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; DefectDojo and see the <code>Managed by External Secret</code> message.</p> <p>More details about the External Secrets Operator integration procedure can be found in the External Secrets Operator Integration page.</p> <p>After following the instructions provided, you should be able to integrate your DefectDojo with the EPAM Delivery Platform using one of the few available scenarios.</p>"},{"location":"operator-guide/install-defectdojo/#related-articles","title":"Related Articles","text":"<ul> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Install Harbor</li> </ul>"},{"location":"operator-guide/install-edp/","title":"Install EDP","text":"<p>Inspect the main steps to install EPAM Delivery Platform. Please check the Prerequisites Overview page before starting the installation. There are two recommended ways to deploy EPAM Delivery Platform:</p> <ul> <li>Using Helm (see below);</li> <li>Using Argo CD GitOps approach;</li> <li>Using AWS Marketplace.</li> </ul> <p>Note</p> <p>The installation process below is given for a Kubernetes cluster. The steps that differ for an OpenShift cluster are indicated in the notes.</p> <p>Disclaimer</p> <p>EDP is aligned with industry standards for storing and managing sensitive data, ensuring optimal security. However, the use of custom solutions introduces uncertainties, thus the responsibility for the safety of your data is totally covered by platform administrator.</p> <ol> <li> <p>EDP manages secrets via External Secret Operator to integrate with a multitude of utilities. For insights into the secrets in use and their utilization, refer to the provided External Secrets Operator Integration.</p> </li> <li> <p>Create an edp namespace or a Kiosk space depending on whether Kiosk is used or not.</p> <ul> <li> <p>Without Kiosk, create a namespace:</p> <pre><code>kubectl create namespace edp\n</code></pre> <p>Note</p> <p>For an OpenShift cluster, run the <code>oc</code> command instead of the <code>kubectl</code> one.</p> </li> </ul> <ul> <li> <p>With Kiosk, create a relevant space:</p> <pre><code>apiVersion: tenancy.kiosk.sh/v1alpha1\nkind: Space\nmetadata:\nname: edp\nspec:\naccount: edp-admin\n</code></pre> </li> </ul> <p>Note</p> <p>Kiosk is mandatory for EDP v.2.8.x. It is not implemented for the previous versions, and is optional for EDP since v.2.9.x.</p> </li> <li> <p>(Optional) Deploy and configure Keycloak to enable Single Sign-On approach. To see the details on how to configure Keycloak correctly, please refer to the Install Keycloak page.</p> </li> <li> <p>Add the Helm charts repository:</p> <pre><code>helm repo add epamedp https://epam.github.io/edp-helm-charts/stable\n</code></pre> </li> <li> <p>Choose the required Helm chart version:</p> <pre><code>helm search repo epamedp/edp-install\nNAME                    CHART VERSION   APP VERSION     DESCRIPTION\nepamedp/edp-install     3.5.3           3.5.3           A Helm chart for EDP Install\n</code></pre> <p>Note</p> <p>It is highly recommended to use the latest released version.</p> </li> <li> <p>EDP can be integrated with the following version control systems:</p> <ul> <li>Gerrit</li> <li>GitHub (by default)</li> <li>GitLab</li> </ul> <p>This integration implies in what system the development of the application will be or is already being carried out. The <code>global.gitProvider</code> flag in the edp-install controls this integration:</p> GerritGitHub (by default)GitLab values.yaml<pre><code>...\nglobal:\ngitProvider: gerrit\n...\n</code></pre> values.yaml<pre><code>...\nglobal:\ngitProvider: github\n...\n</code></pre> values.yaml<pre><code>...\nglobal:\ngitProvider: gitlab\n...\n</code></pre> <p>Internal Gerrit server can be deployed as a result of EDP deployment. For more details on how to integrate EDP with GitLab or GitHub instead of Gerrit, please refer to the Integrate GitHub/GitLab in Tekton page.</p> </li> <li> <p>(Optional) Integrate platform with SonarQube:</p> <ul> <li>External SonarQube - any SonarQube that is installed separately from EDP. For example, SonarQube that is installed using edp-cluster-add-ons or another public SonarQube server. For more details on how EDP recommends to configure SonarQube to work with the platform, please refer to the SonarQube Integration page.</li> </ul> <ul> <li>Internal SonarQube - SonarQube that is installed along with EDP.values.yaml<pre><code>...\nsonar-operator:\nenabled: true\n...\n</code></pre> </li> </ul> </li> <li> <p>(Optional) Integrate platform with Nexus:</p> <ul> <li>External Nexus - any Nexus that is installed separately from EDP. For example, Nexus that installed using edp-cluster-add-ons or another public Nexus server. For more details on how EDP recommends to configure Nexus to work with the platform, please refer to the Nexus Sonatype Integration page.</li> </ul> <ul> <li>Internal Nexus - Nexus that is installed along with EDP.values.yaml<pre><code>...\nnexus-operator:\nenabled: true\n...\n</code></pre> </li> </ul> </li> <li> <p>(Optional) Configure Container Registry for image storage.</p> <p>Since EDP v3.4.0, we enabled users to configure Harbor registry instead of AWS ECR and Openshift-registry. We recommend installing Harbor using our edp-cluster-add-ons although you can install it any other way. To integrate EDP with Harbor, see Harbor integration page.</p> <p>To enable Harbor as a registry storage, use the values below: <pre><code>global:\ndockerRegistry:\ntype: \"harbor\"\nurl: \"harbor.example.com\"\n</code></pre></p> </li> <li> <p>Check the parameters in the EDP installation chart. For details, please refer to the values.yaml file.</p> </li> <li> <p>Install EDP in the edp namespace with the Helm tool:</p> <pre><code>helm install edp epamedp/edp-install --wait --timeout=900s \\\n--version &lt;edp_version&gt; \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>See the details on the parameters below:</p> Example values.yaml file<pre><code>global:\n# -- platform type that can be either \"kubernetes\" or \"openshift\"\nplatform: \"kubernetes\"\n# DNS wildcard for routing in the Kubernetes cluster;\ndnsWildCard: \"example.com\"\n# -- Administrators of your tenant\n# -- Can be gerrit, github or gitlab. By default: github\ngitProvider: github\ndockerRegistry:\n# -- Docker Registry endpoint\nurl: \"&lt;AWS_ACCOUNT_ID&gt;.dkr.ecr.&lt;AWS_REGION&gt;.amazonaws.com\"\ntype: \"ecr\"\n\nsso:\nenabled: false\n# Keycloak address with which the platform will be integrated\nkeycloakUrl: \"https://keycloak.example.com\"\nadmins:\n- \"stub_user_one@example.com\"\ndevelopers:\n- \"stub_user_one@example.com\"\n- \"stub_user_two@example.com\"\n\n# AWS Region, e.g. \"eu-central-1\"\nawsRegion:\n\nargocd:\n# -- Enable ArgoCD integration\nenabled: true\n# -- ArgoCD URL in format schema://URI\n# -- By default, https://argocd.{{ .Values.global.dnsWildCard }}\nurl: \"\"\n\nedp-tekton:\n# Tekton Kaniko configuration section\nkaniko:\n# -- AWS IAM role to be used for kaniko pod service account (IRSA). Format: arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/&lt;AWS_IAM_ROLE_NAME&gt;\nroleArn:\n\nedp-headlamp:\nconfig:\noidc:\nenabled: false\n</code></pre> <p>Note</p> <p>Set <code>global.platform=openshift</code> while deploying EDP in OpenShift.</p> <p>Info</p> <p>The full installation with integration between tools will take at least 10 minutes.</p> </li> <li> <p>To check if the installation is successful, run the command below:</p> <p><pre><code>helm status edp -n edp\n</code></pre>   You can also check ingress endpoints to get EDP Portal endpoint to enter EDP Portal UI:   <pre><code>kubectl describe ingress -n edp\n</code></pre></p> </li> <li> <p>Once EDP is successfully installed, you can navigate to our Use Cases to try out EDP functionality.</p> </li> </ol>"},{"location":"operator-guide/install-edp/#related-articles","title":"Related Articles","text":"<ul> <li>Quick Start</li> <li>Install EDP via Helmfile</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> <li>Set Up Kubernetes</li> <li>Set Up OpenShift</li> <li>EDP Installation Prerequisites Overview</li> <li>Headlamp OIDC Integration</li> </ul>"},{"location":"operator-guide/install-external-secrets-operator/","title":"Install External Secrets Operator","text":"<p>Inspect the prerequisites and the main steps to perform for enabling External Secrets Operator in EDP.</p>"},{"location":"operator-guide/install-external-secrets-operator/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.0+ is installed. Please refer to the Helm page on GitHub for details.</li> </ul>"},{"location":"operator-guide/install-external-secrets-operator/#installation","title":"Installation","text":"<p>To install External Secrets Operator with Helm, run the following commands:</p> <pre><code>helm repo add external-secrets https://charts.external-secrets.io\n\nhelm install external-secrets \\\nexternal-secrets/external-secrets \\\n--version 0.8.3 \\\n-n external-secrets \\\n--create-namespace\n</code></pre> <p>Info</p> <p>It is also possible to install External Secrets Operator using the Helmfile or Operator Lifecycle Manager (OLM).</p>"},{"location":"operator-guide/install-external-secrets-operator/#related-articles","title":"Related Articles","text":"<ul> <li>External Secrets Operator Integration</li> <li>Install Harbor</li> </ul>"},{"location":"operator-guide/install-harbor/","title":"Install Harbor","text":"<p>EPAM Delivery Platform uses Harbor as a storage for application images that are created when building applications.</p> <p>Inspect the prerequisites and the main steps to perform for enabling Harbor in EDP.</p>"},{"location":"operator-guide/install-harbor/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/install-harbor/#installation","title":"Installation","text":"<p>To install Harbor with Helm, follow the steps below:</p> <ol> <li> <p>Create a namespace for Harbor:</p> <pre><code>kubectl create namespace harbor\n</code></pre> </li> <li> <p>Create a secret for administrator user and registry:</p> ManuallyExternal Secret Operator <pre><code>kubectl create secret generic harbor \\\n--from-literal=HARBOR_ADMIN_PASSWORD=&lt;secret&gt; \\\n--from-literal=REGISTRY_HTPASSWD=&lt;secret&gt; \\\n--from-literal=REGISTRY_PASSWD=&lt;secret&gt; \\\n--from-literal=secretKey=&lt;secret&gt; \\\n--namespace harbor\n</code></pre> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: ExternalSecret\nmetadata:\nname: harbor\nnamespace: harbor\nspec:\nrefreshInterval: 1h\nsecretStoreRef:\nkind: SecretStore\nname: aws-parameterstore\ndata:\n- secretKey: HARBOR_ADMIN_PASSWORD\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.HARBOR_ADMIN_PASSWORD\n- secretKey: secretKey\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.secretKey\n- secretKey: REGISTRY_HTPASSWD\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.REGISTRY_HTPASSWD\n- secretKey: REGISTRY_PASSWD\nremoteRef:\nconversionStrategy: Default\ndecodingStrategy: None\nkey: /control-plane/deploy-secrets\nproperty: harbor.REGISTRY_PASSWD\n</code></pre> <p>Note</p> <p>The <code>HARBOR_ADMIN_PASSWORD</code> is the initial password of Harbor admin. The <code>secretKey</code> is the secret key that is used for encryption. Must be 16 characters long. The <code>REGISTRY_PASSWD</code> is Harbor registry password. The <code>REGISTRY_HTPASSWD</code> is login and password in htpasswd string format. This value is the string in the password file generated by the <code>htpasswd</code> command where the username is <code>harbor_registry_user</code> and the encryption type is <code>bcrypt</code>. See the example below: <pre><code>htpasswd -bBc passwordfile harbor_registry_user harbor_registry_password\n</code></pre> The username must be <code>harbor_registry_user</code>. The password must be the value from <code>REGISTRY_PASSWD</code>.</p> </li> <li> <p>Add the Helm Harbor Charts for the local client.</p> <pre><code>helm repo add harbor https://helm.goharbor.io\n</code></pre> </li> <li> <p>Check the parameters in the Harbor installation chart. For details, please refer to    the values.yaml file.</p> </li> <li> <p>Install Harbor in the \u2039harbor\u203a namespace with the Helm tool.</p> <pre><code>helm install harbor harbor/harbor\n    --version 1.12.2 \\\n--namespace harbor \\\n--values values.yaml\n</code></pre> <p>See the details on the parameters below:</p> <p>Example values.yaml file</p> <pre><code># we use Harbor secret to consolidate all the Harbor secrets\nexistingSecretAdminPassword: harbor\nexistingSecretAdminPasswordKey: HARBOR_ADMIN_PASSWORD\nexistingSecretSecretKey: harbor\n\ncore:\n# The XSRF key. Will be generated automatically if it isn't specified\nxsrfKey: \"\"\njobservice:\n# Secret is used when job service communicates with other components.\n# If a secret key is not specified, Helm will generate one.\n# Must be a string of 16 chars.\nsecret: \"\"\nregistry:\n# Secret is used to secure the upload state from client\n# and registry storage backend.\n# If a secret key is not specified, Helm will generate one.\n# Must be a string of 16 chars.\nsecret: \"\"\ncredentials:\nusername: harbor_registry_user\nexistingSecret: harbor\nfullnameOverride: harbor\n# If Harbor is deployed behind the proxy, set it as the URL of proxy\nexternalURL: https://core.harbor.domain\nipFamily:\nipv6:\nenabled: false\nexpose:\ntls:\nenabled: false\ningress:\nhosts:\ncore: core.harbor.domain\nnotary: notary.harbor.domain\nupdateStrategy:\ntype: Recreate\npersistence:\npersistentVolumeClaim:\nregistry:\nsize: 30Gi\njobservice:\njobLog:\nsize: 1Gi\ndatabase:\nsize: 2Gi\nredis:\nsize: 1Gi\ntrivy:\nsize: 5Gi\ndatabase:\ninternal:\n# The initial superuser password for internal database\npassword: \"changeit\"\n</code></pre> </li> <li> <p>To check if the installation is successful, run the command below:</p> <p><pre><code>helm status &lt;harbor-release&gt; -n harbor\n</code></pre>   You can also check ingress endpoints to get Harbor endpoint to enter Harbor UI:   <pre><code>kubectl describe ingress &lt;harbor_ingress&gt; -n harbor\n</code></pre></p> </li> </ol>"},{"location":"operator-guide/install-harbor/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Integrate Harbor With EDP Pipelines</li> </ul>"},{"location":"operator-guide/install-ingress-nginx/","title":"Install NGINX Ingress Controller","text":"<p>Inspect the prerequisites and the main steps to perform for installing Install NGINX Ingress Controller on Kubernetes.</p>"},{"location":"operator-guide/install-ingress-nginx/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.2 is installed. Please refer to the Helm page on GitHub for details.</li> </ul>"},{"location":"operator-guide/install-ingress-nginx/#installation","title":"Installation","text":"<p>Info</p> <p>It is also possible to install NGINX Ingress Controller using the Helmfile. For details, please refer to the Install via Helmfile page.</p> <p>To install the ingress-nginx chart, follow the steps below:</p> <ol> <li> <p>Create an ingress-nginx namespace:</p> <pre><code>kubectl create namespace ingress-nginx\n</code></pre> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx\nhelm repo update\n</code></pre> </li> <li> <p>Install the ingress-nginx chart:</p> <pre><code>helm install ingress ingress-nginx/ingress-nginx \\\n--version 4.7.0 \\\n--values values.yaml \\\n--namespace ingress-nginx\n</code></pre> <p>Check out the values.yaml file sample of the ingress-nginx chart customization:</p> </li> </ol> View: values.yaml <pre><code>controller:\naddHeaders:\nX-Content-Type-Options: nosniff\nX-Frame-Options: SAMEORIGIN\nresources:\nlimits:\nmemory: \"256Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"128M\"\nconfig:\nssl-redirect: 'true'\nclient-header-buffer-size: '64k'\nhttp2-max-field-size: '64k'\nhttp2-max-header-size: '64k'\nlarge-client-header-buffers: '4 64k'\nupstream-keepalive-timeout: '120'\nkeep-alive: '10'\nuse-forwarded-headers: 'true'\nproxy-real-ip-cidr: '172.32.0.0/16'\nproxy-buffer-size: '8k'\n\n# To watch Ingress objects without the ingressClassName field set parameter value to true.\n# https://kubernetes.github.io/ingress-nginx/#i-have-only-one-ingress-controller-in-my-cluster-what-should-i-do\nwatchIngressWithoutClass: true\n\nservice:\ntype: NodePort\nnodePorts:\nhttp: 32080\nhttps: 32443\nupdateStrategy:\nrollingUpdate:\nmaxUnavailable: 1\ntype: RollingUpdate\nmetrics:\nenabled: true\ndefaultBackend:\nenabled: true\nserviceAccount:\ncreate: true\nname: nginx-ingress-service-account\n</code></pre> <p>Warning</p> <p>Align value controller.config.proxy-real-ip-cidr with AWS VPC CIDR.</p>"},{"location":"operator-guide/install-keycloak/","title":"Install Keycloak","text":"<p>Inspect the prerequisites and the main steps to perform for installing Keycloak.</p> <p>Info</p> <p>The installation process below is given for a Kubernetes cluster. The steps that differ for an OpenShift cluster are indicated in the warnings blocks.</p>"},{"location":"operator-guide/install-keycloak/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.0+ is installed. Please refer to the Helm page on GitHub for details.</li> </ul> <p>Info</p> <p>EDP team is using a Keycloakx helm chart from the codecentric repository, but other repositories can be used as well (e.g. Bitnami). Before installing Keycloak, it is necessary to install a PostgreSQL database.</p> <p>Info</p> <p>It is also possible to install Keycloak using the Helmfile. For details, please refer to the Install via Helmfile page.</p>"},{"location":"operator-guide/install-keycloak/#postgresql-installation","title":"PostgreSQL Installation","text":"<p>To install PostgreSQL, follow the steps below:</p> <ol> <li> <p>Check that a security namespace is created. If not, run the following command to create it:</p> <pre><code>kubectl create namespace security\n</code></pre> <p>Warning</p> <p>On the OpenShift platform, apply the <code>SecurityContextConstraints</code> resource. Change the namespace in the <code>users</code> section if required.</p> View: keycloak-scc.yaml <pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: keycloak\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:security:keycloakx\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> View: postgresql-keycloak-scc.yaml <pre><code>allowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\napiVersion: security.openshift.io/v1\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: postgresql-keycloak\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:security:default\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-postgresql \\\n--from-literal=password=&lt;postgresql_password&gt; \\\n--from-literal=postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> </li> <li> <p>Add a helm chart repository:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Install PostgreSQL v15.2.0 using bitnami/postgresql Helm chart v12.1.15:</p> <p>Info</p> <p>The PostgreSQL can be deployed in production ready mode. For example, it may include multiple replicas, persistent storage, autoscaling, and monitoring. For details, please refer to the official Chart documentation.</p> <pre><code>helm install postgresql bitnami/postgresql \\\n--version 12.1.15 \\\n--values values.yaml \\\n--namespace security\n</code></pre> <p>Check out the values.yaml file sample of the PostgreSQL customization:</p> View: values.yaml <pre><code># PostgreSQL read only replica parameters\nreadReplicas:\n# Number of PostgreSQL read only replicas\nreplicaCount: 1\n\nimage:\ntag: 15.2.0-debian-11-r0\n\nglobal:\npostgresql:\nauth:\nusername: admin\nexistingSecret: keycloak-postgresql\ndatabase: keycloak\n\nprimary:\npersistence:\nenabled: true\nsize: 3Gi\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-keycloak/#keycloak-installation","title":"Keycloak Installation","text":"<p>To install Keycloak, follow the steps below:</p> <ol> <li> <p>Use <code>security</code> namespace from the PostgreSQL installation.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add codecentric https://codecentric.github.io/helm-charts\nhelm repo update\n</code></pre> </li> <li> <p>Create Keycloak admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-admin-creds \\\n--from-literal=username=&lt;keycloak_admin_username&gt; \\\n--from-literal=password=&lt;keycloak_admin_password&gt;\n</code></pre> </li> <li> <p>Install Keycloak 20.0.3 using codecentric/keycloakx Helm chart:</p> <p>Info</p> <p>Keycloak can be deployed in production ready mode. For example, it may include multiple replicas, persistent storage, autoscaling, and monitoring. For details, please refer to the official Chart documentation.</p> <pre><code>helm install keycloakx codecentric/keycloakx \\\n--version 2.2.1 \\\n--values values.yaml \\\n--namespace security\n</code></pre> <p>Check out the values.yaml file sample of the Keycloak customization:</p> View: values.yaml <pre><code>replicas: 1\n\n# Deploy the latest version\nimage:\ntag: \"20.0.3\"\n\n# start: create OpenShift realm which is required by EDP\nextraInitContainers: |\n- name: realm-provider\nimage: busybox\nimagePullPolicy: IfNotPresent\ncommand:\n- sh\nargs:\n- -c\n- |\necho '{\"realm\": \"openshift\",\"enabled\": true}' &gt; /opt/keycloak/data/import/openshift.json\nvolumeMounts:\n- name: realm\nmountPath: /opt/keycloak/data/import\n\n# The following parameter is unrecommended to expose. Exposed health checks lead to an unnecessary attack vector.\nhealth:\nenabled: false\n# The following parameter is unrecommended to expose. Exposed metrics lead to an unnecessary attack vector.\nmetrics:\nenabled: false\n\nextraVolumeMounts: |\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumes: |\n- name: realm\nemptyDir: {}\n\ncommand:\n- \"/opt/keycloak/bin/kc.sh\"\n- \"--verbose\"\n- \"start\"\n- \"--auto-build\"\n- \"--http-enabled=true\"\n- \"--http-port=8080\"\n- \"--hostname-strict=false\"\n- \"--hostname-strict-https=false\"\n- \"--spi-events-listener-jboss-logging-success-level=info\"\n- \"--spi-events-listener-jboss-logging-error-level=warn\"\n- \"--import-realm\"\n\nextraEnv: |\n- name: KC_PROXY\nvalue: \"passthrough\"\n- name: KEYCLOAK_ADMIN\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: username\n- name: KEYCLOAK_ADMIN_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: password\n- name: JAVA_OPTS_APPEND\nvalue: &gt;-\n-XX:+UseContainerSupport\n-XX:MaxRAMPercentage=50.0\n-Djava.awt.headless=true\n-Djgroups.dns.query={{ include \"keycloak.fullname\" . }}-headless\n\n# This block should be uncommented if you install Keycloak on Kubernetes\ningress:\nenabled: true\nannotations:\nkubernetes.io/ingress.class: nginx\ningress.kubernetes.io/affinity: cookie\n# The following parameter is unrecommended to expose. Admin paths lead to an unnecessary attack vector.\nconsole:\nenabled: false\nrules:\n- host: keycloak.&lt;ROOT_DOMAIN&gt;\npaths:\n- path: '{{ tpl .Values.http.relativePath $ | trimSuffix \"/\" }}/'\npathType: Prefix\n\n# This block should be uncommented if you set Keycloak to OpenShift and change the host field\n# route:\n#   enabled: false\n#   # Path for the Route\n#   path: '/'\n#   # Host name for the Route\n#   host: \"keycloak.&lt;ROOT_DOMAIN&gt;\"\n#   # TLS configuration\n#   tls:\n#     enabled: true\n\nresources:\nlimits:\nmemory: \"2048Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"512Mi\"\n\n# Check database readiness at startup\ndbchecker:\nenabled: true\n\ndatabase:\nvendor: postgres\nexistingSecret: keycloak-postgresql\nhostname: postgresql\nport: 5432\nusername: admin\ndatabase: keycloak\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-keycloak/#configuration","title":"Configuration","text":"<p>To prepare Keycloak for integration with EDP, follow the steps below:</p> <ol> <li> <p>Ensure that the <code>openshift</code> realm is created.</p> </li> <li> <p>Create the <code>edp_&lt;EDP_PROJECT&gt;</code> user and set the password in the <code>Master</code> realm.</p> <p>Note</p> <p>This user should be used by EDP to access Keycloak. Please refer to the Install EDP and Install EDP via Helmfile sections for details.</p> </li> <li> <p>In the <code>Role Mapping</code> tab, assign the proper roles to the user:</p> <ul> <li> <p>Realm Roles:</p> <ul> <li>create-realm,</li> </ul> <ul> <li>offline_access,</li> </ul> <ul> <li>uma_authorization</li> </ul> </li> </ul> <ul> <li> <p>Client Roles <code>openshift-realm</code>:</p> <ul> <li>impersonation,</li> </ul> <ul> <li>manage-authorization,</li> </ul> <ul> <li>manage-clients,</li> </ul> <ul> <li>manage-users</li> </ul> </li> </ul> <p> Role mappings </p> </li> </ol>"},{"location":"operator-guide/install-keycloak/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install via Helmfile</li> <li>Install Harbor</li> </ul>"},{"location":"operator-guide/install-kiosk/","title":"Set Up Kiosk","text":"<p>Kiosk is a multi-tenancy extension for managing tenants and namespaces in a shared Kubernetes cluster. Within EDP, Kiosk is used to separate resources and enables the following options (see more details):</p> <ul> <li>Access to the EDP tenants in a Kubernetes cluster;</li> </ul> <ul> <li>Multi-tenancy access at the service account level for application deploy.</li> </ul> <p>Inspect the main steps to set up Kiosk for the proceeding EDP installation.</p> <p>Note</p> <p>Kiosk deploy is mandatory for EDP v.2.8.. In earlier versions, Kiosk is not implemented. Since EDP v.2.9.0, integration with Kiosk is an optional feature. You may not want to use it, so just skip those steps and disable in Helm parameters during EDP deploy.</p> <pre><code># global.kioskEnabled: &lt;true/false&gt;\n</code></pre>"},{"location":"operator-guide/install-kiosk/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.18.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.6.0 is installed. Please refer to the Helm page on GitHub for details.</li> </ul>"},{"location":"operator-guide/install-kiosk/#installation","title":"Installation","text":"<ul> <li>Deploy Kiosk version 0.2.11 in the cluster. To install it, run the following command:<pre><code>  # Install kiosk with helm v3\n\n  helm repo add kiosk https://charts.devspace.sh/\n  kubectl create namespace kiosk\n  helm install kiosk --version 0.2.11 kiosk/kiosk -n kiosk --atomic\n</code></pre> </li> </ul> <p>For more details, please refer to the Kiosk page on the GitHub.</p>"},{"location":"operator-guide/install-kiosk/#configuration","title":"Configuration","text":"<p>To provide access to the EDP tenant, follow the steps below.</p> <ul> <li>Check that a security namespace is created. If not, run the following command to create it:<pre><code>  kubectl create namespace security\n</code></pre> </li> </ul> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> <ul> <li>Add a service account to the security namespace.<pre><code>  kubectl -n security create sa edp\n</code></pre> </li> </ul> <p>Info</p> <p>Please note that <code>edp</code> is the name of the EDP tenant here and in all the following steps.</p> <ul> <li>Apply the Account template to the cluster. Please check the sample below: <pre><code>apiVersion: tenancy.kiosk.sh/v1alpha1\nkind: Account\nmetadata:\nname: edp-admin\nspec:\nspace:\nclusterRole: kiosk-space-admin\nsubjects:\n- kind: ServiceAccount\nname: edp\nnamespace: security\n</code></pre></li> </ul> <ul> <li>Apply the ClusterRoleBinding to the 'kiosk-edit' cluster role (current role is added during installation of Kiosk). Please check the sample below: <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: ClusterRoleBinding\nmetadata:\nname: edp-kiosk-edit\nsubjects:\n- kind: ServiceAccount\nname: edp\nnamespace: security\nroleRef:\nkind: ClusterRole\nname: kiosk-edit\napiGroup: rbac.authorization.k8s.io\n</code></pre></li> <li>To provide access to the EDP tenant, generate kubeconfig with Service Account edp permission. The edp account created earlier is located in the security namespace.</li> </ul>"},{"location":"operator-guide/install-loki/","title":"Install Grafana Loki","text":"<p>EDP configures the logging with the help of Grafana Loki aggregation system.</p>"},{"location":"operator-guide/install-loki/#installation","title":"Installation","text":"<p>To install Loki, follow the steps below:</p> <ol> <li> <p>Create logging namespace:</p> <pre><code>  kubectl create namespace logging\n</code></pre> <p>Note</p> <p>On the OpenShift cluster, run the <code>oc</code> command instead of the <code>kubectl</code> command.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>  helm repo add grafana https://grafana.github.io/helm-charts\n  helm repo update\n</code></pre> <p>Note</p> <p>It is possible to use Amazon Simple Storage Service Amazon S3 as an object storage for Loki. To configure access, please refer to the IRSA for Loki documentation.</p> </li> <li> <p>Install Loki v.2.6.0:</p> <pre><code>  helm install loki grafana/loki \\\n  --version 2.6.0 \\\n  --values values.yaml \\\n  --namespace logging\n</code></pre> <p>Check out the values.yaml file sample of the Loki customization:</p> View: values.yaml <pre><code>image:\nrepository: grafana/loki\ntag: 2.3.0\nconfig:\nauth_enabled: false\nschema_config:\nconfigs:\n- from: 2021-06-01\nstore: boltdb-shipper\nobject_store: s3\nschema: v11\nindex:\nprefix: loki_index_\nperiod: 24h\nstorage_config:\naws:\ns3: s3://&lt;AWS_REGION&gt;/loki-&lt;CLUSTER_NAME&gt;\nboltdb_shipper:\nactive_index_directory: /data/loki/index\ncache_location: /data/loki/boltdb-cache\nshared_store: s3\nchunk_store_config:\nmax_look_back_period: 24h\nresources:\nlimits:\nmemory: \"128Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"128Mi\"\nserviceAccount:\ncreate: true\nname: edp-loki\nannotations:\neks.amazonaws.com/role-arn: \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\npersistence:\nenabled: false\n</code></pre> <p>Note</p> <p>In case of using cluster scheduling and amazon-eks-pod-identity-webhook, it is necessary to restart the Loki pod after the cluster is up and running. Please refer to the Schedule Pods Restart documentation.</p> </li> <li> <p>Configure custom bucket policy to delete the old data.</p> </li> </ol>"},{"location":"operator-guide/install-reportportal/","title":"Install ReportPortal","text":"<p>Inspect the prerequisites and the main steps to perform for installing ReportPortal.</p> <p>Info</p> <p>It is also possible to install ReportPortal using the Helmfile. For details, please refer to the Install via Helmfile page.</p>"},{"location":"operator-guide/install-reportportal/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.23.0 is installed. Please refer to the Kubernetes official website for details.</li> <li>Helm version 3.10.2 is installed. Please refer to the Helm page on GitHub for details.</li> </ul> <p>Info</p> <p>Please refer to the ReportPortal Helm Chart section for details.</p>"},{"location":"operator-guide/install-reportportal/#minio-installation","title":"MinIO Installation","text":"<p>To install MinIO, follow the steps below:</p> <ol> <li> <p>Check that <code>edp</code> namespace is created. If not, run the following command to create it:</p> <pre><code>kubectl create namespace edp\n</code></pre> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, install the <code>SecurityContextConstraints</code> resources. In case of using a custom namespace for the <code>reportportal</code>, change the namespace in the <code>users</code> section.</p> View: report-portal-third-party-resources-scc.yaml <pre><code>apiVersion: security.openshift.io/v1\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: report-portal-minio-rabbitmq-postgresql\nallowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegeEscalation: true\nallowPrivilegedContainer: false\nallowedCapabilities: null\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- min: 999\nmax: 65543\ngroups: []\npriority: 1\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities:\n- KILL\n- MKNOD\n- SETUID\n- SETGID\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMin: 1\nuidRangeMax: 65543\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:report-portal:minio\n- system:serviceaccount:report-portal:rabbitmq\n- system:serviceaccount:report-portal:postgresql\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> View: report-portal-elasticsearch-scc.yaml <pre><code>apiVersion: security.openshift.io/v1\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: report-portal-elasticsearch\nallowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegedContainer: true\nallowedCapabilities: []\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- max: 1000\nmin: 1000\ngroups: []\npriority: 0\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities: []\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMax: 1000\nuidRangeMin: 0\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:report-portal:elasticsearch-master\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create MinIO admin secret:</p> <pre><code>kubectl -n edp create secret generic reportportal-minio-creds \\\n--from-literal=root-password=&lt;root_password&gt; \\\n--from-literal=root-user=&lt;root_user&gt;\n</code></pre> </li> <li> <p>Install MinIO v.11.10.3 using bitnami/minio Helm chart v.11.10.3:</p> <pre><code>helm install minio bitnami/minio \\\n--version 11.10.3 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the MinIO customization:</p> View: values.yaml <pre><code>auth:\nexistingSecret: reportportal-minio-creds\npersistence:\nsize: 1Gi\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#rabbitmq-installation","title":"RabbitMQ Installation","text":"<p>To install RabbitMQ, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> </li> <li> <p>Use <code>bitnami</code> chart repository from the MinIO installation.</p> </li> <li> <p>Create RabbitMQ admin secret:</p> <pre><code>kubectl -n edp create secret generic reportportal-rabbitmq-creds \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Warning</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long. The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Install RabbitMQ v.10.3.8 using bitnami/rabbitmq Helm chart v.10.3.8:</p> <pre><code>helm install rabbitmq bitnami/rabbitmq \\\n--version 10.3.8 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the RabbitMQ customization:</p> View: values.yaml <pre><code>auth:\nexistingPasswordSecret: reportportal-rabbitmq-creds\nexistingErlangSecret: reportportal-rabbitmq-creds\npersistence:\nsize: 1Gi\n</code></pre> </li> <li> <p>After the rabbitmq pod gets the status Running, you need to configure the RabbitMQ memory threshold</p> <pre><code>kubectl -n edp exec -it rabbitmq-0 -- rabbitmqctl set_vm_memory_high_watermark 0.8\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#elasticsearch-installation","title":"Elasticsearch Installation","text":"<p>To install Elasticsearch, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add elastic https://helm.elastic.co\nhelm repo update\n</code></pre> </li> <li> <p>Install Elasticsearch v.7.17.3 using elastic/elasticsearch Helm chart v.7.17.3:</p> <pre><code>helm install elasticsearch elastic/elasticsearch \\\n--version 7.17.3 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the Elasticsearch customization:</p> View: values.yaml <pre><code>replicas: 1\n\nextraEnvs:\n- name: discovery.type\nvalue: single-node\n- name: cluster.initial_master_nodes\nvalue: \"\"\n\nrbac:\ncreate: true\n\nresources:\nrequests:\ncpu: \"100m\"\nmemory: \"2Gi\"\n\nvolumeClaimTemplate:\nresources:\nrequests:\nstorage: 3Gi\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#postgresql-installation","title":"PostgreSQL Installation","text":"<p>To install PostgreSQL, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add bitnami-archive https://raw.githubusercontent.com/bitnami/charts/archive-full-index/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n edp create secret generic reportportal-postgresql-creds \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Warning</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Install PostgreSQL v.10.9.4 using Helm chart v.10.9.4:</p> <pre><code>helm install postgresql bitnami-archive/postgresql \\\n--version 10.9.4 \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the PostgreSQL customization:</p> View: values.yaml <pre><code>persistence:\nsize: 1Gi\nresources:\nrequests:\ncpu: \"100m\"\nserviceAccount:\nenabled: true\npostgresqlUsername: \"rpuser\"\npostgresqlDatabase: \"reportportal\"\nexistingSecret: \"reportportal-postgresql-creds\"\ninitdbScripts:\ninit_postgres.sh: |\n#!/bin/sh\n/opt/bitnami/postgresql/bin/psql -U postgres -d ${POSTGRES_DB} -c 'CREATE EXTENSION IF NOT EXISTS ltree; CREATE EXTENSION IF NOT EXISTS pgcrypto; CREATE EXTENSION IF NOT EXISTS pg_trgm;'\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-reportportal/#reportportal-installation","title":"ReportPortal Installation","text":"<p>To install ReportPortal, follow the steps below:</p> <ol> <li> <p>Use <code>edp</code> namespace from the MinIO installation.</p> <p>For the OpenShift users:</p> <p>When using the OpenShift platform, install the <code>SecurityContextConstraints</code> resource. In case of using a custom namespace for the <code>reportportal</code>, change the namespace in the <code>users</code> section.</p> View: report-portal-reportportal-scc.yaml <pre><code>apiVersion: security.openshift.io/v1\nkind: SecurityContextConstraints\nmetadata:\nannotations:\n\"helm.sh/hook\": \"pre-install\"\nname: report-portal\nallowHostDirVolumePlugin: false\nallowHostIPC: false\nallowHostNetwork: false\nallowHostPID: false\nallowHostPorts: false\nallowPrivilegedContainer: true\nallowedCapabilities: []\nallowedFlexVolumes: []\ndefaultAddCapabilities: []\nfsGroup:\ntype: MustRunAs\nranges:\n- max: 1000\nmin: 1000\ngroups: []\npriority: 0\nreadOnlyRootFilesystem: false\nrequiredDropCapabilities: []\nrunAsUser:\ntype: MustRunAsRange\nuidRangeMax: 1000\nuidRangeMin: 0\nseLinuxContext:\ntype: MustRunAs\nsupplementalGroups:\ntype: RunAsAny\nusers:\n- system:serviceaccount:report-portal:reportportal\nvolumes:\n- configMap\n- downwardAPI\n- emptyDir\n- persistentVolumeClaim\n- projected\n- secret\n</code></pre> </li> <li> <p>Add a chart repository:</p> <pre><code>helm repo add report-portal \"https://reportportal.github.io/kubernetes\"\nhelm repo update\n</code></pre> </li> <li> <p>Install ReportPortal v.5.8.0 using Helm chart v.5.8.0:</p> <pre><code>helm install report-portal report-portal/reportportal \\\n--values values.yaml \\\n--namespace edp\n</code></pre> <p>Check out the values.yaml file sample of the ReportPortal customization:</p> View: values.yaml <pre><code>serviceindex:\nresources:\nrequests:\ncpu: 50m\nuat:\nresources:\nrequests:\ncpu: 50m\nserviceui:\nresources:\nrequests:\ncpu: 50m\nserviceAccountName: \"reportportal\"\nsecurityContext:\nrunAsUser: 0\nserviceapi:\nresources:\nrequests:\ncpu: 50m\nserviceanalyzer:\nresources:\nrequests:\ncpu: 50m\nserviceanalyzertrain:\nresources:\nrequests:\ncpu: 50m\n\nrabbitmq:\nSecretName: \"reportportal-rabbitmq-creds\"\nendpoint:\naddress: rabbitmq.&lt;EDP_PROJECT&gt;.svc.cluster.local\nuser: user\napiuser: user\n\npostgresql:\nSecretName: \"reportportal-postgresql-creds\"\nendpoint:\naddress: postgresql.&lt;EDP_PROJECT&gt;.svc.cluster.local\n\nelasticsearch:\nendpoint: http://elasticsearch-master.&lt;EDP_PROJECT&gt;.svc.cluster.local:9200\n\nminio:\nsecretName: \"reportportal-minio-creds\"\nendpoint: http://minio.&lt;EDP_PROJECT&gt;.svc.cluster.local:9000\nendpointshort: minio.&lt;EDP_PROJECT&gt;.svc.cluster.local:9000\naccesskeyName: \"root-user\"\nsecretkeyName: \"root-password\"\n\ningress:\n# IF YOU HAVE SOME DOMAIN NAME SET INGRESS.USEDOMAINNAME to true\nusedomainname: true\nhosts:\n- report-portal-&lt;EDP_PROJECT&gt;.&lt;ROOT_DOMAIN&gt;\n</code></pre> </li> <li> <p>For the OpenShift platform, install a Gateway with Route:</p> View: gateway-config-cm.yaml <pre><code>kind: ConfigMap\nmetadata:\nname: gateway-config\nnamespace: report-portal\napiVersion: v1\ndata:\ntraefik-dynamic-config.yml: |\nhttp:\nmiddlewares:\nstrip-ui:\nstripPrefix:\nprefixes:\n- \"/ui\"\nforceSlash: false\nstrip-api:\nstripPrefix:\nprefixes:\n- \"/api\"\nforceSlash: false\nstrip-uat:\nstripPrefix:\nprefixes:\n- \"/uat\"\nforceSlash: false\n\nrouters:\nindex-router:\nrule: \"Path(`/`)\"\nservice: \"index\"\nui-router:\nrule: \"PathPrefix(`/ui`)\"\nmiddlewares:\n- strip-ui\nservice: \"ui\"\nuat-router:\nrule: \"PathPrefix(`/uat`)\"\nmiddlewares:\n- strip-uat\nservice: \"uat\"\napi-router:\nrule: \"PathPrefix(`/api`)\"\nmiddlewares:\n- strip-api\nservice: \"api\"\n\nservices:\nuat:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-uat:9999/\"\n\nindex:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-index:8080/\"\n\napi:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-api:8585/\"\n\nui:\nloadBalancer:\nservers:\n- url: \"http://report-portal-reportportal-ui:8080/\"\ntraefik.yml: |\nentryPoints:\nhttp:\naddress: \":8081\"\nmetrics:\naddress: \":8082\"\n\nmetrics:\nprometheus:\nentryPoint: metrics\naddEntryPointsLabels: true\naddServicesLabels: true\nbuckets:\n- 0.1\n- 0.3\n- 1.2\n- 5.0\n\nproviders:\nfile:\nfilename: /etc/traefik/traefik-dynamic-config.yml\n</code></pre> View: gateway-deployment.yaml <pre><code>apiVersion: apps/v1\nkind: Deployment\nmetadata:\nlabels:\napp: reportportal\nname: gateway\nnamespace: report-portal\nspec:\nreplicas: 1\nselector:\nmatchLabels:\ncomponent: gateway\ntemplate:\nmetadata:\nlabels:\ncomponent: gateway\nspec:\ncontainers:\n- image: quay.io/waynesun09/traefik:2.3.6\nname: traefik\nports:\n- containerPort: 8080\nprotocol: TCP\nresources: {}\nvolumeMounts:\n- mountPath: /etc/traefik/\nname: config\nreadOnly: true\nvolumes:\n- name: config\nconfigMap:\ndefaultMode: 420\nname: gateway-config\n</code></pre> View: gateway-route.yaml <pre><code>kind: Route\napiVersion: route.openshift.io/v1\nmetadata:\nlabels:\napp: reportportal\nname: reportportal\nnamespace: report-portal\nspec:\nhost: report-portal.&lt;CLUSTER_DOMAIN&gt;\nport:\ntargetPort: http\ntls:\ninsecureEdgeTerminationPolicy: Redirect\ntermination: edge\nto:\nkind: Service\nname: gateway\nweight: 100\nwildcardPolicy: None\n</code></pre> View: gateway-service.yaml <pre><code>apiVersion: v1\nkind: Service\nmetadata:\nlabels:\napp: reportportal\ncomponent: gateway\nname: gateway\nnamespace: report-portal\nspec:\nports:\n# use 8081 to allow for usage of the dashboard which is on port 8080\n- name: http\nport: 8081\nprotocol: TCP\ntargetPort: 8081\nselector:\ncomponent:  gateway\nsessionAffinity: None\ntype: ClusterIP\n</code></pre> </li> </ol> <p>Note</p> <p>For user access: default/1q2w3e For admin access: superadmin/erebus Please refer to the ReportPortal.io page for details.</p>"},{"location":"operator-guide/install-reportportal/#related-articles","title":"Related Articles","text":"<ul> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/install-tekton/","title":"Install Tekton","text":"<p>EPAM Delivery Platform uses Tekton resources, such as Tasks, Pipelines, Triggers, and Interceptors, for running the CI/CD pipelines.</p> <p>Inspect the main steps to perform for installing the Tekton resources via the Tekton release files.</p>"},{"location":"operator-guide/install-tekton/#prerequisites","title":"Prerequisites","text":"<ul> <li>Kubectl version 1.24.0 or higher is installed. Please refer to the Kubernetes official website for details.</li> <li>For Openshift/OKD, the latest version of the <code>oc</code> utility is required. Please refer to the OKD page on GitHub for details.</li> <li>Created AWS ECR repository for Kaniko cache. By default, the Kaniko cache repository name is <code>kaniko-cache</code> and this parameter is located in our Tekton <code>common-library</code>.</li> </ul>"},{"location":"operator-guide/install-tekton/#installation-on-kubernetes-cluster","title":"Installation on Kubernetes Cluster","text":"<p>To install Tekton resources, follow the steps below:</p> <p>Info</p> <p>Please refer to the Install Tekton Pipelines and Install and set up Tekton Triggers sections for details.</p> <ol> <li> <p>Install Tekton pipelines v0.51.0 using the release file:</p> <p>Note</p> <p>Tekton Pipeline resources are used for managing and running EDP Tekton Pipelines and Tasks. Please refer to the EDP Tekton Pipelines and EDP Tekton Tasks pages for details.</p> <pre><code>kubectl apply -f https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.51.0/release.yaml\n</code></pre> </li> <li> <p>Install Tekton Triggers v0.25.0 using the release file:</p> <p>Note</p> <p>Tekton Trigger resources are used for managing and running EDP Tekton EventListeners, Triggers, TriggerBindings and TriggerTemplates. Please refer to the EDP Tekton Triggers page for details.</p> <pre><code>kubectl apply -f https://storage.googleapis.com/tekton-releases/triggers/previous/v0.25.0/release.yaml\n</code></pre> </li> <li> <p>Install Tekton Interceptors v0.25.0 using the release file:</p> <p>Note</p> <p>EPAM Delivery Platform uses GitLab and GitHub ClusterInterceptors for managing requests from webhooks.</p> <pre><code>kubectl apply -f https://storage.googleapis.com/tekton-releases/triggers/previous/v0.25.0/interceptors.yaml\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-tekton/#installation-on-okd-cluster","title":"Installation on OKD cluster","text":"<p>To install Tekton resources, follow the steps below:</p> <p>Info</p> <p>Please refer to the Install Tekton Operator documentation for details.</p> <p>Note</p> <p>Tekton Operator also deploys Pipelines as Code CI that requires OpenShift v4.11 (based on Kubernetes v1.24) or higher. This feature is optional and its deployments can be scaled to zero replicas.</p> <p>Install Tekton Operator v0.67.0 using the release file:</p> <pre><code>kubectl apply -f https://github.com/tektoncd/operator/releases/download/v0.67.0/openshift-release.yaml\n</code></pre> <p>After the installation, the Tekton Operator will install the following components: Pipeline, Trigger, and Addons.</p> <p>Note</p> <p>If there is the following error in the <code>openshift-operators</code> namespace for <code>openshift-pipelines-operator</code> and <code>tekton-operator-webhook</code> deployments:</p> <pre><code>Error: container has runAsNonRoot and image will run as root\n</code></pre> <p>Patch the deployments with the following commands:</p> <pre><code>kubectl -n openshift-operators patch deployment openshift-pipelines-operator -p '{\"spec\": {\"template\": {\"spec\": {\"securityContext\": {\"runAsUser\": 1000}}}}}'\nkubectl -n openshift-operators patch deployment tekton-operator-webhook -p '{\"spec\": {\"template\": {\"spec\": {\"securityContext\": {\"runAsUser\": 1000}}}}}'\n</code></pre> <p>Grant access for Tekton Service Accounts in the <code>openshift-pipelines</code> namespace to the Privileged SCC:</p> <pre><code>oc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-operators-proxy-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-pipelines-controller\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-pipelines-resolvers\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-pipelines-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-triggers-controller\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-triggers-core-interceptors\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:tekton-triggers-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:pipelines-as-code-controller\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:pipelines-as-code-watcher\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:pipelines-as-code-webhook\noc adm policy add-scc-to-user privileged system:serviceaccount:openshift-pipelines:default\n</code></pre>"},{"location":"operator-guide/install-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/install-velero/","title":"Install Velero","text":"<p>Velero is an open source tool to safely back up, recover, and migrate Kubernetes clusters and persistent volumes. It works both on premises and in a public cloud. Velero consists of a server process running as a deployment in your Kubernetes cluster and a command-line interface (CLI) with which DevOps teams and platform operators configure scheduled backups, trigger ad-hoc backups, perform restores, and more.</p>"},{"location":"operator-guide/install-velero/#installation","title":"Installation","text":"<p>To install Velero, follow the steps below:</p> <ol> <li> <p>Create velero namespace:</p> <pre><code>  kubectl create namespace velero\n</code></pre> <p>Note</p> <p>On an OpenShift cluster, run the <code>oc</code> command instead of <code>kubectl</code> one.</p> </li> <li> <p>Add a chart repository:</p> <pre><code>  helm repo add vmware-tanzu https://vmware-tanzu.github.io/helm-charts\n  helm repo update\n</code></pre> <p>Note</p> <p>Velero AWS Plugin requires access to AWS resources.  To configure access, please refer to the IRSA for Velero documentation.</p> </li> <li> <p>Install Velero v.2.14.13:</p> <pre><code>  helm install velero vmware-tanzu/velero \\\n  --version 2.14.13 \\\n  --values values.yaml \\\n  --namespace velero\n</code></pre> <p>Check out the values.yaml file sample of the Velero customization:</p> View: values.yaml <pre><code>image:\nrepository: velero/velero\ntag: v1.5.3\nsecurityContext:\nfsGroup: 65534\nrestic:\nsecurityContext:\nfsGroup: 65534\nserviceAccount:\nserver:\ncreate: true\nname: edp-velero\nannotations:\neks.amazonaws.com/role-arn: \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\"\ncredentials:\nuseSecret: false\nconfiguration:\nprovider: aws\nbackupStorageLocation:\nname: default\nbucket: velero-&lt;CLUSTER_NAME&gt;\nconfig:\nregion: eu-central-1\nvolumeSnapshotLocation:\nname: default\nconfig:\nregion: &lt;AWS_REGION&gt;\ninitContainers:\n- name: velero-plugin-for-aws\nimage: velero/velero-plugin-for-aws:v1.1.0\nvolumeMounts:\n- mountPath: /target\nname: plugins\n</code></pre> <p>Note</p> <p>In case of using cluster scheduling and amazon-eks-pod-identity-webhook, it is necessary to restart the Velero pod after the cluster is up and running. Please refer to the Schedule Pods Restart documentation.</p> </li> <li> <p>Install the client side (velero cli) according to the official documentation.</p> </li> </ol>"},{"location":"operator-guide/install-velero/#configuration","title":"Configuration","text":"<ol> <li> <p>Create backup for all components in the namespace:</p> <pre><code>  velero backup create &lt;BACKUP_NAME&gt; --include-namespaces &lt;NAMESPACE&gt;\n</code></pre> </li> <li> <p>Create a daily backup of the namespace:</p> <pre><code>  velero schedule create &lt;BACKUP_NAME&gt;  --schedule \"0 10 * * MON-FRI\" --include-namespaces &lt;NAMESPACE&gt; --ttl 120h0m0s\n</code></pre> </li> <li> <p>To restore from backup, use the following command:</p> <pre><code>  velero restore create &lt;RESTORE_NAME&gt; --from-backup &lt;BACKUP_NAME&gt;\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/","title":"Install via Helmfile","text":"<p>This article provides the instruction on how to deploy EDP and components in Kubernetes using Helmfile that is intended for deploying Helm charts. Helmfile templates are available in GitHub repository.</p> <p>Important</p> <p>The Helmfile installation method for EPAM Delivery Platform (EDP) is currently not actively maintained. We strongly recommend exploring alternative installation options for the most up-to-date and well-supported deployment experience. You may consider using the Add-Ons approach or opting for installation via the AWS Marketplace to ensure a reliable and secure deployment of EDP.</p>"},{"location":"operator-guide/install-via-helmfile/#prerequisites","title":"Prerequisites","text":"<p>The following tools and plugins must be installed:</p> <ul> <li>Kubectl version 1.23.0;</li> <li>Helm version 3.10.0+;</li> <li>Helmfile version 0.144.0;</li> <li>Helm diff plugin version 3.6.0.</li> </ul>"},{"location":"operator-guide/install-via-helmfile/#helmfile-structure","title":"Helmfile Structure","text":"<ul> <li>The <code>envs/common.yaml</code> file contains the specification for environments pattern, list of helm repositories from which it is necessary to fetch the helm charts and additional Helm parameters.</li> <li>The <code>envs/platform.yaml</code> file contains global parameters that are used in various Helmfiles.</li> <li>The <code>releases/envs/</code> contains symbol links to environments files.</li> <li>The <code>releases/*.yaml</code> file contains description of parameters that is used when deploying a Helm chart.</li> <li>The <code>helmfile.yaml</code> file defines components to be installed by defining a path to Helm releases files.</li> <li>The <code>envs/ci.yaml</code> file contains stub parameters for CI linter.</li> <li>The <code>test/lint-ci.sh</code> script for running CI linter with debug loglevel and stub parameters.</li> <li>The <code>resources/*.yaml</code> file contains additional resources for the OpenShift platform.</li> </ul>"},{"location":"operator-guide/install-via-helmfile/#operate-helmfile","title":"Operate Helmfile","text":"<p>Before applying the Helmfile, please fill in the global parameters in the <code>envs/platform.yaml</code> (check the examples in the <code>envs/ci.yaml</code>) and <code>releases/*.yaml</code> files for every Helm deploy.</p> <p>Pay attention to the following recommendations while working with the Helmfile:</p> <ul> <li>To launch Lint, run the <code>test/lint-ci.sh</code> script.</li> </ul> <ul> <li>Display the difference between the deployed and environment state (<code>helm diff</code>):<pre><code>helmfile --environment platform -f helmfile.yaml diff\n</code></pre> </li> </ul> <ul> <li>Apply the deployment:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ul> <ul> <li>Modify the deployment and apply the changes:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml sync\n</code></pre> </li> </ul> <ul> <li>To deploy the components according to the label, use the selector to target a subset of releases when running the Helmfile. It can be useful for large Helmfiles with the releases that are logically grouped together. For example, to display the difference only for the <code>nginx-ingress</code> file, use the following command:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml diff\n</code></pre> </li> </ul> <ul> <li>To destroy the release, run the following command:<pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml destroy\n</code></pre> </li> </ul>"},{"location":"operator-guide/install-via-helmfile/#deploy-components","title":"Deploy Components","text":"<p>Using the Helmfile, the following components can be installed:</p> <ul> <li>NGINX Ingress Controller</li> <li>Keycloak</li> <li>EPAM Delivery Platform</li> <li>Argo CD</li> <li>External Secrets Operator</li> <li>DefectDojo</li> <li>Moon</li> <li>ReportPortal</li> <li>Kiosk</li> <li>Monitoring stack, included Prometheus, Alertmanager, Grafana, PrometheusOperator</li> </ul> <ul> <li>Logging ELK stack, included Elasticsearch, Fluent-bit, Kibana</li> <li>Logging Grafana/Loki stack, included Grafana, Loki, Promtail, Logging Operator, Logging Operator Logging</li> </ul>"},{"location":"operator-guide/install-via-helmfile/#deploy-nginx-ingress-controller","title":"Deploy NGINX Ingress Controller","text":"<p>Info</p> <p>Skip this step for the OpenShift platform, because it has its own Ingress Controller.</p> <p>To install NGINX Ingress controller, follow the steps below:</p> <ol> <li> <p>In the <code>releases/nginx-ingress.yaml</code> file, set the <code>proxy-real-ip-cidr</code> parameter according to the value with AWS VPC IPv4 CIDR.</p> </li> <li> <p>Install NGINX Ingress controller:</p> <pre><code>helmfile  --selector component=ingress --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-keycloak","title":"Deploy Keycloak","text":"<p>Keycloak requires a database deployment, so it has two charts: <code>releases/keycloak.yaml</code> and <code>releases/postgresql-keycloak.yaml</code>.</p> <p>To install Keycloak, follow the steps below:</p> <ol> <li> <p>Create a <code>security</code> namespace:</p> <p>Note</p> <p>For the OpenShift users: This namespace is also indicated as <code>users</code> in the following custom <code>SecurityContextConstraints</code> resources: <code>resources/keycloak-scc.yaml</code> and <code>resources/postgresql-keycloak-scc.yaml</code>. Change the namespace name when using a custom namespace.</p> <pre><code>kubectl create namespace security\n</code></pre> </li> <li> <p>Create PostgreSQL admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-postgresql \\\n--from-literal=password=&lt;postgresql_password&gt; \\\n--from-literal=postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>dnsWildCard</code> parameter.</p> </li> <li> <p>Create Keycloak admin secret:</p> <pre><code>kubectl -n security create secret generic keycloak-admin-creds \\\n--from-literal=username=&lt;keycloak_admin_username&gt; \\\n--from-literal=password=&lt;keycloak_admin_password&gt;\n</code></pre> </li> <li> <p>Install Keycloak:</p> <pre><code>helmfile  --selector component=sso --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-external-secrets-operator","title":"Deploy External Secrets Operator","text":"<p>To install External Secrets Operator, follow the steps below:</p> <pre><code>helmfile --selector component=secrets --environment platform -f helmfile.yaml apply\n</code></pre>"},{"location":"operator-guide/install-via-helmfile/#deploy-kiosk","title":"Deploy Kiosk","text":"<p>To install Kiosk, follow the steps below:</p> <pre><code>helmfile --selector component=kiosk --environment platform -f helmfile.yaml apply\n</code></pre>"},{"location":"operator-guide/install-via-helmfile/#deploy-epam-delivery-platform","title":"Deploy EPAM Delivery Platform","text":"<p>To install EDP, follow the steps below:</p> <ol> <li> <p>Create a <code>platform</code> namespace:</p> <pre><code>kubectl create namespace platform\n</code></pre> </li> <li> <p>For EDP, it is required to have Keycloak access to perform the integration. Create a secret with the user and password provisioned in the step 2 of the Keycloak Configuration section.</p> <pre><code>kubectl -n platform create secret generic keycloak \\\n  --from-literal=username=&lt;username&gt; \\\n  --from-literal=password=&lt;password&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>edpName</code> and <code>keycloakEndpoint</code> parameters.</p> </li> <li> <p>In the <code>releases/edp-install.yaml</code> file, check and fill in all values.</p> </li> <li> <p>Install EDP:</p> <pre><code>helmfile  --selector component=edp --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-argo-cd","title":"Deploy Argo CD","text":"<p>Before Argo CD deployment, install the following tools:</p> <ul> <li>Keycloak</li> <li>EDP</li> </ul> <p>To install Argo CD, follow the steps below:</p> <ol> <li> <p>Install Argo CD:</p> <p>For the OpenShift users:<p>When using a custom namespace for Argo CD, the <code>argocd</code> namespace is also indicated as <code>users</code> in the <code>resources/argocd-scc.yaml</code> custom <code>SecurityContextConstraints</code> resource. Change it there as well.</p> </p> <pre><code>helmfile --selector component=argocd --environment platform -f helmfile.yaml apply\n</code></pre> </li> <li> <p>Update the <code>argocd-secret</code> secret in the Argo CD namespace by providing the correct Keycloak client secret (<code>oidc.keycloak.clientSecret</code>) with the value from the <code>keycloak-client-argocd-secret</code> secret in EDP namespace. Then restart the deployment:</p> <pre><code>ARGOCD_CLIENT=$(kubectl -n platform get secret keycloak-client-argocd-secret  -o jsonpath='{.data.clientSecret}')\nkubectl -n argocd patch secret argocd-secret -p=\"{\\\"data\\\":{\\\"oidc.keycloak.clientSecret\\\": \\\"${ARGOCD_CLIENT}\\\"}}\" -v=1\nkubectl -n argocd rollout restart deployment argo-argocd-server\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-defectdojo","title":"Deploy DefectDojo","text":"<p>Prerequisites</p> <ol> <li>Before DefectDojo deployment,first make sure to have the Keycloak configuration.</li> </ol> <p>Info</p> <p>It is also possible to install DefectDojo via Helm Chart. For details, please refer to the Install DefectDojo page.</p> <p>To install DefectDojo via Helmfile, follow the steps below:</p> <ol> <li> <p>Create a DefectDojo namespace:</p> <p>For the OpenShift users:</p> <p>This namespace is also indicated as <code>users</code> in the <code>resources/defectdojo-scc.yaml</code> custom <code>SecurityContextConstraints</code> resource. Change it when using a custom namespace. Also, change the namespace in the <code>resources/defectdojo-route.yaml</code> file.</p> <pre><code>kubectl create namespace defectdojo\n</code></pre> </li> <li> <p>Modify the <code>host</code> in <code>resources/defectdojo-route.yaml</code> (only for OpenShift).</p> </li> <li> <p>Create a PostgreSQL admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-postgresql-specific \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Note</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Create a RabbitMQ admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-rabbitmq-specific \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Note</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long.</p> <p>The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Create a DefectDojo admin secret:</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo \\\n--from-literal=DD_ADMIN_PASSWORD=&lt;dd_admin_password&gt; \\\n--from-literal=DD_SECRET_KEY=&lt;dd_secret_key&gt; \\\n--from-literal=DD_CREDENTIAL_AES_256_KEY=&lt;dd_credential_aes_256_key&gt; \\\n--from-literal=METRICS_HTTP_AUTH_PASSWORD=&lt;metric_http_auth_password&gt;\n</code></pre> <p>Note</p> <p>The <code>dd_admin_password</code> password must be 22 characters long.</p> <p>The <code>dd_secret_key</code> password must be 128 characters long.</p> <p>The <code>dd_credential_aes_256_key</code> password must be 128 characters long.</p> <p>The <code>metric_http_auth_password</code> password must be 32 characters long.</p> </li> <li> <p>Create a Keycloak client secret for DefectDojo:</p> <p>Note</p> <p>The <code>keycloak_client_secret</code> value received from: <code>edpName</code>-main realm -&gt; clients -&gt; defectdojo -&gt; Credentials -&gt; Client secret</p> <pre><code>kubectl -n defectdojo create secret generic defectdojo-extrasecrets \\\n--from-literal=DD_SOCIAL_AUTH_KEYCLOAK_SECRET=&lt;keycloak_client_secret&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>dnsWildCard</code> parameter.</p> </li> <li> <p>In the releases/defectdojo.yaml file, check and fill in all values.</p> </li> <li> <p>Install DefectDojo:</p> <pre><code>helmfile  --selector component=defectdojo --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-reportportal","title":"Deploy ReportPortal","text":"<p>Info</p> <p>It is also possible to install ReportPortal via Helm Chart. For details, please refer to the Install ReportPortal page.</p> <p>ReportPortal requires third-party deployments: RabbitMQ, ElasticSearch, PostgreSQL, MinIO.</p> <p>To install third-party resources, follow the steps below:</p> <ol> <li> <p>Create a RabbitMQ admin secret:</p> <pre><code>kubectl -n report-portal create secret generic reportportal-rabbitmq-creds \\\n--from-literal=rabbitmq-password=&lt;rabbitmq_password&gt; \\\n--from-literal=rabbitmq-erlang-cookie=&lt;rabbitmq_erlang_cookie&gt;\n</code></pre> <p>Warning</p> <p>The <code>rabbitmq_password</code> password must be 10 characters long.</p> <p>The <code>rabbitmq_erlang_cookie</code> password must be 32 characters long.</p> </li> <li> <p>Create a PostgreSQL admin secret:</p> <pre><code>kubectl -n report-portal create secret generic reportportal-postgresql-creds \\\n--from-literal=postgresql-password=&lt;postgresql_password&gt; \\\n--from-literal=postgresql-postgres-password=&lt;postgresql_postgres_password&gt;\n</code></pre> <p>Warning</p> <p>The <code>postgresql_password</code> and <code>postgresql_postgres_password</code> passwords must be 16 characters long.</p> </li> <li> <p>Create a MinIO admin secret:</p> <pre><code>kubectl -n report-portal create secret generic reportportal-minio-creds \\\n--from-literal=root-password=&lt;root_password&gt; \\\n--from-literal=root-user=&lt;root_user&gt;\n</code></pre> </li> <li> <p>In the <code>envs/platform.yaml</code> file, set the <code>dnsWildCard</code> and <code>edpName</code> parameters.</p> <p>For the OpenShift users:</p> <p>The namespace is also indicated as <code>users</code> in the following custom <code>SecurityContextConstraints</code> resources: <code>resources/report-portal-elasticsearch-scc.yaml</code> and <code>resources/report-portal-third-party-resources-scc.yaml</code>. Change the namespace name when using a custom namespace.</p> </li> <li> <p>Install third-party resources:</p> <pre><code>helmfile --selector component=report-portal-third-party-resources --environment platform -f helmfile.yaml apply\n</code></pre> </li> <li> <p>After the rabbitmq pod gets the status Running, you need to configure the RabbitMQ memory threshold</p> <pre><code>kubectl -n report-portal exec -it rabbitmq-0 -- rabbitmqctl set_vm_memory_high_watermark 0.8\n</code></pre> </li> </ol> <p>To install ReportPortal via Helmfile, follow the steps below:</p> <p>For the OpenShift users:</p> <ol> <li>The namespace is also indicated as <code>users</code> in the <code>resources/report-portal-reportportal-scc.yaml</code> custom <code>SecurityContextConstraints</code> resource. Change it when using a custom namespace.</li> <li>Change the namespace in the following files: <code>resources/report-portal-gateway/gateway-config-cm</code>, <code>resources/report-portal-gateway/gateway-deployment</code>, <code>resources/report-portal-gateway/gateway-route</code>, and <code>resources/report-portal-gateway/gateway-service</code>.</li> <li>Modify the <code>host</code> in <code>resources/report-portal-gateway/gateway-route</code></li> </ol> <pre><code>helmfile --selector component=report-portal --environment platform -f helmfile.yaml apply\n</code></pre> <p>Note</p> <p>For user access: default/1q2w3e For admin access: superadmin/erebus Please refer to the ReportPortal.io page for details.</p>"},{"location":"operator-guide/install-via-helmfile/#deploy-moon","title":"Deploy Moon","text":"<p>Moon is a browser automation solution compatible with Selenium, Cypress, Playwright, and Puppeteer using Kubernetes or Openshift to launch browsers.</p> <p>Note</p> <p>Aerokube/Moon does not require third-party deployments.</p> <p>Follow the steps below to deploy Moon:</p> <ol> <li> <p>Use the following command to install Moon:</p> <pre><code>helmfile --selector component=moon --environment platform -f helmfile.yaml apply\n</code></pre> </li> <li> <p>After the installation, open the Ingress Dashboard and check that <code>SELENOID</code> and <code>SSE</code> have the <code>CONNECTED</code> status.</p> <p> Main board </p> </li> <li> <p>In Moon, use the following command with the Ingress rule, for example, <code>wd/hub</code>:</p> <pre><code>    curl -X POST 'http://&lt;INGRESS_LINK&gt;/wd/hub/session' -d '{\n                \"desiredCapabilities\":{\n                    \"browserName\":\"firefox\",\n                    \"version\": \"79.0\",\n                    \"platform\":\"ANY\",\n                    \"enableVNC\": true,\n                    \"name\": \"edp\",\n                    \"sessionTimeout\": \"480s\"\n                }\n            }'\n</code></pre> <p>See below the list of Moon Dashboard Ingress rules:</p> <p> Moon Dashboard Ingress rules </p> <p>After using the command above, the container will start, and the VNC viewer will be displayed on the Moon Dashboard:</p> <p> VNC viewer with the container starting </p> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-monitoring","title":"Deploy Monitoring","text":"<p>The monitoring stack includes Grafana, Prometheus, Alertmanager, and Karma-dashboard. To deploy it follow the steps:</p> <ol> <li> <p>Generate a token for Keycloak client:</p> <p>Note</p> <p>The token must be 32-character and include alphabetic and numeric symbols. For example, use the following command:</p> <pre><code>keycloak_client_secret=$(date +%s | sha256sum | base64 | head -c 32 ; echo)\n</code></pre> </li> <li> <p>Create a secret for the Keycloak client:</p> <pre><code>kubectl -n platform create secret generic keycloak-client-grafana \\\n--from-literal=clientSecret=&lt;keycloak_client_secret&gt;\n</code></pre> </li> <li> <p>Create a secret for the Grafana:</p> <pre><code>kubectl -n monitoring create secret generic keycloak-client-grafana \\\n--from-literal=GF_AUTH_GENERIC_OAUTH_CLIENT_SECRET=&lt;keycloak_client_secret&gt; \\\n</code></pre> </li> <li> <p>Create a custom resource for the Keycloak client:</p> View: keycloak_client <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: grafana\nnamespace: platform\nspec:\nclientId: grafana\ndirectAccess: true\nserviceAccount:\nenabled: true\ntargetRealm: platform-main\nwebUrl: https://grafana-monitoring.&lt;dnsWildCard&gt;\nsecret: keycloak-client.grafana\n</code></pre> </li> <li> <p>Run command:</p> <pre><code>helmfile --selector component=monitoring --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#deploy-logging","title":"Deploy Logging","text":"ELK stackGrafana, Loki, Promtail stack <p>To install Elasticsearch, Kibana and Fluentbit, run command:</p> <pre><code>helmfile --selector component=logging-elastic --environment platform -f helmfile.yaml apply\n</code></pre> <p>To install Grafana, Loki, Promtail, follow the steps below:</p> <ol> <li> <p>Make sure that appropriate resources are created:</p> <ul> <li>Secret for the Keycloak client</li> </ul> <ul> <li>Secret for the Grafana</li> </ul> </li> <li> <p>Create a custom resource for the Keycloak client:</p> View: keycloak_client <pre><code>apiVersion: v1.edp.epam.com/v1\nkind: KeycloakClient\nmetadata:\nname: grafana\nnamespace: platform\nspec:\nclientId: grafana-logging\ndirectAccess: true\nserviceAccount:\nenabled: true\ntargetRealm: platform-main\nwebUrl: https://grafana-logging.&lt;dnsWildCard&gt;\nsecret: keycloak-client.grafana\n</code></pre> </li> <li> <p>Run command:</p> <pre><code>helmfile --selector component=logging --environment platform -f helmfile.yaml apply\n</code></pre> </li> </ol>"},{"location":"operator-guide/install-via-helmfile/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install NGINX Ingress Controller</li> <li>Install Keycloak</li> <li>Install DefectDojo</li> <li>Install ReportPortal</li> <li>Install Argo CD</li> </ul>"},{"location":"operator-guide/jira-gerrit-integration/","title":"Adjust VCS Integration With Jira","text":"<p>In order to adjust the Version Control System integration with Jira Server, first make sure you have the following prerequisites:</p> <ul> <li>VCS Server</li> <li>Jira</li> <li>Crucible</li> </ul> <p>When checked the prerequisites, follow the steps below to proceed with the integration:</p> <ol> <li> <p>Integrate every project in VCS Server with every project in Crucible by creating a corresponding request in EPAM Support Portal. Add the repositories links and fill in the Keep Informed field as this request must be approved.</p> <p> Request example </p> </li> <li> <p>Provide additional details to the support team. If the VCS is Gerrit, inspect the sample below of its integration:</p> <p>2.1 Create a new \"crucible-\" user in Gerrit with SSH key and add a new user to the \"Non-Interactive Users\" Gerrit group; <p>2.2 Create a new group in Gerrit \"crucible-watcher-group\" and add the \"crucible-\" user; <p>2.3 Provide access to All-Projects for the \"crucible-watcher-group\" group:</p> <p> Gerrit All-Projects configuration </p> <p> Gerrit All-Projects configuration </p> <li> <p>To link commits with Jira ticket, being in Gerrit, enter a Jira ticket ID in a commit message using the specific format:</p> <p>[PROJECT-CODE-1234]: commit message</p> <p>where PROJECT-CODE is a specific code of a project, 1234 is an ID number, and a commit message.</p> </li> <li> <p>As a result, all Gerrit commits will be displayed on Crucible:</p> <p> Crucible project </p> </li>"},{"location":"operator-guide/jira-gerrit-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Adjust Jira Integration</li> </ul>"},{"location":"operator-guide/jira-integration/","title":"Adjust Jira Integration","text":"<p>This documentation guide provides step-by-step instructions for enabling the Jira integration option in the EDP Portal UI for EPAM Delivery Platform. Jira integration allows including useful metadata in Jira tickets.</p>"},{"location":"operator-guide/jira-integration/#overview","title":"Overview","text":"<p>Integrating Jira can provide a number of benefits, such as increased visibility and traceability, automatic linking code changes to relevant Jira issues, streamlining the management and tracking of development progress.</p> <p>By linking CI pipelines to Jira issues, teams can get a better understanding of the status of their work and how it relates to the overall development process. This can help to improve communication and collaboration, and ultimately lead to faster and more efficient delivery of software.</p> <p>Enabling Jira integration allows for the automatic population of three fields in Jira tickets: Fix Versions, Components, and Labels. Each of these fields provides distinct benefits:</p> <ul> <li>Fix Versions: helps track progress against release schedules;</li> <li>Components: allows grouping related issues together;</li> <li>Labels: enables identification of specific types of work.</li> </ul> <p>Teams can utilize these fields to enhance their work prioritization, identify dependencies, improve collaboration, and ultimately achieve faster software delivery.</p>"},{"location":"operator-guide/jira-integration/#integration-procedure","title":"Integration Procedure","text":"<p>In order to adjust the Jira server integration, add the JiraServer CR by performing the following:</p> <ol> <li> <p>Provision the secret using <code>EDP Portal</code>, <code>Manifest</code> or with the <code>externalSecrets</code> operator:</p> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; Jira. Update or fill in the URL, User, Password fields and click the Save button:</p> <p> Jira update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-jira\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type=jira\nstringData:\nurl: https://jira.example.com\nusername: username\npassword: password\n</code></pre> <pre><code>\"ci-jira\":\n{\n\"url\": \"https://jira.example.com\",\n\"username\": \"username\",\n\"password\": \"password\"\n}\n</code></pre> </li> <li> <p>Create JiraServer CR in the OpenShift/Kubernetes namespace with the apiUrl, credentialName and rootUrl fields:</p> <pre><code>apiVersion: v2.edp.epam.com/v1\nkind: JiraServer\nmetadata:\nname: jira-server\nspec:\napiUrl: 'https://jira-api.example.com'\ncredentialName: ci-jira\nrootUrl: 'https://jira.example.com'\n</code></pre> <p>Note</p> <p>The value of the credentialName property is the name of the Secret, which is indicated in the first point above.</p> </li> <li> <p>In the EDP Portal UI, navigate to the Advanced Settings menu to check that the Integrate with Jira server check box appeared:</p> <p> Advanced settings </p> <p>Note</p> <p>There are four predefined variables with the respective values that can be specified singly or as a combination:</p> <p>EDP_COMPONENT \u2013 returns application-name EDP_VERSION \u2013 returns 0.0.0-SNAPSHOT or 0.0.0-RC EDP_SEM_VERSION \u2013 returns 0.0.0 EDP_GITTAG \u2013 returns build/0.0.0-SNAPSHOT.2 or build/0.0.0-RC.2</p> <p>There are no character restrictions when combining the variables, combination samples: EDP_SEM_VERSION-EDP_COMPONENT or EDP_COMPONENT-hello-world/EDP_VERSION, etc.</p> <p>As a result of successful Jira integration, the additional information will be added to tickets.</p> </li> </ol>"},{"location":"operator-guide/jira-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Adjust VCS Integration With Jira</li> <li>Add Application</li> </ul>"},{"location":"operator-guide/kaniko-irsa/","title":"IAM Roles for Kaniko Service Accounts","text":"<p>Note</p> <p>The information below is relevant in case ECR is used as Docker container registry. Make sure that IRSA is enabled and amazon-eks-pod-identity-webhook is deployed according to the Associate IAM Roles With Service Accounts documentation.</p> <p>The \"build-image-kaniko\" stage manages ECR through IRSA that should be available on the cluster. Follow the steps below to create a required role:</p> <ol> <li> <p>Create AWS IAM Policy \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko_policy\":</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n        \"Effect\": \"Allow\",\n        \"Action\": [\n            \"ecr:*\",\n            \"cloudtrail:LookupEvents\"\n        ],\n        \"Resource\": \"arn:aws:ecr:&lt;AWS_REGION&gt;:&lt;AWS_ACCOUNT_ID&gt;:repository/&lt;EDP_NAMESPACE&gt;/*\"\n    },\n    {\n        \"Effect\": \"Allow\",\n        \"Action\": \"ecr:GetAuthorizationToken\",\n        \"Resource\": \"*\"\n    },\n    {\n        \"Effect\": \"Allow\",\n        \"Action\": [\n            \"ecr:DescribeRepositories\",\n            \"ecr:CreateRepository\"\n        ],\n        \"Resource\": \"arn:aws:ecr:&lt;AWS_REGION&gt;:&lt;AWS_ACCOUNT_ID&gt;:repository/*\"\n    }\n  ]\n}\n</code></pre> </li> <li> <p>Create AWS IAM Role \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\" with trust relationships:</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:edp:edp-kaniko\"\n        }\n      }\n    }\n  ]\n}\n</code></pre> </li> <li> <p>Attach the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko_policy\" policy to the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\" role.</p> </li> <li> <p>Define the resulted arn role value into the kaniko.roleArn parameter in values.yaml during the EDP installation.</p> </li> </ol>"},{"location":"operator-guide/kaniko-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Associate IAM Roles With Service Accounts</li> <li>Install EDP</li> </ul>"},{"location":"operator-guide/kibana-ilm-rollover/","title":"Aggregate Application Logs Using EFK Stack","text":"<p>This documentation describes the advantages of EFK stack over the traditional ELK stack, explains the value that this stack brings to EDP and instructs how to set up the EFK stack to integrate the advanced logging system with your application.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#elk-stack-overview","title":"ELK Stack Overview","text":"<p>The ELK (Elasticsearch, Logstash and Kibana) stack gives the ability to aggregate logs from all the managed systems and applications, analyze these logs and create visualizations for application and infrastructure monitoring, faster troubleshooting, security analytics and more.</p> <p>Here is a brief description of the ELK stack default components:</p> <ul> <li>Beats family - The logs shipping tool that conveys logs from the source locations, such as Filebeat, Metricbeat, Packetbeat, etc. Beats can work instead of Logstash or along with it.</li> <li>Logstash - The log processing framework for log collecting, processing, storing and searching activities.</li> <li>Elasticsearch - The distributed search and analytics engine based on Lucene Java library.</li> <li>Kibana - The visualization engine that queries the data from Elasticsearch.</li> </ul> <p> ELK Stack </p>"},{"location":"operator-guide/kibana-ilm-rollover/#efk-stack-overview","title":"EFK Stack Overview","text":"<p>We use FEK (also called EFK) (Fluent Bit, Elasticsearch, Kibana) stack in Kubernetes instead of ELK because this stack provides us with the support for Logsight for Stage Verification and Incident Detection. In addition to it, Fluent Bit has a smaller memory fingerprint than Logstash. Fluent Bit has the Inputs, Parsers, Filters and Outputs plugins similarly to Logstash.</p> <p> FEK Stack </p>"},{"location":"operator-guide/kibana-ilm-rollover/#automate-elasticsearch-index-rollover-with-ilm","title":"Automate Elasticsearch Index Rollover With ILM","text":"<p>In this guide, index rollover with the Index Lifecycle Management ILM is automated in the FEK stack.</p> <p>The resources can be created via API using curl, Postman, Kibana Dev Tools console or via GUI. They are going to be created them using Kibana Dev Tools.</p> <ol> <li> <p>Go to <code>Management</code> \u2192 <code>Dev Tools</code> in the Kibana dashboard:</p> <p> Dev Tools </p> </li> <li> <p>Create index lifecycle policy with the index rollover:</p> <p>Note</p> <p>This policy can also be created in GUI in <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Index Lifecycle Policies</code>.</p> <p>Index Lifecycle has several phases: Hot, Warm, Cold, Frozen, Delete. Indices also have different priorities in each phase. The warmer the phase, the higher the priority is supposed to be, e.g., 100 for the hot phase, 50 for the warm phase, and 0 for the cold phase. </p> <p>In this Use Case, only the Hot and Delete phases are configured. So an index will be created, rolled over to a new index when 1gb in size or 1day in time and deleted in 7 days. The rollover may not happen exactly at 1GB because it depends on how often Kibana checks the index size. Kibana usually checks the index size every 10 minutes but this can be changed by setting the indices.lifecycle.poll_interval monitoring timer.</p> <p>The index lifecycle policy example:</p> Index Lifecycle Policy <pre><code>PUT _ilm/policy/fluent-bit-policy\n{\n\"policy\": {\n\"phases\": {\n\"hot\": {\n\"min_age\": \"0ms\",\n\"actions\": {\n\"set_priority\": {\n\"priority\": 100\n},\n\"rollover\": {\n\"max_size\": \"1gb\",\n\"max_primary_shard_size\": \"1gb\",\n\"max_age\": \"1d\"\n}\n}\n},\n\"delete\": {\n\"min_age\": \"7d\",\n\"actions\": {\n\"delete\": {\n\"delete_searchable_snapshot\": true\n}\n}\n}\n}\n}\n}\n</code></pre> <p>Insert the code above into the <code>Dev Tools</code> and click the arrow to send the <code>PUT</code> request.</p> </li> <li> <p>Create an index template so that a new index is created according to this template after the rollover:</p> <p>Note</p> <p>This policy can also be created in GUI in <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Index Management</code> \u2192 <code>Index Templates</code>.</p> <p>Expand the menu below to see the index template example:</p> Index Template <pre><code>PUT /_index_template/fluent-bit\n{\n\"index_patterns\": [\"fluent-bit-kube-*\"],\n\"template\": {\n\"settings\": {\n\"index\": {\n\"lifecycle\": {\n\"name\": \"fluent-bit-policy\",\n\"rollover_alias\": \"fluent-bit-kube\"\n},\n\"number_of_shards\": \"1\",\n\"number_of_replicas\": \"0\"\n}\n}\n}\n}\n</code></pre> <p>Note</p> <ul> <li><code>index.lifecycle.rollover_alias</code> is required when using a policy containing the rollover action and specifies which alias to rollover on behalf of this index. The intention here is that the rollover alias is also defined on the index.</li> </ul> <ul> <li><code>number_of_shards</code> is the quantity of the primary shards. Elasticsearch index is really just a logical grouping of one or more physical shards, where each shard is actually a self-contained index. By distributing the documents in an index across multiple shards and distributing those shards across multiple nodes, Elasticsearch can ensure redundancy, which both protects against hardware failures and increases query capacity as nodes are added to a cluster. As the cluster grows (or shrinks), Elasticsearch automatically migrates shards to re-balance the cluster. Please refer to the official documentation here.</li> </ul> <ul> <li> <p><code>number_of_replicas</code> is the number of replica shards. A replica shard is a copy of a primary shard. Elasticsearch will never assign a replica to the same node as the primary shard, so make sure you have more than one node in your Elasticsearch cluster if you need to use replica shards. The Elasticsearch cluster details and the quantity of nodes can be checked with:</p> <pre><code>GET _cluster/health\n</code></pre> </li> </ul> <p>Since we use one node, the number_of_shards  is 1 and number_of_replicas is 0. If you put more replicas within one node, your index will get yellow status in Kibana, yet still be working.</p> </li> <li> <p>Create an empty index with write permissions:</p> <p>Note</p> <p>This index can also be created in GUI in <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Index Management</code> \u2192 <code>Indices</code>.</p> <p>Index example with the date math format:</p> Index <pre><code># URI encoded /&lt;fluent-bit-kube-{now/d}-000001&gt;\nPUT /%3Cfluent-bit-kube-%7Bnow%2Fd%7D-000001%3E\n{\n\"aliases\": {\n\"fluent-bit-kube\": {\n\"is_write_index\": true\n}\n}\n}\n</code></pre> <p>The code above will create an index in the<code>{index_name}-{current_date}-{rollover_index_increment}</code> format. For example: <code>fluent-bit-kube-2023.03.17-000001</code>.</p> <p>Please refer to the official documentation on the index rollover with Date Math here.</p> <p>Note</p> <p>It is also possible to use index pattern below if the date math format does not seem applicable:</p> <p> Index <pre><code>PUT fluent-bit-kube-000001\n{\n\"aliases\": {\n\"fluent-bit-kube\": {\n\"is_write_index\": true\n}\n}\n}\n</code></pre> </p> <p>Check the status of the created index:</p> <pre><code>GET fluent-bit-kube*-000001/_ilm/explain\n</code></pre> </li> <li> <p>Configure Fluent Bit. Play attention to the Elasticsearch Output plugin configuration.</p> <p>The important fields in the <code>[OUTPUT]</code> section are <code>Index fluent-bit-kube</code> since we should use the index with the same name as Rollover Alias in Kibana and <code>Logstash_Format Off</code> as we use the Rollover index pattern in Kibana that increments by 1.</p> <p>ConfigMap example with Configuration Variables for <code>HTTP_User</code> and <code>HTTP_Passwd</code>:</p> ConfigMap fluent-bit <pre><code>data:\nfluent-bit.conf: |\n[SERVICE]\nDaemon Off\nFlush 10\nLog_Level info\nParsers_File parsers.conf\nParsers_File custom_parsers.conf\nHTTP_Server On\nHTTP_Listen 0.0.0.0\nHTTP_Port 2020\nHealth_Check On\n\n[INPUT]\nName tail\nTag kube.*\nPath /var/log/containers/*.log\nParser docker\nMem_Buf_Limit 5MB\nSkip_Long_Lines Off\nRefresh_Interval 10\n[INPUT]\nName systemd\nTag host.*\nSystemd_Filter _SYSTEMD_UNIT=kubelet.service\nRead_From_Tail On\nStrip_Underscores On\n\n[FILTER]\nName                kubernetes\nMatch               kube.*\nKube_Tag_Prefix     kube.var.log.containers.\nKube_URL            https://kubernetes.default.svc:443\nKube_CA_File        /var/run/secrets/kubernetes.io/serviceaccount/ca.crt\nKube_Token_File     /var/run/secrets/kubernetes.io/serviceaccount/token\nMerge_Log           Off\nMerge_Log_Key       log_processed\nK8S-Logging.Parser  On\nK8S-Logging.Exclude On\n[FILTER]\nName nest\nMatch kube.*\nOperation lift\nNested_under kubernetes\nAdd_prefix kubernetes.\n[FILTER]\nName modify\nMatch kube.*\nCopy kubernetes.container_name tags.container\nCopy log message\nCopy kubernetes.container_image tags.image\nCopy kubernetes.namespace_name tags.namespace\n[FILTER]\nName nest\nMatch kube.*\nOperation nest\nWildcard tags.*\nNested_under tags\nRemove_prefix tags.\n\n[OUTPUT]\nName            es\nMatch           kube.*\nIndex           fluent-bit-kube\nHost            elasticsearch-master\nPort            9200\nHTTP_User       ${ES_USER}\nHTTP_Passwd     ${ES_PASSWORD}\nLogstash_Format Off\nTime_Key       @timestamp\nType            flb_type\nReplace_Dots    On\nRetry_Limit     False\nTrace_Error     Off\n</code></pre> </li> <li> <p>Create index pattern (Data View starting from Kibana v8.0):</p> <p>Go to <code>Management</code> \u2192 <code>Stack Management</code> \u2192 <code>Kibana</code> \u2192 <code>Index patterns</code> and create an index with the <code>fluent-bit-kube-*</code> pattern:</p> <p> Index Pattern </p> </li> <li> <p>Check logs in Kibana. Navigate to <code>Analytics</code> \u2192 <code>Discover</code>:</p> <p> Logs in Kibana </p> <p>Note</p> <p>In addition, in the top-right corner of the <code>Discover</code> window, there is a button called <code>Inspect</code>. Clicking on it will reveal the query that Kibana is sending to Elasticsearch. These queries can be used in Dev Tools.</p> </li> <li> <p>Monitor the created indices:</p> <pre><code>GET _cat/indices/fluent-bit-kube-*\n</code></pre> <p>Note</p> <p>Physically, the indices are located on the <code>elasticsearch</code> Kubernetes pod in <code>/usr/share/elasticsearch/data/nodes/0/indices</code>. It is recommended to backup indices only via Snapshots.</p> </li> </ol> <p>We've configured the index rollover process. Now the index will be rolled over to a new one once it reaches the indicated size or time in the policy, and old indices will be removed according to the policy as well.</p> <p>When you create an empty index that corresponds to the pattern indicated in the index template, the index template attaches <code>rollover_alias</code> with the <code>fluent-bit-kube</code> name, policy and other configured data. Then the Fluent Bit Elasticsearch output plugin sends logs to the <code>Index fluent-bit-kube</code> rollover alias. The index rollover process is managed by ILM that increments our indices united by the <code>rollover_alias</code> and distributes the log data to the latest index.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#ilm-without-rollover-policy","title":"ILM Without Rollover Policy","text":"<p>It is also possible to manage index lifecycle without rollover indicated in the policy. If this is the case, this section will explain how to refactor the index to make it look that way: <code>fluent-bit-kube-2023.03.18</code>.</p> <p>Note</p> <p>The main drawback of this method is that the indices can be managed only by their creation date.</p> <p>To manage index lifecycle without rollover policy, follow the steps below:</p> <ol> <li> <p>Create a Policy without <code>rollover</code> but with indices deletion:</p> Index Lifecycle Policy <pre><code>PUT _ilm/policy/fluent-bit-policy\n{\n\"policy\": {\n\"phases\": {\n\"hot\": {\n\"min_age\": \"0ms\",\n\"actions\": {\n\"set_priority\": {\n\"priority\": 100\n}\n}\n},\n\"delete\": {\n\"min_age\": \"7d\",\n\"actions\": {\n\"delete\": {\n\"delete_searchable_snapshot\": true\n}\n}\n}\n}\n}\n}\n</code></pre> </li> <li> <p>Create an index template with the <code>rollover_alias</code> parameter:</p> Index Template <pre><code>PUT /_index_template/fluent-bit\n{\n\"index_patterns\": [\"fluent-bit-kube-*\"],\n\"template\": {\n\"settings\": {\n\"index\": {\n\"lifecycle\": {\n\"name\": \"fluent-bit-policy\",\n\"rollover_alias\": \"fluent-bit-kube\"\n},\n\"number_of_shards\": \"1\",\n\"number_of_replicas\": \"0\"\n}\n}\n}\n}\n</code></pre> </li> <li> <p>Change the Fluent Bit <code>[OUTPUT]</code> config to this one:</p> ConfigMap fluent-bit <pre><code>[OUTPUT]\nName            es\nMatch           kube.*\nHost            elasticsearch-master\nPort            9200\nHTTP_User       ${ES_USER}\nHTTP_Passwd     ${ES_PASSWORD}\nLogstash_Format On\nLogstash_Prefix fluent-bit-kube\nLogstash_DateFormat %Y.%m.%d\nTime_Key        @timestamp\nType            flb_type\nReplace_Dots    On\nRetry_Limit     False\nTrace_Error     On\n</code></pre> </li> <li> <p>Restart Fluent Bit pods.</p> </li> </ol> <p>Fluent Bit will be producing a new index every day with the new date in its name like in the <code>fluent-bit-kube-2023.03.18</code> name. Index deleting will be performed according to the policy.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#tips-on-fluent-bit-debugging","title":"Tips on Fluent Bit Debugging","text":"<p>If you experience a lot of difficulties when dealing with Fluent Bit, this section may help you.</p> <p>Fluent Bit has docker images labelled <code>-debug</code>, e.g., <code>cr.fluentbit.io/fluent/fluent-bit:2.0.9-debug</code>.</p> <p>Change that image in the Kubernetes Fluent Bit DaemonSet and add the <code>Trace_Error On</code> parameter to the <code>[OUTPUT]</code> section in the Fluent Bit configmap:</p> <pre><code>[OUTPUT]\nTrace_Error On\n</code></pre> <p>After adding the parameter above, you will start seeing more informative logs that will probably help you find out the reason of the problem.</p>"},{"location":"operator-guide/kibana-ilm-rollover/#related-articles","title":"Related Articles","text":"<ul> <li>Index Lifecycle Management</li> <li>Elasticsearch Output</li> </ul>"},{"location":"operator-guide/kubernetes-cluster-settings/","title":"Set Up Kubernetes","text":"<p>Make sure the cluster meets the following conditions:</p> <ol> <li> <p>Kubernetes cluster is installed with minimum 2 worker nodes with total capacity 8 Cores and 32Gb RAM.</p> </li> <li> <p>Machine with kubectl is installed with a cluster-admin access to the Kubernetes cluster.</p> </li> <li> <p>Ingress controller is installed in a cluster, for example ingress-nginx.</p> </li> <li> <p>Ingress controller is configured with the disabled HTTP/2 protocol and header size of 64k support.</p> <p>Find below an example of the Config Map for the NGINX Ingress controller:</p> <pre><code>kind: ConfigMap\napiVersion: v1\nmetadata:\nname: nginx-configuration\nnamespace: ingress-nginx\nlabels:\napp.kubernetes.io/name: ingress-nginx\napp.kubernetes.io/part-of: ingress-nginx\ndata:\nclient-header-buffer-size: 64k\nlarge-client-header-buffers: 4 64k\nuse-http2: \"false\"\n</code></pre> </li> <li> <p>Load balancer (if any exists in front of the Ingress controller) is configured with session stickiness, disabled HTTP/2 protocol and header size of 32k support.</p> </li> <li> <p>Cluster nodes and pods have access to the cluster via external URLs. For instance, add in AWS the VPC NAT gateway elastic IP to the cluster external load balancers security group).</p> </li> <li> <p>Keycloak instance is installed. To get accurate information on how to install Keycloak, please refer to the Install Keycloak instruction.</p> </li> <li> <p>Helm 3.10 or higher is installed on the installation machine with the help of the Installing Helm instruction.</p> </li> <li> <p>Storage classes are used with the Retain Reclaim Policy and Delete Reclaim Policy.</p> </li> <li> <p>We recommended using our storage class as default storage class.</p> <p>Info</p> <p>By default, EDP uses the default Storage Class in a cluster. The EDP development team recommends using the following Storage Classes. See an example below.</p> <p>Storage class templates with the Retain and Delete Reclaim Policies:</p> ebs-scgp3gp3-retain <pre><code>apiVersion: storage.k8s.io/v1\nkind: StorageClass\nmetadata:\nname: ebs-sc\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: Immediate\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Delete\nvolumeBindingMode: Immediate\nallowVolumeExpansion: true\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3-retain\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: Immediate\nallowVolumeExpansion: true\n</code></pre> </li> </ol>"},{"location":"operator-guide/kubernetes-cluster-settings/#related-articles","title":"Related Articles","text":"<ul> <li>Install Amazon EBS CSI Driver</li> <li>Install NGINX Ingress Controller</li> <li>Install Keycloak</li> </ul>"},{"location":"operator-guide/logsight-integration/","title":"Logsight Integration","text":"<p>Logsight can be integrated with the CI/CD pipeline. It connects to log data sources, analyses collected logs, and evaluates deployment risk scores.</p>"},{"location":"operator-guide/logsight-integration/#overview","title":"Overview","text":"<p>In order to understand if a microservice or a component is ready for the deployment, EDP suggests analyzing logs via Logsight to decide if the deployment is risky or not.</p> <p>Please find more about Logsight in the official documentation:</p> <ul> <li>Logsight key features and workflow</li> <li>Log analysis</li> <li>Stage verification</li> </ul>"},{"location":"operator-guide/logsight-integration/#logsight-as-a-quality-gate","title":"Logsight as a Quality Gate","text":"<p>Integration with Logsight allows enhancing and optimizing software releases by creating an additional quality gate.</p> <p>Logsight can be configured in two ways:</p> <ul> <li>SAAS - online system; for this solution a connection string is required.</li> <li>Self-deployment - local installation.</li> </ul> <p>To work with Logsight, a new Deployment Risk stage must be added to the pipeline. On this stage, the logs are analyzed with the help of Logsight mechanisms.</p> <p>On the verification screen of Logsight, continuous verification of the application deployment can be monitored, and tests can be compared for detecting test flakiness.</p> <p>For example, two versions of a microservice can be compared in order to detect critical differences. Risk score will be calculated for the state reached by version A and version B. Afterwards, the deployment risk will be calculated based on individual risk scores.</p> <p>If the deployment failure risk is greater than a predefined threshold, the verification gate blocks the deployment from going to the target environment. In such case, the Deployment Risk stage of the pipeline is not passed, and additional attention is required. The exact log messages can be displayed in the Logsight verification screen, to help debug the problem.</p>"},{"location":"operator-guide/logsight-integration/#use-logsight-for-edp-development","title":"Use Logsight for EDP Development","text":"<p>Please find below the detailed description of Logsight integration with EDP.</p>"},{"location":"operator-guide/logsight-integration/#deployment-approach","title":"Deployment Approach","text":"<p>EDP uses Logsight in a self-deploying mode.</p> <p>Logsight provides a deployment approach using Helm charts. Please find below the stack of components that must be deployed:</p> <ul> <li><code>logsight</code>\u00a0- the core component.</li> <li><code>logsight-backend</code>\u00a0- the backend that provides all necessary APIs and user management.</li> <li><code>logsight-frontend</code>\u00a0- the frontend that provides the user interface.</li> <li><code>logsight-result-api</code>\u00a0- responsible for obtaining results, for example, during the verification.</li> </ul> <p>Below is a diagram of interaction when integrating the components:</p> <p> Logsight Structure </p>"},{"location":"operator-guide/logsight-integration/#configure-fluentbit-for-sending-log-data","title":"Configure FluentBit for Sending Log Data","text":"<p>Logsight is integrated with the EDP logging stack. The integration is based on top of the EFK (ElasticSearch-FluentBit-Kibana) stack. It is necessary to deploy a stack with the security support, namely, enable the certificate support.</p> <p>A FluentBit config indicates the namespace from which the logs will be received for further analysis. Below is an example of the FluentBit config for getting logs from the <code>edp-delivery-edp-delivery-sit</code> namespace:</p> View: fluent-bit.conf <pre><code>[INPUT]\nName              tail\nTag               kube.sit.*\nPath              /var/log/containers/*edp-delivery-edp-delivery-sit*.log\nParser            docker\nMem_Buf_Limit     5MB\nSkip_Long_Lines   Off\nRefresh_Interval  10\n\n[FILTER]\nName                kubernetes\nMatch               kube.sit.*\nKube_URL            https://kubernetes.default.svc:443\nKube_CA_File        /var/run/secrets/kubernetes.io/serviceaccount/ca.crt\nKube_Token_File     /var/run/secrets/kubernetes.io/serviceaccount/token\nKube_Tag_Prefix     kube.sit.var.log.containers.\nMerge_Log           Off\nK8S-Logging.Parser  On\nK8S-Logging.Exclude On\n\n[FILTER]\nName nest\nMatch kube.sit.*\nOperation lift\nNested_under kubernetes\nAdd_prefix kubernetes.\n\n[FILTER]\nName modify\nMatch kube.sit.*\nCopy kubernetes.container_name tags.container\nCopy log message\nCopy kubernetes.container_image tags.image\nCopy kubernetes.namespace_name tags.namespace\n\n[FILTER]\nName nest\nMatch kube.sit.*\nOperation nest\nWildcard kubernetes.*\nNested_under kubernetes\nRemove_prefix kubernetes.\n\n[OUTPUT]\nName            es\nMatch           kube.sit.*\nHost            elasticsearch-master\nPort            9200\nHTTP_User elastic\nHTTP_Passwd *****\nLogstash_Format On\nLogstash_Prefix sit\nTime_Key        @timestamp\nType            flb_type\nReplace_Dots    On\nRetry_Limit     False\n\n[OUTPUT]\nMatch kube.sit.*\nName  http\nHost logsight-backend\nPort 8080\nhttp_User logsight@example.com\nhttp_Passwd *****\nuri /api/v1/logs/singles\nFormat json\njson_date_format iso8601\njson_date_key timestamp\n</code></pre>"},{"location":"operator-guide/logsight-integration/#deployment-risk-analysis","title":"Deployment Risk Analysis","text":"<p>A <code>deployment-risk</code> stage is added to the EDP CD pipeline.</p> <p> Deployment Risk </p> <p>If the deployment risk is above 70%, the red state of the pipeline is expected.</p> <p>EDP consists of a set of containerized components. For the convenience of tracking the risk deployment trend for each component, this data is stored as Jenkins artifacts.</p> <p>If the deployment risk is higher than the threshold of 70%, the EDP promotion of artifacts for the next environments does not pass. The deployment risk report can be analyzed in order to avoid the potential problems with updating the components.</p> <p>To study the report in detail, use the link from the Jenkins pipeline to the Logsight verification screen:</p> <p> Logsight Insights Logsight Insights </p> <p>In this example, logs from different versions of the <code>gerrit-operator</code> were analyzed. As can be seen from the report, a large number of new messages appeared in the logs, and the output frequency of other notifications has also changed, which led to the high deployment risk.</p> <p>The environment on which the analysis is performed can exist for different time periods. Logsight only processes the minimum total number of logs since the creating of the environment.</p>"},{"location":"operator-guide/logsight-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CD Pipeline</li> <li>Adjust Jira Integration</li> </ul>"},{"location":"operator-guide/loki-irsa/","title":"IAM Roles for Loki Service Accounts","text":"<p>Note</p> <p>Make sure that IRSA is enabled and amazon-eks-pod-identity-webhook is deployed according to the Associate IAM Roles With Service Accounts documentation.</p> <p>It is possible to use Amazon Simple Storage Service Amazon S3 as object storage for Loki. In this case Loki requires access to AWS resources. Follow the steps below to create a required role:</p> <ol> <li> <p>Create AWS IAM Policy \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki_policy\":</p> <pre><code>{\n    \"Version\": \"2012-10-17\",\n    \"Statement\": [\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"s3:ListObjects\",\n                \"s3:ListBucket\",\n                \"s3:PutObject\",\n                \"s3:GetObject\",\n                \"s3:DeleteObject\"\n            ],\n            \"Resource\": [\n                \"arn:aws:s3:::loki-*\"\n            ]\n        },\n        {\n            \"Effect\": \"Allow\",\n            \"Action\": [\n                \"s3:ListBucket\"\n            ],\n            \"Resource\": [\n                \"arn:aws:s3:::loki-*\"\n            ]\n        }\n    ]\n}\n</code></pre> </li> <li> <p>Create AWS IAM Role \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\" with trust relationships:</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:&lt;LOKI_NAMESPACE&gt;:edp-loki\"\n       }\n     }\n   }\n ]\n}\n</code></pre> </li> <li> <p>Attach the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki_policy\" policy to the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\" role.</p> </li> <li> <p>Make sure that Amazon S3 bucket with name loki-\u2039CLUSTER_NAME\u203a exists.</p> </li> <li> <p>Provide key value eks.amazonaws.com/role-arn: \"arn:aws:iam:::role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039LOKI_NAMESPACE\u203aLoki\" into the serviceAccount.annotations parameter in values.yaml during the Loki Installation."},{"location":"operator-guide/loki-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Associate IAM Roles With Service Accounts</li> <li>Install Grafana Loki</li> </ul>"},{"location":"operator-guide/manage-custom-certificate/","title":"Manage Custom Certificates","text":"<p>Familiarize yourself with the detailed instructions on adding certificates to EDP resources as well as with the respective setup for Keycloak.</p> <p>EDP components that support custom certificates can be found in the table below:</p> Helm Chart Sub Resources admin-console-operator admin-console gerrit-operator edp-gerrit jenkins-operator jenkins-operator, edp-jenkins, jenkins agents sonar-operator sonar-operator, edp-sonar keycloak-operator keycloak-operator nexus-operator oauth2-proxy edp-install oauth2-proxy edp-headlamp edp-headlamp"},{"location":"operator-guide/manage-custom-certificate/#prerequisites","title":"Prerequisites","text":"<ul> <li>The certificate in the <code>*.crt</code> format is used;</li> <li>Kubectl version 1.23.0 is installed;</li> <li>Helm version 3.10.2 is installed;</li> <li>Java with the <code>keytool</code> command inside;</li> <li>jq is installed.</li> </ul>"},{"location":"operator-guide/manage-custom-certificate/#enable-the-spi-truststore-of-keycloak","title":"Enable the SPI Truststore of Keycloak","text":"<p>To import custom certificates to Keycloak, follow the steps below:</p> <ol> <li> <p>Generate the <code>cacerts</code> local keystore and import the certificate there using the keytool tool:</p> <pre><code>keytool -importcert -file CA.crt \\\n-alias CA.crt -keystore ./cacerts \\\n-storepass changeit -trustcacerts \\\n-noprompt\n</code></pre> </li> <li> <p>Create the <code>custom-keycloak-keystore</code> keystore secret from the <code>cacerts</code> file in the <code>security</code> namespace:</p> <pre><code>kubectl -n security create secret generic custom-keycloak-keystore \\\n--from-file=./cacerts\n</code></pre> </li> <li> <p>Create the <code>spi-truststore-data</code> SPI truststore secret in the <code>security</code> namespace:</p> <pre><code>kubectl -n security create secret generic spi-truststore-data \\\n--from-literal=KC_SPI_TRUSTSTORE_FILE_FILE=/opt/keycloak/spi-certs/cacerts \\\n--from-literal=KC_SPI_TRUSTSTORE_FILE_PASSWORD=changeit\n</code></pre> </li> <li> <p>Update the Keycloak <code>values.yaml</code> file from the Install Keycloak page.</p> View: values.yaml <pre><code>...\nextraVolumeMounts: |\n...\n# Use the Keycloak truststore for SPI connection over HTTPS/TLS\n- name: spi-certificates\nmountPath: /opt/keycloak/spi-certs\nreadOnly: true\n...\n\nextraVolumes: |\n...\n# Use the Keycloak truststore for SPI connection over HTTPS/TLS\n- name: spi-certificates\nsecret:\nsecretName: custom-keycloak-keystore\ndefaultMode: 420\n...\n\n...\nextraEnvFrom: |\n- secretRef:\nname: spi-truststore-data\n...\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-custom-certificate/#enable-custom-certificates-in-edp-components","title":"Enable Custom Certificates in EDP Components","text":"<p>Creating custom certificates is a necessary but not sufficient condition for applying, therefore, certificates should be enabled as well.</p> <ol> <li> <p>Create the <code>custom-ca-certificates</code> secret in the EDP namespace.</p> <pre><code>kubectl -n edp create secret generic custom-ca-certificates \\\n--from-file=CA.crt\n</code></pre> </li> <li> <p>Add the certificate by mounting the <code>custom-ca-certificates</code> secret to the operator pod as a volume.</p> <p>Example of specifying custom certificates for the <code>keycloak-operator</code>:</p> <pre><code>...\nkeycloak-operator:\nenabled: true\n\n# -- Additional volumes to be added to the pod\nextraVolumes:\n- name: custom-ca\nsecret:\ndefaultMode: 420\nsecretName: custom-ca-certificates\n\n# -- Additional volumeMounts to be added to the container\nextraVolumeMounts:\n- name: custom-ca\nmountPath: /etc/ssl/certs/CA.crt\nreadOnly: true\nsubPath: CA.crt\n...\n</code></pre> </li> <li> <p>For Sonar, Jenkins and Gerrit, change the flag in the <code>caCerts.enabled</code> field to <code>true</code>. Also, change the name of the secret in the <code>caCerts.secret</code> field to <code>custom-ca-certificates</code>.</p> <p>Example of specifying custom certificates for <code>Gerrit</code> via the <code>gerrit-operator</code> helm chart values:</p> <pre><code>...\ngerrit-operator:\nenabled: true\ngerrit:\ncaCerts:\n# -- Flag for enabling additional CA certificates\nenabled: true\n# -- Change init CA certificates container image\nimage: adoptopenjdk/openjdk11:alpine\n# -- Name of the secret containing additional CA certificates\nsecret: custom-ca-certificates\n...\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-custom-certificate/#integrate-custom-certificates-into-jenkins-agents","title":"Integrate Custom Certificates Into Jenkins Agents","text":"<p>This section describes how to add custom certificates to Jenkins agents to use them from Java applications.</p> <p>Info</p> <p>For example, <code>curl</code> doesn't use keystore files specified in this part of the documentation.</p> <p>EDP Jenkins agents keep keystore files in two places:</p> <ul> <li><code>/etc/ssl/certs/java</code> folder with the <code>cacerts</code> file;</li> <li><code>/opt/java/openjdk/lib/security</code> folder with the <code>blocked.certs</code>, <code>cacerts</code>, <code>default.policy</code> and <code>public_suffix_list.dat</code> files.</li> </ul> <ol> <li> <p>Copy the files in <code>/etc/ssl/certs/java</code> and <code>/opt/java/openjdk/lib/security</code> directories from Jenkins agent pod to the local <code>tmp</code> folder. There is a <code>copy_certs.sh</code> script below that can manage this. It copies the files in <code>/etc/ssl/certs/java</code> and <code>/opt/java/openjdk/lib/security</code> directories from Jenkins agent pod to the local <code>tmp</code> folder and imports the custom certificate into the keystore files, after which it creates the  <code>jenkins-agent-opt-java-openjdk-lib-security-cacerts</code> and <code>jenkins-agent-etc-ssl-certs-java-cacerts</code> secrets from updated keystore files in EDP namespace. Also, the <code>jenkins-agent-opt-java-openjdk-lib-security-cacerts</code> secret contains three additional files: <code>blocked.certs</code>, <code>default.policy</code> and <code>public_suffix_list.dat</code> which managed by the <code>copy_certs.sh</code> script as well. Expand the drop-down button below to see the contents of the <code>copy_certs.sh</code> script.</p> View: copy_certs.sh <pre><code># Fill in the variables `ns` and `ca_file`\nns=\"edp-project\"\nca_file=\"/tmp/CA.crt\"\n\nimages=$(kubectl get -n \"${ns}\" cm jenkins-slaves -ojson | jq -r \".data[]\" | grep image\\&gt; | sed 's/\\s*&lt;.*&gt;\\(.*\\)&lt;.*&gt;/\\1/')\n\nimage=$(for i in ${images[@]}; do echo $i; done | grep maven-java8)\npod_name=$(echo \"${image}\" | tr '.:/' '-')\n\noverrides=\"{\\\"apiVersion\\\":\\\"v1\\\",\\\"kind\\\":\\\"Pod\\\",\\\"metadata\\\":{\\\"name\\\":\\\"${pod_name}\\\", \\\"namespace\\\": \\\"${ns}\\\"},\n\\\"spec\\\":{\\\"containers\\\":[{\\\"name\\\":\\\"${pod_name}\\\",\\\"image\\\":\\\"${image}\\\",\n\\\"command\\\":[\\\"sh\\\",\\\"-c\\\",\\\"while true;do sleep 30;done;\\\"]}]}}\"\n\nkubectl run -n \"${ns}\" \"${pod_name}\" --image \"${image}\" --overrides=\"${overrides}\"\n\nkubectl wait --for=condition=ready pod \"${pod_name}\" -n \"${ns}\"\n\ncacerts_location=$(kubectl exec -n \"${ns}\" \"${pod_name}\" \\\n-- find / -name cacerts -exec ls -la \"{}\" \\; 2&gt;/dev/null | grep -v ^l | awk '{print $9}')\n\nfor cacerts in ${cacerts_location[@]}; do echo $(dirname \"${cacerts}\"); kubectl exec -n \"${ns}\" \"${pod_name}\" -- ls $(dirname \"${cacerts}\"); done\n\nfor cacerts in ${cacerts_location[@]}; do \\\necho $(dirname \"${cacerts}\"); \\\nmkdir -p \"/tmp$(dirname \"${cacerts}\")\"; \\\nfrom_files=''; \\\nfor file in $(kubectl exec -n \"${ns}\" \"${pod_name}\" -- ls $(dirname \"${cacerts}\")); do \\\nkubectl exec -n \"${ns}\" \"${pod_name}\" -- cat \"$(dirname \"${cacerts}\")/${file}\" &gt; \"/tmp$(dirname \"${cacerts}\")/${file}\"; \\\nfrom_files=\"${from_files} --from-file=/tmp$(dirname \"${cacerts}\")/${file}\"\ndone ; \\\nkeytool -import -storepass changeit -alias kubernetes -file ${ca_file} -noprompt -keystore \"/tmp${cacerts}\"; \\\nkubectl -n \"${ns}\" create secret generic \"jenkins-agent${cacerts//\\//-}\" $from_files \\\ndone\n\nkubectl delete -n \"${ns}\" pod \"${pod_name}\" --force --grace-period=0\n</code></pre> <p>Before using the <code>copy_certs.sh</code> script, keep in mind the following:</p> <ul> <li>assign actual values to the variables <code>ns</code> and <code>ca_file</code>;</li> <li>the script collects all the images from the <code>jenkins-slaves</code> ConfigMap and uses the image of   the <code>maven-java8</code> agent as the base image of the temporary pod to get the keystore files;</li> <li>custom certificate is imported using the <code>keytool</code> application;</li> <li>the <code>jenkins-agent-opt-java-openjdk-lib-security-cacerts</code> and <code>jenkins-agent-etc-ssl-certs-java-cacerts</code> secrets will be created   in the EDP namespace.</li> </ul> </li> <li> <p>Run the <code>copy_certs.sh</code> script from the previous point after the requirements are met.</p> </li> <li> <p>Update manually the <code>jenkins-slaves</code> ConfigMap.</p> <p>Add this block with the mount of secrets to the <code>&lt;volumes&gt;&lt;/volumes&gt;</code> block of each Jenkins agent:</p> <pre><code>...\n        &lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/etc/ssl/certs/java&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-etc-ssl-certs-java-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/opt/java/openjdk/lib/security&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-opt-java-openjdk-lib-security-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n...\n</code></pre> <p>As an example, the template of <code>gradle-java11-template</code> is shown below:</p> <pre><code>...\n      &lt;/workspaceVolume&gt;\n&lt;volumes&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/etc/ssl/certs/java&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-etc-ssl-certs-java-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;mountPath&gt;/opt/java/openjdk/lib/security&lt;/mountPath&gt;\n&lt;secretName&gt;jenkins-agent-opt-java-openjdk-lib-security-cacerts&lt;/secretName&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.volumes.SecretVolume&gt;\n&lt;/volumes&gt;\n&lt;containers&gt;\n...\n</code></pre> </li> <li> <p>Reload the Jenkins pod:</p> <pre><code>ns=\"edp\"\nkubectl rollout restart -n \"${ns}\" deployment/jenkins\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-custom-certificate/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Keycloak</li> </ul>"},{"location":"operator-guide/manage-jenkins-cd-job-provision/","title":"Manage Jenkins CD Pipeline Job Provisioner","text":"<p>The Jenkins CD job provisioner (or seed-job) is used to create and manage the cd-pipeline folder, and its Deploy pipelines. There is a special job-provisions/cd folder in Jenkins for these provisioners. Explore the steps for managing different provisioner types below.</p>"},{"location":"operator-guide/manage-jenkins-cd-job-provision/#default","title":"Default","text":"<p>During the EDP deployment, a default provisioner is created to deploy application with container and custom deployment type.</p> <ol> <li> <p>Find the configuration in job-provisions/cd/default.</p> </li> <li> <p>Default template is presented below:</p> View: Default template <pre><code>/* Copyright 2022 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\n\ndef pipelineName = \"${PIPELINE_NAME}-cd-pipeline\"\ndef stageName = \"${STAGE_NAME}\"\ndef qgStages = \"${QG_STAGES}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID}\"\ndef sourceType = \"${SOURCE_TYPE}\"\ndef libraryURL = \"${LIBRARY_URL}\"\ndef libraryBranch = \"${LIBRARY_BRANCH}\"\ndef isAutoDeploy = \"${AUTODEPLOY}\"\ndef scriptPath = \"Jenkinsfile\"\ndef containerDeploymentType = \"container\"\ndef deploymentType = \"${DEPLOYMENT_TYPE}\"\ndef codebaseFolder = jenkins.getItem(pipelineName)\n\ndef autoDeploy = '{\"name\":\"auto-deploy-input\",\"step_name\":\"auto-deploy-input\"}'\ndef manualDeploy = '{\"name\":\"manual-deploy-input\",\"step_name\":\"manual-deploy-input\"}'\ndef runType = isAutoDeploy.toBoolean() ? autoDeploy : manualDeploy\n\ndef stages = buildStages(deploymentType, containerDeploymentType, qgStages, runType)\n\nif (codebaseFolder == null) {\nfolder(pipelineName)\n}\n\nif (deploymentType == containerDeploymentType) {\ncreateContainerizedCdPipeline(pipelineName, stageName, stages, scriptPath, sourceType,\nlibraryURL, libraryBranch, gitCredentialsId, gitServerCrVersion,\nisAutoDeploy)\n} else {\ncreateCustomCdPipeline(pipelineName, stageName)\n}\n\ndef buildStages(deploymentType, containerDeploymentType, qgStages, runType) {\nreturn deploymentType == containerDeploymentType\n? '[{\"name\":\"init\",\"step_name\":\"init\"},' + runType + ',{\"name\":\"deploy\",\"step_name\":\"deploy\"},' + qgStages + ',{\"name\":\"promote-images\",\"step_name\":\"promote-images\"}]'\n: ''\n}\n\ndef createContainerizedCdPipeline(pipelineName, stageName, stages, pipelineScript, sourceType, libraryURL, libraryBranch, libraryCredId, gitServerCrVersion, isAutoDeploy) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nif (sourceType == \"library\") {\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(libraryURL)\ncredentials(libraryCredId)\n}\nbranches(\"${libraryBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\n}\n}\n} else {\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\nDeploy()\")\nsandbox(true)\n}\n}\n}\nproperties {\ndisableConcurrentBuilds()\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${stages}\", \"Consequence of stages in JSON format to be run during execution\")\n\nif (isAutoDeploy?.trim() &amp;&amp; isAutoDeploy.toBoolean()) {\nstringParam(\"CODEBASE_VERSION\", null, \"Codebase versions to deploy.\")\n}\n}\n}\n}\n\ndef createCustomCdPipeline(pipelineName, stageName) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nproperties {\ndisableConcurrentBuilds()\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\n}\n}\n}\n</code></pre> </li> </ol>"},{"location":"operator-guide/manage-jenkins-cd-job-provision/#custom","title":"Custom","text":"<p>In some cases, it is necessary to modify or update the job provisioner logic. For example, when adding a new stage requires a custom job provisioner created on the basis of an existing one out of the box. Take the steps below to add a custom job provision.</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/cd folder, click New Item and type the name of job provisions, for example - custom.</p> <p> CD provisioner name </p> <p>Scroll down to the Copy from field, enter \"/job-provisions/cd/default\", and click OK:   Copy CD provisioner </p> </li> <li> <p>Update the required parameters in the new provisioner. For example, if it is necessary to implement a new stage clean, add the following code to the provisioner:</p> <pre><code>   def buildStages(deploymentType, containerDeploymentType, qgStages) {\n       return deploymentType == containerDeploymentType\n? '[{\"name\":\"init\",\"step_name\":\"init\"},{\"name\":\"clean\",\"step_name\":\"clean\"},{\"name\":\"deploy\",\"step_name\":\"deploy\"},' + qgStages + ',{\"name\":\"promote-images-ecr\",\"step_name\":\"promote-images\"}]'\n: ''\n}\n</code></pre> <p>Note</p> <p>Make sure the support for the above mentioned logic is implemented. Please refer to the How to Redefine or Extend the EDP Pipeline Stages Library section of the guide.</p> <p>After the steps above are performed, the new custom job-provision will be available in Adding Stage during the CD pipeline creation in Admin Console.</p> <p> Custom CD provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/","title":"Manage Jenkins CI Pipeline Job Provisioner","text":"<p>The Jenkins CI job provisioner (or seed-job) is used to create and manage the application folder, and its Code Review, Build and Create Release pipelines. Depending on the version control system, different job provisioners are used. EDP supports integration with the following version control systems:</p> <ul> <li>Gerrit (default)</li> <li>GitHub (github)</li> <li>GitLab (gitlab)</li> </ul> <p>By default, the Jenkins operator creates a pipeline for several types of application and libraries. There is a special job-provisions/ci folder in Jenkins for these provisioners. During the EDP deployment, a default provisioner is created for integration with Gerrit version control system. To configure integration with other version control systems, you need to add the required job provisioners to job-provisions/ci folder in Jenkins.</p>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#create-custom-provisioner-custom-defaultgithubgitlab","title":"Create Custom Provisioner (custom-default/github/gitlab)","text":"<p>In some cases it is necessary to modify or update the job provisioner logic, for example when an added other code language needs to create a custom job provisioner on the basis of an existing one out of the box. Take the steps below to add a custom job provision:</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/ci folder, click New Item and type the name of job-provisions, for example - custom-github.</p> <p> CI provisioner name </p> <p>Scroll down to the Copy from field and enter \"/job-provisions/ci/github\", and click OK:   Copy ci provisioner </p> </li> <li> <p>Update the required parameters in the new provisioner. For example, if it is necessary to implement a new build tool docker, several parameters are to be updated. Add the following stages to the docker Code Review and Build pipelines for docker application:</p> <pre><code>stages['Code-review-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"lint\"},{\"name\": \"build\"}]'\n...\nstages['Build-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"lint\"},{\"name\": \"build\"},{\"name\": \"push\"},{\"name\": \"git-tag\"}]'\n...\ndef getStageKeyName(buildTool) {\n    ...\n    if (buildTool.toString().equalsIgnoreCase('docker')) {\n    return \"Code-review-application-docker\"\n}\n    ...\n}\n</code></pre> <p>Note</p> <p>Make sure the support for the above mentioned logic is implemented. Please refer to the How to Redefine or Extend the EDP Pipeline Stages Library section of the guide.</p> <p>Note</p> <p>The default template should be changed if there is another creation logic for the Code Review, Build and Create Release pipelines. Furthermore, all pipeline types should have the necessary stages as well.</p> <p>After the steps above are performed, the new custom job provision will be available in Advanced Settings during the application creation in the EDP Portal UI:</p> <p> Custom ci provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#gerrit-default","title":"Gerrit (default)","text":"<p>During the EDP deployment, a default provisioner is created for integration with Gerrit version control system.</p> <ol> <li> <p>Find the configuration in job-provisions/ci/default.</p> </li> <li> <p>Default template is presented below:</p> View: Default template <pre><code>/* Copyright 2022 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef platformType = \"${PLATFORM_TYPE}\"\ndef buildStage = platformType.toString() == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"}' : ',{\"name\": \"build-image-from-dockerfile\"}'\ndef buildTool = \"${BUILD_TOOL}\"\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + ']'\nstages['Code-review-default'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\nstages['Code-review-library-kaniko'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"dockerbuild-verify\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-autotests-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-autotests-gradle'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"tests\"}' +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' +\n\"${buildStage}\" + ',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef defaultBuild = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef repositoryPath = \"${REPOSITORY_PATH}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\nfolder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"CreateRelease\",\nrepositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch)\n\nif (buildTool.toString().equalsIgnoreCase('none')) {\nreturn true\n}\n\nif (BRANCH) {\ndef branch = \"${BRANCH}\"\ndef formattedBranch = \"${branch.toUpperCase().replaceAll(/\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef crKey = getStageKeyName(buildTool)\ncreateCiPipeline(\"Code-review-${codebaseName}\", codebaseName, stages[crKey], \"CodeReview\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library') || type.equalsIgnoreCase('autotests')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name})\njobExists = true\n\ncreateCiPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultBuild), \"Build\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\nif(!jobExists)\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n\ndef createCiPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, watchBranch, gitServerCrName, gitServerCrVersion) {\npipelineJob(\"${codebaseName}/${watchBranch.toUpperCase().replaceAll(/\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ntriggers {\ngerrit {\nevents {\nif (pipelineName.contains(\"Build\"))\nchangeMerged()\nelse\npatchsetCreated()\n}\nproject(\"plain:${codebaseName}\", [\"plain:${watchBranch}\"])\n}\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nstringParam(\"BRANCH\", \"${watchBranch}\", \"Branch to build artifact from\")\n}\n}\n}\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\nif (buildTool.toString().equalsIgnoreCase('kaniko')) {\nreturn \"Code-review-library-kaniko\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"PLATFORM_TYPE\", \"${platformType}\", \"Platform type\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, DEFAULT_BRANCH will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n</code></pre> <p>Job Provision Pipeline Parameters</p> <p>The job-provisions pipeline consists of the following parameters of type string:</p> </li> </ol> <ul> <li>NAME - the application name;</li> </ul> <ul> <li>TYPE - the codebase type (the application / library / autotest);</li> </ul> <ul> <li>BUILD_TOOL - a tool that is used to build the application;</li> </ul> <ul> <li>BRANCH - a branch name;</li> </ul> <ul> <li>GIT_SERVER_CR_NAME - the name of the application Git server custom resource;</li> </ul> <ul> <li>GIT_SERVER_CR_VERSION - the version of the application Git server custom resource;</li> </ul> <ul> <li>GIT_CREDENTIALS_ID - the secret name where Git server credentials are stored (default 'gerrit-ciuser-sshkey');</li> </ul> <ul> <li>REPOSITORY_PATH - the full repository path;</li> </ul> <ul> <li>JIRA_INTEGRATION_ENABLED - the Jira integration is enabled or not;</li> </ul> <ul> <li>PLATFORM_TYPE - the type of platform (kubernetes or openshift);</li> </ul> <ul> <li>DEFAULT_BRANCH - the default repository branch.</li> </ul>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#github-github","title":"GitHub (github)","text":"<p>To create a new job provision for work with GitHub, take the following steps:</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/ci folder.</p> </li> <li> <p>Click New Item and type the name of job-provisions - github.</p> </li> <li> <p>Select the Freestyle project option and click OK.</p> </li> <li> <p>Select the Discard old builds check box and configure a few parameters:</p> <p>Strategy: Log Rotation</p> <p>Days to keep builds: 10</p> <p>Max # of builds to keep: 10</p> </li> <li> <p>Select the This project is parameterized check box and add a few input parameters (the type of the variables is string):</p> <ul> <li>NAME;</li> </ul> <ul> <li>TYPE;</li> </ul> <ul> <li>BUILD_TOOL;</li> </ul> <ul> <li>BRANCH;</li> </ul> <ul> <li>GIT_SERVER_CR_NAME;</li> </ul> <ul> <li>GIT_SERVER_CR_VERSION;</li> </ul> <ul> <li>GIT_CREDENTIALS_ID;</li> </ul> <ul> <li>REPOSITORY_PATH;</li> </ul> <ul> <li>JIRA_INTEGRATION_ENABLED;</li> </ul> <ul> <li>PLATFORM_TYPE;</li> </ul> <ul> <li>DEFAULT_BRANCH.</li> </ul> </li> <li> <p>Check the Execute concurrent builds if necessary option.</p> </li> <li> <p>Check the Restrict where this project can be run option.</p> </li> <li> <p>Fill in the Label Expression field by typing master to ensure job runs on Jenkins Master.</p> </li> <li> <p>In the Build section, perform the following:</p> <ul> <li>Select DSL Script;</li> </ul> <ul> <li>Select the Use the provided DSL script check box:</li> </ul> <p> DSL script check box </p> </li> <li> <p>As soon as all the steps above are performed, insert the code:</p> View: Template <pre><code>import groovy.json.*\nimport jenkins.model.Jenkins\nimport javaposse.jobdsl.plugin.*\nimport com.cloudbees.hudson.plugins.folder.*\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef platformType = \"${PLATFORM_TYPE}\"\ndef buildStage = platformType == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"}' : ',{\"name\": \"build-image-from-dockerfile\"}'\ndef buildTool = \"${BUILD_TOOL}\"\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},' +\n'{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + ']'\nstages['Code-review-default'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\nstages['Code-review-library-kaniko'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"dockerbuild-verify\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-autotests-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-autotests-gradle'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${buildStage}\" +\n',{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build\"}' + \"${buildStage}\" + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},{\"name\": \"tests\"},{\"name\": \"sonar\"}' +\n\"${buildStage}\" + ',{\"name\":\"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef defaultStages = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef repositoryPath = \"${REPOSITORY_PATH.replaceAll(~/:\\d+\\\\//,\"/\")}\"\ndef githubRepository = \"https://${repositoryPath.split(\"@\")[1]}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\n    folder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"CreateRelease\",\n        repositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch)\n\nif (buildTool.toString().equalsIgnoreCase('none')) {\n    return true\n}\n\nif (BRANCH) {\n    def branch = \"${BRANCH}\"\n    def formattedBranch = \"${branch.toUpperCase().replaceAll(/\\\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\ndef crKey = getStageKeyName(buildTool).toString()\ncreateCodeReviewPipeline(\"Code-review-${codebaseName}\", codebaseName, stages.get(crKey, defaultStages), \"CodeReview\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion, githubRepository)\nregisterWebHook(repositoryPath)\n\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\n\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library') || type.equalsIgnoreCase('autotests')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name})\njobExists = true\ncreateBuildPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultStages), \"Build\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion, githubRepository)\nregisterWebHook(repositoryPath, 'build')\n\nif(!jobExists)\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\nif (buildTool.toString().equalsIgnoreCase('kaniko')) {\nreturn \"Code-review-library-kaniko\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createCodeReviewPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, defaultBranch, gitServerCrName, gitServerCrVersion, githubRepository) {\npipelineJob(\"${codebaseName}/${defaultBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nif (pipelineName.contains(\"Build\"))\nstringParam(\"BRANCH\", \"${defaultBranch}\", \"Branch to build artifact from\")\nelse\nstringParam(\"BRANCH\", \"\\${ghprbActualCommit}\", \"Branch to build artifact from\")\n}\n}\ntriggers {\ngithubPullRequest {\ncron('')\nonlyTriggerPhrase(false)\nuseGitHubHooks(true)\npermitAll(true)\nautoCloseFailedPullRequests(false)\ndisplayBuildErrorsOnDownstreamBuilds(false)\nwhiteListTargetBranches([defaultBranch.toString()])\nextensions {\ncommitStatus {\ncontext('Jenkins Code-Review')\ntriggeredStatus('Build is Triggered')\nstartedStatus('Build is Started')\naddTestResults(true)\ncompletedStatus('SUCCESS', 'Verified')\ncompletedStatus('FAILURE', 'Failed')\ncompletedStatus('PENDING', 'Penging')\ncompletedStatus('ERROR', 'Error')\n}\n}\n}\n}\nproperties {\ngithubProjectProperty {\nprojectUrlStr(\"${githubRepository}\")\n}\n}\n}\n}\n\ndef createBuildPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, defaultBranch, gitServerCrName, gitServerCrVersion, githubRepository) {\npipelineJob(\"${codebaseName}/${defaultBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\nnode {\\n    git credentialsId: \\'${credId}\\', url: \\'${repository}\\', branch: \\'${BRANCH}\\'\\n}\\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nstringParam(\"BRANCH\", \"${defaultBranch}\", \"Branch to run from\")\n}\n}\ntriggers {\ngitHubPushTrigger()\n}\nproperties {\ngithubProjectProperty {\nprojectUrlStr(\"${githubRepository}\")\n}\n}\n}\n}\n\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"PLATFORM_TYPE\", \"${platformType}\", \"Platform type\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, DEFAULT_BRANCH will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n\ndef registerWebHook(repositoryPath, type = 'code-review') {\ndef url = repositoryPath.split('@')[1].split('/')[0]\ndef owner = repositoryPath.split('@')[1].split('/')[1]\ndef repo = repositoryPath.split('@')[1].split('/')[2]\ndef apiUrl = 'https://api.' + url + '/repos/' + owner + '/' + repo + '/hooks'\ndef webhookUrl = ''\ndef webhookConfig = [:]\ndef config = [:]\ndef events = []\n\nif (type.equalsIgnoreCase('build')) {\nwebhookUrl = System.getenv('JENKINS_UI_URL') + \"/github-webhook/\"\nevents = [\"push\"]\nconfig[\"url\"] = webhookUrl\nconfig[\"content_type\"] = \"json\"\nconfig[\"insecure_ssl\"] = 0\nwebhookConfig[\"name\"] = \"web\"\nwebhookConfig[\"config\"] = config\nwebhookConfig[\"events\"] = events\nwebhookConfig[\"active\"] = true\n\n} else {\nwebhookUrl = System.getenv('JENKINS_UI_URL') + \"/ghprbhook/\"\nevents = [\"issue_comment\",\"pull_request\"]\nconfig[\"url\"] = webhookUrl\nconfig[\"content_type\"] = \"form\"\nconfig[\"insecure_ssl\"] = 0\nwebhookConfig[\"name\"] = \"web\"\nwebhookConfig[\"config\"] = config\nwebhookConfig[\"events\"] = events\nwebhookConfig[\"active\"] = true\n}\n\ndef requestBody = JsonOutput.toJson(webhookConfig)\ndef http = new URL(apiUrl).openConnection() as HttpURLConnection\nhttp.setRequestMethod('POST')\nhttp.setDoOutput(true)\nprintln(apiUrl)\nhttp.setRequestProperty(\"Accept\", 'application/json')\nhttp.setRequestProperty(\"Content-Type\", 'application/json')\nhttp.setRequestProperty(\"Authorization\", \"token ${getSecretValue('github-access-token')}\")\nhttp.outputStream.write(requestBody.getBytes(\"UTF-8\"))\nhttp.connect()\nprintln(http.responseCode)\n\nif (http.responseCode == 201) {\nresponse = new JsonSlurper().parseText(http.inputStream.getText('UTF-8'))\n} else {\nresponse = new JsonSlurper().parseText(http.errorStream.getText('UTF-8'))\n}\n\nprintln \"response: ${response}\"\n}\n\ndef getSecretValue(name) {\ndef creds = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(\ncom.cloudbees.plugins.credentials.common.StandardCredentials.class,\nJenkins.instance,\nnull,\nnull\n)\n\ndef secret = creds.find { it.properties['id'] == name }\nreturn secret != null ? secret['secret'] : null\n}\n</code></pre> <p>After the steps above are performed, the new custom job-provision will be available in Advanced Settings during the application creation in the EDP Portal UI:</p> <p> Github job provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#gitlab-gitlab","title":"GitLab (gitlab)","text":"<p>To create a new job provision for work with GitLab, take the following steps:</p> <ol> <li> <p>Navigate to the Jenkins main page and open the job-provisions/ci folder.</p> </li> <li> <p>Click New Item and type the name of job-provisions - gitlab.</p> </li> <li> <p>Select the Freestyle project option and click OK.</p> </li> <li> <p>Select the Discard old builds check box and configure a few parameters:</p> <p>Strategy: Log Rotation</p> <p>Days to keep builds: 10</p> <p>Max # of builds to keep: 10</p> </li> <li> <p>Select the This project is parameterized check box and add a few input parameters as the following strings (the type of the variables is string):</p> <ul> <li>NAME;</li> </ul> <ul> <li>TYPE;</li> </ul> <ul> <li>BUILD_TOOL;</li> </ul> <ul> <li>BRANCH;</li> </ul> <ul> <li>GIT_SERVER_CR_NAME;</li> </ul> <ul> <li>GIT_SERVER_CR_VERSION;</li> </ul> <ul> <li>GIT_SERVER;</li> </ul> <ul> <li>GIT_SSH_PORT;</li> </ul> <ul> <li>GIT_USERNAME;</li> </ul> <ul> <li>GIT_CREDENTIALS_ID;</li> </ul> <ul> <li>REPOSITORY_PATH;</li> </ul> <ul> <li>JIRA_INTEGRATION_ENABLED;</li> </ul> <ul> <li>PLATFORM_TYPE;</li> </ul> <ul> <li>DEFAULT_BRANCH;</li> </ul> </li> <li> <p>Check the Execute concurrent builds if necessary option.</p> </li> <li> <p>Check the Restrict where this project can be run option.</p> </li> <li> <p>Fill in the Label Expression field by typing master to ensure job runs on Jenkins Master.</p> </li> <li> <p>In the Build Steps section, perform the following:</p> <ul> <li>Select Add build step;</li> </ul> <ul> <li>Choose Process Job DSLs; </li> </ul> <ul> <li>Select the Use the provided DSL script check box:</li> </ul> <p> DSL script check box </p> </li> <li> <p>As soon as all the steps above are performed, insert the code:</p> View: Template <pre><code>import groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef platformType = \"${PLATFORM_TYPE}\"\ndef buildTool = \"${BUILD_TOOL}\"\ndef buildImageStage = platformType == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"},' : ',{\"name\": \"build-image-from-dockerfile\"},'\ndef goBuildImageStage = platformType == \"kubernetes\" ? ',{\"name\": \"build-image-kaniko\"}' : ',{\"name\": \"build-image-from-dockerfile\"}'\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},' +\n'{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + ']'\nstages['Code-review-default'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\nstages['Code-review-library-kaniko'] = '[{\"name\": \"checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"dockerbuild-verify\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-autotests-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-autotests-gradle'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildImageStage}\" +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},{\"name\": \"tests\"},{\"name\": \"sonar\"}' +\n\"${buildImageStage}\" + '{\"name\":\"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' + \"${buildImageStage}\" +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${buildImageStage}\" +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"tool-init\"},' +\n'{\"name\": \"lint\"},{\"name\": \"git-tag\"}]'\nstages['Build-application-helm'] = '[{\"name\": \"checkout\"},{\"name\": \"lint\"}]'\nstages['Build-application-docker'] = '[{\"name\": \"checkout\"},{\"name\": \"lint\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sast\"},{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build\"}' + \"${goBuildImageStage}\" + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef defaultStages = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitServer = \"${GIT_SERVER ? GIT_SERVER : 'gerrit'}\"\ndef gitSshPort = \"${GIT_SSH_PORT ? GIT_SSH_PORT : '29418'}\"\ndef gitUsername = \"${GIT_USERNAME ? GIT_USERNAME : 'jenkins'}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef defaultRepoPath = \"ssh://${gitUsername}@${gitServer}:${gitSshPort}/${codebaseName}\"\ndef repositoryPath = \"${REPOSITORY_PATH ? REPOSITORY_PATH : defaultRepoPath}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\nfolder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"CreateRelease\",\nrepositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch)\n\nif (BRANCH) {\ndef branch = \"${BRANCH}\"\ndef formattedBranch = \"${branch.toUpperCase().replaceAll(/\\\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef crKey = getStageKeyName(buildTool).toString()\ncreateCiPipeline(\"Code-review-${codebaseName}\", codebaseName, stages.get(crKey, defaultStages), \"CodeReview\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\n\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library') || type.equalsIgnoreCase('autotests')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name}) {\njobExists = true\n}\ncreateCiPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultStages), \"Build\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\nif(!jobExists) {\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n}\n\n\ndef createCiPipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId, defaultBranch, gitServerCrName, gitServerCrVersion) {\ndef jobName = \"${defaultBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\"\ndef existingJob = Jenkins.getInstance().getItemByFullName(\"${codebaseName}/${jobName}\")\ndef webhookToken = null\nif (existingJob) {\ndef triggersMap = existingJob.getTriggers()\ntriggersMap.each { key, value -&gt;\nwebhookToken = value.getSecretToken()\n}\n} else {\ndef random = new byte[16]\nnew java.security.SecureRandom().nextBytes(random)\nwebhookToken = random.encodeHex().toString()\n}\npipelineJob(\"${codebaseName}/${jobName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\nproperties {\ngitLabConnection {\ngitLabConnection('gitlab')\n}\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nif (pipelineName.contains(\"Build\"))\nstringParam(\"BRANCH\", \"${defaultBranch}\", \"Branch to build artifact from\")\nelse\nstringParam(\"BRANCH\", \"\\${gitlabMergeRequestLastCommit}\", \"Branch to build artifact from\")\n}\n}\ntriggers {\ngitlabPush {\nbuildOnMergeRequestEvents(pipelineName.contains(\"Build\") ? false : true)\nbuildOnPushEvents(pipelineName.contains(\"Build\") ? true : false)\nenableCiSkip(false)\nsetBuildDescription(true)\nrebuildOpenMergeRequest(pipelineName.contains(\"Build\") ? 'never' : 'source')\ncommentTrigger(\"Build it please\")\nskipWorkInProgressMergeRequest(true)\ntargetBranchRegex(\"${defaultBranch}\")\n}\n}\nconfigure {\nit / triggers / 'com.dabsquared.gitlabjenkins.GitLabPushTrigger' &lt;&lt; secretToken(webhookToken)\nit / triggers / 'com.dabsquared.gitlabjenkins.GitLabPushTrigger' &lt;&lt; triggerOnApprovedMergeRequest(pipelineName.contains(\"Build\") ? false : true)\nit / triggers / 'com.dabsquared.gitlabjenkins.GitLabPushTrigger' &lt;&lt; pendingBuildName(pipelineName.contains(\"Build\") ? \"\" : \"Jenkins\")\n}\n}\nregisterWebHook(repository, codebaseName, jobName, webhookToken)\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\nif (buildTool.toString().equalsIgnoreCase('kaniko')) {\nreturn \"Code-review-library-kaniko\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineType, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, platformType, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\n${pipelineType}()\")\nsandbox(true)\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"PLATFORM_TYPE\", \"${platformType}\", \"Platform type\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, DEFAULT_BRANCH will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n\ndef registerWebHook(repositoryPath, codebaseName, jobName, webhookToken) {\ndef apiUrl = 'https://' + repositoryPath.replaceAll(\"ssh://\", \"\").split('@')[1].replace('/', \"%2F\").replaceAll(~/:\\d+%2F/, '/api/v4/projects/') + '/hooks'\ndef jobWebhookUrl = \"${System.getenv('JENKINS_UI_URL')}/project/${codebaseName}/${jobName}\"\ndef gitlabToken = getSecretValue('gitlab-access-token')\n\nif (checkWebHookExist(apiUrl, jobWebhookUrl, gitlabToken)) {\nprintln(\"[JENKINS][DEBUG] Webhook for job ${jobName} is already exist\\r\\n\")\nreturn\n}\n\nprintln(\"[JENKINS][DEBUG] Creating webhook for job ${jobName}\")\ndef webhookConfig = [:]\nwebhookConfig[\"url\"] = jobWebhookUrl\nwebhookConfig[\"push_events\"] = jobName.contains(\"Build\") ? \"true\" : \"false\"\nwebhookConfig[\"merge_requests_events\"] = jobName.contains(\"Build\") ? \"false\" : \"true\"\nwebhookConfig[\"issues_events\"] = \"false\"\nwebhookConfig[\"confidential_issues_events\"] = \"false\"\nwebhookConfig[\"tag_push_events\"] = \"false\"\nwebhookConfig[\"note_events\"] = \"true\"\nwebhookConfig[\"job_events\"] = \"false\"\nwebhookConfig[\"pipeline_events\"] = \"false\"\nwebhookConfig[\"wiki_page_events\"] = \"false\"\nwebhookConfig[\"enable_ssl_verification\"] = \"true\"\nwebhookConfig[\"token\"] = webhookToken\ndef requestBody = JsonOutput.toJson(webhookConfig)\ndef httpConnector = new URL(apiUrl).openConnection() as HttpURLConnection\nhttpConnector.setRequestMethod('POST')\nhttpConnector.setDoOutput(true)\n\nhttpConnector.setRequestProperty(\"Accept\", 'application/json')\nhttpConnector.setRequestProperty(\"Content-Type\", 'application/json')\nhttpConnector.setRequestProperty(\"PRIVATE-TOKEN\", \"${gitlabToken}\")\nhttpConnector.outputStream.write(requestBody.getBytes(\"UTF-8\"))\nhttpConnector.connect()\n\nif (httpConnector.responseCode == 201)\nprintln(\"[JENKINS][DEBUG] Webhook for job ${jobName} has been created\\r\\n\")\nelse {\nprintln(\"[JENKINS][ERROR] Responce code - ${httpConnector.responseCode}\")\ndef response = new JsonSlurper().parseText(httpConnector.errorStream.getText('UTF-8'))\nprintln(\"[JENKINS][ERROR] Failed to create webhook for job ${jobName}. Response - ${response}\")\n}\n}\n\ndef checkWebHookExist(apiUrl, jobWebhookUrl, gitlabToken) {\nprintln(\"[JENKINS][DEBUG] Checking if webhook ${jobWebhookUrl} exists\")\ndef httpConnector = new URL(apiUrl).openConnection() as HttpURLConnection\nhttpConnector.setRequestMethod('GET')\nhttpConnector.setDoOutput(true)\n\nhttpConnector.setRequestProperty(\"Accept\", 'application/json')\nhttpConnector.setRequestProperty(\"Content-Type\", 'application/json')\nhttpConnector.setRequestProperty(\"PRIVATE-TOKEN\", \"${gitlabToken}\")\nhttpConnector.connect()\n\nif (httpConnector.responseCode == 200) {\ndef response = new JsonSlurper().parseText(httpConnector.inputStream.getText('UTF-8'))\nreturn response.find { it.url == jobWebhookUrl } ? true : false\n}\n}\n\ndef getSecretValue(name) {\ndef creds = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(\ncom.cloudbees.plugins.credentials.common.StandardCredentials.class,\nJenkins.instance,\nnull,\nnull\n)\n\ndef secret = creds.find { it.properties['id'] == name }\nreturn secret != null ? secret['secret'] : null\n}\n</code></pre> <p>After the steps above are performed, the new custom job-provision will be available in Advanced Settings during the application creation in the EDP Portal UI:</p> <p> Gitlab job provision </p> </li> </ol>"},{"location":"operator-guide/manage-jenkins-ci-job-provision/#related-articles","title":"Related Articles","text":"<ul> <li>CI Pipeline for Container</li> <li>GitLab Webhook Configuration</li> <li>GitHub Webhook Configuration</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> </ul>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/","title":"Migrate CI Pipelines From Jenkins to Tekton","text":"<p>To migrate the CI pipelines for a codebase from Jenkins to Tekton, follow the steps below:</p> <ul> <li>Migrate CI Pipelines From Jenkins to Tekton</li> <li>Deploy a Custom EDP Scenario With Tekton and Jenkins CI Tools</li> <li>Disable Jenkins Triggers</li> <li>Manage Tekton Triggers the Codebase(s)</li> <li>Switch CI Tool for Codebase(s)</li> </ul>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#deploy-a-custom-edp-scenario-with-tekton-and-jenkins-ci-tools","title":"Deploy a Custom EDP Scenario With Tekton and Jenkins CI Tools","text":"<p>Make sure that Tekton stack is deployed according to the documentation. Enable Tekton as an EDP subcomponent:</p> values.yaml<pre><code>edp-tekton:\nenabled: true\n</code></pre>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#disable-jenkins-triggers","title":"Disable Jenkins Triggers","text":"<p>To disable Jenkins Triggers for the codebase, add the following code to the provisioner:</p> job-provisioner<pre><code>def tektonCodebaseList = [\"&lt;codebase_name&gt;\"]\nif (!tektonCodebaseList.contains(codebaseName.toString())){\ntriggers {\ngerrit {\nevents {\nif (pipelineName.contains(\"Build\"))\nchangeMerged()\nelse\npatchsetCreated()\n}\nproject(\"plain:${codebaseName}\", [\"plain:${watchBranch}\"])\n}\n}\n}\n</code></pre> <p>Note</p> <p>The sample above shows the usage of Gerrit VCS where the <code>&lt;codebase_name&gt;</code> value is your codebase name.</p> <ul> <li>If using GitHub or GitLab, additionally remove the webhook from the relevant repository.</li> <li>If webhooks generation for new codebase(s) is not required, correct the code above so that it creates a webhook in the job-provisioner.</li> <li>To recreate the pipeline in Jenkins, trigger the job-provisioner.</li> <li>Check that the new pipeline is created without triggering Gerrit events.</li> </ul>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#manage-tekton-triggers-the-codebases","title":"Manage Tekton Triggers the Codebase(s)","text":"<p>By default, each Gerrit project inherits configuration from the All-Projects repository.</p> <p>To exclude triggering in Jenkins and Tekton CI tools simultaneously, edit the configuration in the All-Projects repository or in the project which inherits rights from your project.</p> <p>Edit the webhooks.config file in the refs/meta/config and remove all context from this configuration.</p> <p>Warning</p> <p>The clearance of the webhooks.config file will disable the pipeline trigger in Tekton.</p> <p>To use Tekton pipelines, add the configuration to the corresponding Gerrit project (webhooks.config file in the refs/meta/config):</p> webhooks.config<pre><code>[remote \"changemerged\"]\nurl = http://el-gerrit-listener:8080\nevent = change-merged\n[remote \"patchsetcreated\"]\nurl = http://el-gerrit-listener:8080\nevent = patchset-created\n</code></pre>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#switch-ci-tool-for-codebases","title":"Switch CI Tool for Codebase(s)","text":"<p>Go to the codebase Custom Resource and change the <code>spec.ciTool</code> field from <code>jenkins</code> to <code>tekton</code>.</p>"},{"location":"operator-guide/migrate-ci-pipelines-from-jenkins-to-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Tekton</li> </ul>"},{"location":"operator-guide/multitenant-logging/","title":"Multitenant Logging","text":"<p>Get acquainted with the multitenant logging components and the project logs location in the Shared cluster.</p>"},{"location":"operator-guide/multitenant-logging/#logging-components","title":"Logging Components","text":"<p>To configure the multitenant logging, it is necessary to deploy the following components:</p> <ul> <li>Grafana</li> <li>Loki</li> <li>Logging-operator</li> <li>Logging-operator stack-fluentbit</li> </ul> <p>In Grafana, every tenant represents an organization, i.e. it is necessary to create an organization for every namespace in the cluster. To get more details regarding the architecture of the Logging Operator, please review the Diagram 1.</p> <p> Logging operator scheme </p> <p>Note</p> <p>It is necessary to deploy Loki with the <code>auth_enabled: true</code> flag with the aim to ensure that the logs are separated for each tenant. For the authentication, Loki requires the HTTP header X-Scope-OrgID.</p>"},{"location":"operator-guide/multitenant-logging/#review-project-logs-in-grafana","title":"Review Project Logs in Grafana","text":"<p>To find the project logs, navigate to Grafana and follow the steps below:</p> <p>Note</p> <p>Grafana is a common service for different customers where each customer works in its own separated Grafana Organization and doesn't have any access to another project.</p> <ol> <li> <p>Choose the organization by clicking the Current Organization drop-down list. If a user is assigned to several organizations, switch easily by using the Switch button.</p> <p> Current organization </p> </li> <li> <p>Navigate to the left-side menu and click the Explore button to see the Log Browser:</p> <p> Grafana explore </p> </li> <li> <p>Click the Log Browser button to see the labels that can be used to filter logs (e.g., hostname, namespace, application name, pod, etc.):</p> <p>Note</p> <p>Enable the correct data source, select the relevant logging data from the top left-side corner, and pay attention that the data source name always follows the \u2039project_name\u203a-logging pattern.</p> <p> Log browser </p> </li> <li> <p>Filter out logs by clicking the Show logs button or write the query and click the Run query button.</p> </li> <li> <p>Review the results with the quantity of logs per time, see the example below:</p> <p> Logs example </p> <ul> <li>Expand the logs to get detailed information about the object entry:</li> </ul> <p> Expand logs </p> <ul> <li>Use the following buttons to include or remove the labels from the query:</li> </ul> <p> Addition button </p> <ul> <li>See the ad-hoc statistics for a particular label:</li> </ul> <p> Ad-hoc stat example </p> </li> </ol>"},{"location":"operator-guide/multitenant-logging/#related-articles","title":"Related Articles","text":"<ul> <li>Grafana Documentation</li> </ul>"},{"location":"operator-guide/namespace-management/","title":"Manage Namespace","text":"<p>EDP provides the ability to deploy services to namespaces. By default, EDP creates these namespaces automatically. This chapter describes the alternative way of namespace creation and management.</p>"},{"location":"operator-guide/namespace-management/#overview","title":"Overview","text":"<p>Namespaces are typically created by the platform when running CD Pipelines. The operator creates them according to the specific format: <code>edp-&lt;application-name&gt;-&lt;stage-name&gt;</code>. The <code>cd-pipeline-operator</code> should have the permissions to automatically create namespaces when deploying applications and delete them when uninstalling applications.</p>"},{"location":"operator-guide/namespace-management/#disable-automatic-namespace-creation","title":"Disable Automatic Namespace Creation","text":"<p>Occasionally, there are cases when automatic creation of namespaces is not allowed. For example, due to security reasons of the project, EDP user may need to disable this setting. This option is manipulated by the <code>manageNamespace</code> parameter which is located in the values.yaml file. The <code>manageNamespace</code> parameter is set to <code>true</code> by default, but it can be changed to false. As an aftermath, after setting the <code>manageNamespace</code> parameter users are supposed to face the problem that they can not deploy their application in EDP Portal UI because of permission restrictions:</p> <p> Namespace creation error </p> <p>The error message shown above says that user needs to create the namespace in the <code>edp-&lt;application-name&gt;-&lt;stage-name&gt;</code> format first before creating stages. In addition to it, the <code>cd-pipeline-operator</code> must be granted with the administrator permissions to have the ability to manage this namespace. The manual namespace creation procedure does not depend on the deployment scenario whether Jenkins or Tekton is used. To create namespace manually, follow the steps below:</p> <ol> <li> <p>Create the namespace by running the command below:</p> <pre><code> kubectl create namespace edp-&lt;pipelineName&gt;-&lt;stageName&gt;\n</code></pre> </li> <li> <p>Create the administrator RoleBinding resource by applying the file below with the <code>kubectl apply -f grant_admin_permissions.yaml</code> command:</p> View: grant_admin_permissions.yaml <pre><code> kind: RoleBinding\napiVersion: rbac.authorization.k8s.io/v1\nmetadata:\nname: edp-cd-pipeline-operator-admin\nnamespace: edp-&lt;pipelineName&gt;-&lt;stageName&gt;\nsubjects:\n- kind: ServiceAccount\nname: edp-cd-pipeline-operator\nnamespace: edp\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: ClusterRole\nname: admin\n</code></pre> </li> <li> <p>Restart the cd-pipeline-operator pod, in order not to wait for the operator reconciliation.</p> </li> </ol>"},{"location":"operator-guide/namespace-management/#cd-pipeline-operator-rbac-model","title":"CD Pipeline Operator RBAC Model","text":"<p>The <code>manageNamespace</code> parameter also defines the resources that will be created depending on the cluster deployed whether it is OpenShift or Kubernetes. This scheme displays the nesting of operator input parameters:</p> <p> CD Pipeline Operator Input Parameter Scheme </p> <p>Note</p> <p>When deploying application on the OpenShift cluster, the <code>registry-view</code> RoleBinding is created in the main namespace.</p>"},{"location":"operator-guide/namespace-management/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Access Model</li> <li>EKS OIDC With Keycloak</li> </ul>"},{"location":"operator-guide/nexus-sonatype/","title":"Nexus Sonatype Integration","text":"<p>This documentation guide provides comprehensive instructions for integrating Nexus with the EPAM Delivery Platform.</p> <p></p> <p>Info</p> <p>In EDP release 3.5, we have changed the deployment strategy for the nexus-operator component, now it is not installed by default. The <code>nexusURL</code> parameter management has been transferred from the values.yaml file to Kubernetes secrets.</p>"},{"location":"operator-guide/nexus-sonatype/#prerequisites","title":"Prerequisites","text":"<p>Before proceeding, ensure that you have the following prerequisites:</p> <ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/nexus-sonatype/#installation","title":"Installation","text":"<p>To install Nexus with pre-defined templates, use the nexus-operator installed via Cluster Add-Ons approach.</p>"},{"location":"operator-guide/nexus-sonatype/#configuration","title":"Configuration","text":"<p>To ensure strong authentication and accurate access control, creating a Nexus Sonatype service account with the name  ci.user  is crucial. This user serves as a unique identifier, facilitating connection with the EDP ecosystem.</p> <p>To create the Nexus <code>ci.user</code>and define repository parameters follow the steps below: </p> <ol> <li> <p>Open the Nexus UI and navigate to <code>Server administration and configuration</code> -&gt; <code>Security</code> -&gt; <code>User</code>. Click the <code>Create local user</code> button to create a new user:</p> <p> Nexus user settings </p> </li> <li> <p>Type the <code>ci-user</code> username, define an expiration period, and click the <code>Generate</code> button to create the token:</p> <p> Nexus create user </p> </li> <li> <p>EDP relies on a predetermined repository naming convention all repository names are predefined. Navigate to <code>Server administration and configuration</code> -&gt; <code>Repository</code> -&gt; <code>Repositories</code> in Nexus. You can only create a repository with the required language.</p> <p> Nexus repository list </p> JavaJavaScriptDotnetPython <p>a) Click Create a repository by selecting \"maven2(proxy)\" and set the name as \"edp-maven-proxy\". Enter the remote storage URL as \"https://repo1.maven.org/maven2/\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"maven2(hosted)\" and set the name as \"edp-maven-snapshot\". Change the Version policy to \"snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"maven2(hosted)\" and set the name as \"edp-maven-releases\". Change the Version policy to \"release\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"maven2(group)\" and set the name as \"edp-maven-group\". Change the Version policy to \"release\". Add repository to group. Save the configuration.</p> <p>a) Click Create a repository by selecting \"npm(proxy)\" and set the name as \"edp-npm-proxy\". Enter the remote storage URL as \"https://registry.npmjs.org\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"npm(hosted)\" and set the name as \"edp-npm-snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"npm(hosted)\" and set the name as \"edp-npm-releases\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"npm(hosted)\" and set the name as \"edp-npm-hosted\". Save the configuration.</p> <p>e) Click Create a repository by selecting \"npm(group)\" and set the name as \"edp-npm-group\". Add repository to group. Save the configuration.</p> <p>a) Click Create a repository by selecting \"nuget(proxy)\" and set the name as \"edp-dotnet-proxy\". Select Protocol version NuGet V3. Enter the remote storage URL as \"https://api.nuget.org/v3/index.json\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"nuget(hosted)\" and set the name as \"edp-dotnet-snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"nuget(hosted)\" and set the name as \"edp-dotnet-releases\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"nuget(hosted)\" and set the name as \"edp-dotnet-hosted\". Save the configuration.</p> <p>e) Click Create a repository by selecting \"nuget(group)\" and set the name as \"edp-dotnet-group\". Add repository to group. Save the configuration.</p> <p>a) Click Create a repository by selecting \"pypi(proxy)\" and set the name as \"edp-python-proxy\". Enter the remote storage URL as \"https://pypi.org\". Save the configuration.</p> <p>b) Click Create a repository by selecting \"pypi(hosted)\" and set the name as \"edp-python-snapshot\". Save the configuration.</p> <p>c) Click Create a repository by selecting \"pypi(hosted)\" and set the name as \"edp-python-releases\". Save the configuration.</p> <p>d) Click Create a repository by selecting \"pypi(group)\" and set the name as \"edp-python-group\". Add repository to group. Save the configuration.</p> </li> <li> <p>Provision secrets using manifest, EDP Portal or with the externalSecrets operator</p> </li> </ol> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; Nexus. Update or fill in the URL, nexus-user-id, nexus-user-password and click the Save button:</p> <p> Nexus update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-nexus\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: nexus\ntype: Opaque\nstringData:\nurl: https://nexus.example.com\nusername: &lt;nexus-user-id&gt;\npassword: &lt;nexus-user-password&gt;\n</code></pre> <pre><code>\"ci-nexus\":\n{\n\"url\": \"https://nexus.example.com\",\n\"username\": \"XXXXXXX\",\n\"password\": \"XXXXXXX\"\n},\n</code></pre> <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; Nexus and see <code>Managed by External Secret</code> message.</p> <p> Nexus managed by external secret operator </p> <p>More detail of External Secrets Operator Integration can found on the following page</p>"},{"location":"operator-guide/nexus-sonatype/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP With Values File</li> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Cluster Add-Ons Overview</li> </ul>"},{"location":"operator-guide/notification-msteams/","title":"Microsoft Teams Notification","text":"<p>This section describes how to set up and add notification status to Tekton pipelines by sending pipeline status to the Microsoft Teams channel.</p>"},{"location":"operator-guide/notification-msteams/#create-incoming-webhook","title":"Create Incoming WebHook","text":"<p>To create a link to Incoming Webhook for the Microsoft Teams channel, follow the steps below:</p> <p>1. Open the channel which will be receiving notifications and click the <code>\u2022\u2022\u2022</code> button from the upper-right corner. Select <code>Connectors</code> in the dropdown menu:      Microsoft Teams menu </p> <p>2. In the search field, type <code>Incoming Webhook</code> and click <code>Configure</code>:      Connectors </p> <p>3. Provide a name and upload an image for the webhook if necessary. Click <code>Create</code>:      Connectors setup </p> <p>4. Copy and save the unique <code>WebHookURL</code> presented in the dialog. Click <code>Done</code>:      WebHookURL </p> <p>5. Create a secret with the  within the edp namespace. <pre><code>  kubectl -n edp create secret generic microsoft-teams-webhook-url \\\n--from-literal=url=&lt;webhookURL&gt;\n</code></pre> <p>6. Add the notification task to the pipeline and add the code below in <code>final-block</code> in the pipeline and save:</p> <pre><code>{{ include \"send-to-microsoft-teams-build\" . | nindent 4 }}\n</code></pre>"},{"location":"operator-guide/notification-msteams/#customize-notification-message","title":"Customize Notification Message","text":"<p>To make notification message informative, relevant text should be added to the message. Here are the steps to implement it:</p> <ol> <li> <p>Create a new pipeline with a unique name or modify your custom pipeline created before.</p> </li> <li> <p>Add the task below in the <code>finally</code> block with a unique name. Edit the <code>params.message</code> value if necessary:</p> </li> </ol> View: Task send-to-microsoft-teams <pre><code>- name: 'microsoft-teams-pipeline-status-notification-failed\nparams:\n- name: webhook-url-secret\nvalue: microsoft-teams-webhook-url\n- name: webhook-url-secret-key\nvalue: url\n- name: message\nvalue: &gt;-\nBuild Failed project: $(params.CODEBASE_NAME)&lt;br&gt; branch: $(params.git-source-revision)&lt;br&gt; pipeline: &lt;a href=$(params.pipelineUrl)&gt;$(context.pipelineRun.name)&lt;/a&gt;&lt;br&gt; commit message: $(params.COMMIT_MESSAGE)\ntaskRef:\nkind: Task\nname: send-to-microsoft-teams\nwhen:\n- input: $(tasks.status)\noperator: in\nvalues:\n- Failed\n- PipelineRunTimeout\n</code></pre> <p>After customization, the following message is supposed to appear in the channel when failing pipelines:</p> <p> Notification example </p>"},{"location":"operator-guide/notification-msteams/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP</li> <li>Install Tekton</li> </ul>"},{"location":"operator-guide/oauth2-proxy/","title":"Protect Endpoints","text":"<p>OAuth2-Proxy is a versatile tool that serves as a reverse proxy, utilizing the OAuth 2.0 protocol with various providers like Google, GitHub, and Keycloak to provide both authentication and authorization. This guide instructs readers on how to protect their applications' endpoints using OAuth2-Proxy. By following these steps, users can strengthen their endpoints' security without modifying their current application code. In the context of EDP, it has integration with the Keycloak OIDC provider, enabling it to link with any component that lacks built-in authentication.</p> <p>Note</p> <p>OAuth2-Proxy is disabled by default when installing EDP.</p>"},{"location":"operator-guide/oauth2-proxy/#prerequisites","title":"Prerequisites","text":"<ul> <li>Keycloak with OIDC authentication is installed.</li> </ul>"},{"location":"operator-guide/oauth2-proxy/#enable-oauth2-proxy","title":"Enable OAuth2-Proxy","text":"<p>Enabling OAuth2-Proxy implies the following general steps:</p> <ol> <li>Update your EDP deployment using command <code>--set 'oauth2_proxy.enabled=true'</code> or the <code>--values</code> file by enabling the oauth2_proxy parameter.</li> <li>Check that OAuth2-Proxy is deployed successfully.</li> <li>Enable authentication for your Ingress by adding <code>auth-signin</code> and <code>auth-url</code> of OAuth2-Proxy to its annotation.</li> </ol> <p>This will deploy and connect OAuth2-Proxy to your application endpoint.</p>"},{"location":"operator-guide/oauth2-proxy/#enable-oauth2-proxy-on-tekton-dashboard","title":"Enable OAuth2-Proxy on Tekton Dashboard","text":"<p>The example below illustrates how to use OAuth2-Proxy in practice when using the Tekton dashboard:</p> KubernetesOpenshift <ol> <li>Run <code>helm upgrade</code> to update edp-install release: <pre><code>helm upgrade --version &lt;version&gt; --set 'oauth2_proxy.enabled=true' edp-install --namespace edp\n</code></pre></li> <li>Check that OAuth2-Proxy is deployed successfully.</li> <li>Edit the Tekton dashboard Ingress annotation by adding <code>auth-signin</code> and <code>auth-url</code> of oauth2-proxy by <code>kubectl</code> command: <pre><code>kubectl annotate ingress &lt;application-ingress-name&gt; nginx.ingress.kubernetes.io/auth-signin='https://&lt;oauth-ingress-host&gt;/oauth2/start?rd=https://$host$request_uri' nginx.ingress.kubernetes.io/auth-url='http://oauth2-proxy.edp.svc.cluster.local:8080/oauth2/auth'\n</code></pre></li> </ol> <ol> <li>Generate a cookie-secret for proxy with the following command: <pre><code>tekton_dashboard_cookie_secret=$(openssl rand -base64 32 | head -c 32)\n</code></pre></li> <li>Create <code>tekton-dashboard-proxy-cookie-secret</code> in the edp namespace: <pre><code>kubectl -n edp create secret generic tekton-dashboard-proxy-cookie-secret \\\n--from-literal=cookie-secret=${tekton_dashboard_cookie_secret}\n</code></pre></li> <li>Run <code>helm upgrade</code> to update edp-install release: <pre><code>helm upgrade --version &lt;version&gt; --set 'edp-tekton.dashboard.openshift_proxy.enabled=true' edp-install --namespace edp\n</code></pre></li> </ol>"},{"location":"operator-guide/oauth2-proxy/#related-articles","title":"Related Articles","text":"<p>Keycloak Installation Keycloak OIDC Installation Tekton Installation</p>"},{"location":"operator-guide/openshift-cluster-settings/","title":"Set Up OpenShift","text":"<p>Make sure the cluster meets the following conditions:</p> <ol> <li> <p>OpenShift cluster is installed with minimum 2 worker nodes with total capacity 8 Cores and 32Gb RAM.</p> </li> <li> <p>Load balancer (if any exists in front of OpenShift router or ingress controller) is configured with session stickiness, disabled HTTP/2 protocol and header size of 64k support.</p> <p>Find below an example of the Config Map for the NGINX Ingress Controller:</p> <pre><code>kind: ConfigMap\napiVersion: v1\nmetadata:\nname: nginx-configuration\nnamespace: ingress-nginx\nlabels:\napp.kubernetes.io/name: ingress-nginx\napp.kubernetes.io/part-of: ingress-nginx\ndata:\nclient-header-buffer-size: 64k\nlarge-client-header-buffers: 4 64k\nuse-http2: \"false\"\n</code></pre> </li> <li> <p>Cluster nodes and pods have access to the cluster via external URLs. For instance, add in AWS the VPC NAT gateway elastic IP to the cluster external load balancers security group).</p> </li> <li> <p>Keycloak instance is installed. To get accurate information on how to install Keycloak, please refer to the Install Keycloak instruction.</p> </li> <li> <p>The installation machine with oc is installed with the cluster-admin access to the OpenShift cluster.</p> </li> <li> <p>Helm 3.10 is installed on the installation machine with the help of the Installing Helm instruction.</p> </li> <li> <p>Storage classes are used with the Retain Reclaim Policy and Delete Reclaim Policy.</p> </li> <li> <p>We recommended using our storage class as default storage class.</p> <p>Info</p> <p>By default, EDP uses the default Storage Class in a cluster. The EDP development team recommends using the following Storage Classes. See an example below.</p> <p>Storage class templates with the Retain and Delete Reclaim Policies:</p> ebs-scgp3gp3-retain <pre><code>apiVersion: storage.k8s.io/v1\nkind: StorageClass\nmetadata:\nname: ebs-sc\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: Immediate\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3\nannotations:\nstorageclass.kubernetes.io/is-default-class: 'true'\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Delete\nvolumeBindingMode: Immediate\nallowVolumeExpansion: true\n</code></pre> <pre><code>kind: StorageClass\napiVersion: storage.k8s.io/v1\nmetadata:\nname: gp3-retain\nallowedTopologies: []\nmountOptions: []\nprovisioner: ebs.csi.aws.com\nreclaimPolicy: Retain\nvolumeBindingMode: WaitForFirstConsumer\nallowVolumeExpansion: true\n</code></pre> </li> </ol>"},{"location":"operator-guide/openshift-cluster-settings/#related-articles","title":"Related Articles","text":"<ul> <li>Install Amazon EBS CSI Driver</li> <li>Install Keycloak</li> </ul>"},{"location":"operator-guide/overview-devsecops/","title":"Secure Delivery on the Platform","text":"<p>The EPAM Delivery Platform emphasizes the importance of incorporating security practices into the software development lifecycle through the DevSecOps approach. By integrating a diverse range of open-source and enterprise security tools tailored to specific functionalities, organizations can ensure efficient and secure software development. These tools, combined with fundamental DevSecOps principles such as collaboration, continuous security, and automation, contribute to the identification and remediation of vulnerabilities early in the process, minimizes risks, and fosters a security-first culture across the organization.</p> <p>The EPAM Delivery Platform enabling seamless integration with various security tools and vulnerability management systems, enhancing the security of source code and ensuring compliance.</p>"},{"location":"operator-guide/overview-devsecops/#supported-solutions","title":"Supported Solutions","text":"<p>The below table categorizes various open-source and enterprise security tools based on their specific functionalities. It provides a comprehensive view of the available options for each security aspect. This classification facilitates informed decision-making when selecting and integrating security tools into a development pipeline, ensuring an efficient and robust security stance. EDP supports the integration of both open-source and enterprise security tools, providing a flexible and versatile solution for security automation. See table below for more details.</p> Functionality Open-Source Tools (integrated in Pipelines) Enterprise Tools (available for Integration) Hardcoded Credentials Scanner TruffleHog, GitLeaks, Git-secrets GitGuardian, SpectralOps, Bridgecrew Static Application Security Testing SonarQube, Semgrep CLI Veracode, Checkmarx, Coverity Software Composition Analysis OWASP Dependency-Check, cdxgen Black Duck Hub, Mend, Snyk Container Security Trivy, Grype, Clair Aqua Security, Sysdig Secure, Snyk Infrastructure as Code Security Checkov, Tfsec Bridgecrew, Prisma Cloud, Snyk Dynamic Application Security Testing OWASP Zed Attack Proxy Fortify WebInspect, Rapid7 InsightAppSec, Checkmarx Continuous Monitoring and Logging ELK Stack, OpenSearch, Loki Splunk, Datadog Security Audits and Assessments OpenVAS Tenable Nessus, QualysGuard, BurpSuite Professional Vulnerability Management and Reporting DefectDojo, OWASP Dependency-Track Metasploit <p>For better visualization, see the scheme below:</p> <p> Security tools in EDP </p>"},{"location":"operator-guide/overview-devsecops/#integrated-tools","title":"Integrated Tools","text":"<p>For obtaining and managing report post scanning, deployment of various vulnerability management systems and security tools is required. These include:</p>"},{"location":"operator-guide/overview-devsecops/#defectdojo","title":"DefectDojo","text":"<p>DefectDojo is a comprehensive vulnerability management and security orchestration platform facilitating the handling of uploaded security reports. Examine the prerequisites and fundamental instructions for installing DefectDojo on Kubernetes or OpenShift platforms.</p>"},{"location":"operator-guide/overview-devsecops/#owasp-dependency-track","title":"OWASP Dependency Track","text":"<p>Dependency Track is an intelligent Software Composition Analysis (SCA) platform that provides a comprehensive solution for managing vulnerabilities in third-party and open-source components.</p>"},{"location":"operator-guide/overview-devsecops/#gitleaks","title":"Gitleaks","text":"<p>Gitleaks is a versatile SAST tool used to scan Git repositories for hardcoded secrets, such as passwords and API keys, to prevent potential data leaks and unauthorized access.</p>"},{"location":"operator-guide/overview-devsecops/#trivy","title":"Trivy","text":"<p>Trivy is a simple and comprehensive vulnerability scanner for containers and other artifacts, providing insight into potential security issues across multiple ecosystems.</p>"},{"location":"operator-guide/overview-devsecops/#grype","title":"Grype","text":"<p>Grype is a fast and reliable vulnerability scanner for container images and filesystems, maintaining an up-to-date vulnerability database for efficient and accurate scanning.</p>"},{"location":"operator-guide/overview-devsecops/#tfsec","title":"Tfsec","text":"<p>Tfsec is an effective Infrastructure as Code (IaC) security scanner, tailored specifically for reviewing Terraform templates. It helps identify potential security issues related to misconfigurations and non-compliant practices, enabling developers to address vulnerabilities and ensure secure infrastructure deployment.</p>"},{"location":"operator-guide/overview-devsecops/#checkov","title":"Checkov","text":"<p>Checkov is a robust static code analysis tool designed for IaC security, supporting various IaC frameworks such as Terraform, CloudFormation, and Kubernetes. It assists in detecting and mitigating security and compliance misconfigurations, promoting best practices and adherence to industry standards across the infrastructure.</p>"},{"location":"operator-guide/overview-devsecops/#cdxgen","title":"Cdxgen","text":"<p>Cdxgen is a lightweight and efficient tool for generating Software Bill of Materials (SBOM) using CycloneDX, a standard format for managing component inventory. It helps organizations maintain an up-to-date record of all software components, their versions, and related vulnerabilities, streamlining monitoring and compliance within the software supply chain.</p>"},{"location":"operator-guide/overview-devsecops/#semgrep-cli","title":"Semgrep CLI","text":"<p>Semgrep CLI is a versatile and user-friendly command-line interface for the Semgrep security scanner, enabling developers to perform Static Application Security Testing (SAST) for various programming languages. It focuses on detecting and preventing potential security vulnerabilities, code quality issues, and custom anti-patterns, ensuring secure and efficient code development.</p>"},{"location":"operator-guide/overview-devsecops/#clair","title":"Clair","text":"<p>Clair is an open-source container security tool that is designed to help you assess the security of container images and identify vulnerabilities within them. It is particularly useful for organizations using container orchestration platforms such as Kubernetes.</p>"},{"location":"operator-guide/overview-devsecops/#openvas","title":"OpenVAS","text":"<p>OpenVAS is an open-source network vulnerability scanner and security management tool. It is designed to identify and assess security vulnerabilities in computer systems, networks, and applications. OpenVAS provides a comprehensive set of features for vulnerability scanning, assessment, and management.</p>"},{"location":"operator-guide/overview-devsecops/#trufflehog","title":"TruffleHog","text":"<p>TruffleHog is an open-source Python tool designed for finding and identifying potentially sensitive and secret information in the source code and commit history of Git repositories. It's particularly useful for locating unintentional disclosures of confidential data, such as API keys, passwords, and other credentials, that might have been inadvertently committed to a code repository.</p>"},{"location":"operator-guide/overview-devsecops/#git-secrets","title":"Git-secrets","text":"<p>Git-secrets is an open-source tool that helps prevent the accidental committing of secrets, sensitive information, and other types of confidential data into Git repositories. It is designed to enforce security best practices and reduce the risk of unintentional data exposure by scanning Git repositories for predefined secret patterns.</p>"},{"location":"operator-guide/overview-devsecops/#elk-stack","title":"ELK Stack","text":"<p>ELK Stack (Fluent Bit, Elasticsearch, Kibana) stack is used in Kubernetes instead of ELK because this stack provides us with the support for Logsight for Stage Verification and Incident Detection. In addition to it, Fluent Bit has a smaller memory fingerprint than Logstash. Fluent Bit has the Inputs, Parsers, Filters and Outputs plugins similarly to Logstash.</p>"},{"location":"operator-guide/overview-devsecops/#loki","title":"Loki","text":"<p>Loki is a log aggregation system and log processing system designed for cloud-native environments. It is part of the CNCF (Cloud Native Computing Foundation) and is often used alongside other CNCF projects like Prometheus for monitoring and observability.</p>"},{"location":"operator-guide/overview-devsecops/#opensearch","title":"OpenSearch","text":"<p>OpenSearch is the flexible, scalable, open-source way to build solutions for data-intensive applications. Explore, enrich, and visualize your data with built-in performance, developer-friendly tools, and powerful integrations for machine learning, data processing, and more.</p>"},{"location":"operator-guide/overview-devsecops/#owasp-dependency-check","title":"OWASP Dependency-Check","text":"<p>OWASP Dependency-Check is a software composition analysis tool that helps identify and report known security vulnerabilities in project dependencies. It is particularly valuable for developers and organizations looking to secure their applications by identifying and addressing vulnerabilities in the libraries and components they use.</p>"},{"location":"operator-guide/overview-devsecops/#owasp-zed-attack-proxy-zap","title":"OWASP Zed Attack Proxy (ZAP)","text":"<p>OWASP Zed Attack Proxy (ZAP) is an security testing tool for finding vulnerabilities in web applications during the development and testing phases. ZAP is designed to help developers and security professionals identify and address security issues and potential vulnerabilities in web applications. It provides automated and manual testing capabilities, as well as a wide range of features for security testing.</p>"},{"location":"operator-guide/overview-manage-jenkins-pipelines/","title":"Overview","text":"<p>Jenkins job provisioners are responsible for creating and managing pipelines in Jenkins. In other words, provisioners configure all Jenkins pipelines and bring them to the state described in the provisioners code. Two types of provisioners are available in EDP:</p> <ul> <li>CI-provisioner - manages the application folder, and its Code Review, Build and Create Release pipelines.</li> </ul> <ul> <li>CD-provisioner - manages the Deploy pipelines.</li> </ul> <p>The subsections describe the creation/update process of provisioners and their content depending on EDP customization.</p>"},{"location":"operator-guide/overview-sast/","title":"Static Application Security Testing Overview","text":"<p>EPAM Delivery Platform provides the implemented Static Application Security Testing support allowing to work with the Semgrep security scanner and the DefectDojo vulnerability management system to check the source code for known vulnerabilities.</p>"},{"location":"operator-guide/overview-sast/#supported-languages","title":"Supported Languages","text":"<p>EDP SAST supports a number of languages and package managers.</p> Language (Package Managers) Scan Tool Build Tool Java Semgrep Maven, Gradle Go Semgrep Go React Semgrep Npm"},{"location":"operator-guide/overview-sast/#supported-vulnerability-management-system","title":"Supported Vulnerability Management System","text":"<p>To get and then manage a SAST report after scanning, it is necessary to deploy the vulnerability management system, for instance, DefectDojo.</p>"},{"location":"operator-guide/overview-sast/#defectdojo","title":"DefectDojo","text":"<p>DefectDojo is a vulnerability management and security orchestration platform that allows managing the uploaded security reports.</p> <p>Inspect the prerequisites and the main steps for installing DefectDojo on Kubernetes or OpenShift platforms.</p>"},{"location":"operator-guide/overview-sast/#related-articles","title":"Related Articles","text":"<ul> <li>Add Security Scanner</li> <li>Semgrep</li> </ul>"},{"location":"operator-guide/perf-integration/","title":"Perf Server Integration","text":"<p>Integration with Perf Server allows connecting to the PERF Board (Project Performance Board) and monitoring the overall team performance as well as setting up necessary metrics.</p> <p>Note</p> <p>To adjust the PERF Server integration, make sure that PERF Operator is deployed. To get more information about the PERF Operator installation and architecture, please refer to the PERF Operator page.</p> <p>For integration, take the following steps:</p> <ol> <li> <p>Create Secret in the OpenShift/Kubernetes namespace for Perf Server account with the username and password fields:</p> <pre><code>apiVersion: v1\ndata:\npassword: passwordInBase64\nusername: usernameInBase64\nkind: Secret\nmetadata:\nname: epam-perf-user\ntype: kubernetes.io/basic-auth\n</code></pre> </li> <li> <p>In the edp-config config map, enable the perf_integration flag and click Save:</p> <pre><code> perf_integration_enabled: 'true'\n</code></pre> </li> <li> <p>Being in Admin Console, navigate to the Advanced Settings menu to check that the Integrate with Perf Server check box appeared:</p> <p> Advanced settings </p> </li> </ol>"},{"location":"operator-guide/perf-integration/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> </ul>"},{"location":"operator-guide/prerequisites/","title":"EDP Installation Prerequisites Overview","text":"<p>Before installing EDP:</p> <ul> <li>Install and configure Kubernetes or OpenShift cluster.</li> <li>Install EDP components for the selected EDP installation scenario.</li> </ul>"},{"location":"operator-guide/prerequisites/#edp-installation-scenarios","title":"EDP Installation Scenarios","text":"<p>There are two EDP installation scenarios based on the selected CI tool: Tekton (default) or Jenkins.</p> <p>Scenario 1: Tekton CI tool. By default, EDP uses Tekton as a CI tool and EDP Portal as a UI tool.</p> <p>Scenario 2: Jenkins CI tool. To use Jenkins as a CI tool, it is required to install the deprecated Admin Console UI tool. Admin Console is used only as a dependency for Jenkins, and Portal will still be used as a UI tool.</p> <p>Note</p> <p>Starting from version 3.0.0, all the new enhancements and functionalities will be introduced only for Tekton deploy scenario. Jenkins deploy scenario will be supported at the bug fix and security breach level only. We understand that some users may need additional functionality in Jenkins, so if any, please create your request here. To stay up-to-date with all the updates, please check the Release Notes page.</p> <p>Find below the list of the components to be installed for each scenario:</p> Component Tekton CI tool Jenkins CI tool Cluster Tekton Mandatory - NGINX Ingress Controller1 Mandatory Mandatory Keycloak Mandatory Mandatory DefectDojo Mandatory Mandatory Argo CD Mandatory Optional ReportPortal Optional Optional Kiosk Optional Optional External Secrets Optional Optional Harbor Optional Optional <p>Note</p> <p>Alternatively, use Helmfiles to install the EDP components.</p> <p>After setting up the cluster and installing EDP components according to the selected scenario, proceed to the EDP installation.</p>"},{"location":"operator-guide/prerequisites/#related-articles","title":"Related Articles","text":"<ul> <li>Set Up Kubernetes</li> <li>Set Up OpenShift</li> <li>Install EDP</li> </ul> <ol> <li> <p>OpenShift cluster uses Routes to provide access to pods from external resources.\u00a0\u21a9</p> </li> </ol>"},{"location":"operator-guide/report-portal-integration-tekton/","title":"Integration With Tekton","text":"<p>ReportPortal integration with Tekton allows managing all automation results and reports in one place, visualizing metrics and analytics, team collaborating to associate statistics results.</p> <p>For integration, take the following steps:</p> <ol> <li> <p>Log in to the ReportPortal console and navigate to the User Profile menu:</p> <p> ReportPortal profile </p> </li> <li> <p>Copy the Access token and use it as a value while creating a kubernetes secret for the ReportPortal credentials:</p> <pre><code>apiVersion: v1\nkind: Secret\ntype: Opaque\nmetadata:\nname: rp-credentials\nnamespace: edp\nstringData:\nrp_uuid: &lt;access-token&gt;\n</code></pre> </li> <li> <p>In the Configuration examples section of the ReportPortal User Profile menu, copy the following <code>REQUIRED</code> fields: <code>rp.endpoint</code>, <code>rp.launch</code> and <code>rp.project</code>. Insert these fields to the <code>pytest.ini</code> file in root directory of your project:</p> <pre><code>[pytest]\naddopts = -rsxX -l --tb=short --junitxml test-report.xml\nrp_endpoint = &lt;endpoint&gt;\nrp_launch = &lt;launch&gt;\nrp_project = &lt;project&gt;\n</code></pre> </li> <li> <p>In root directory of the project create/update requirements.txt file and fill with following. it's mandatory to install report-portal python library (version may vary):   <pre><code>pytest-reportportal == 5.1.2\n</code></pre></p> </li> <li> <p>Create a custom Tekton task:</p> View: Custom Tekton task <pre><code>apiVersion: tekton.dev/v1beta1\nkind: Task\nmetadata:\nlabels:\napp.kubernetes.io/version: '0.1'\nname: pytest-reportportal\nnamespace: edp\nspec:\ndescription: |-\nThis task can be used to run pytest integrated with report portal.\nparams:\n- default: .\ndescription: The path where package.json of the project is defined.\nname: PATH_CONTEXT\ntype: string\n- name: EXTRA_COMMANDS\ntype: string\n- default: python:3.8-alpine3.16\ndescription: The python image you want to use.\nname: BASE_IMAGE\ntype: string\n- default: rp-credentials\ndescription: name of the secret holding the rp token\nname: rp-secret\ntype: string\nsteps:\n- env:\n- name: HOME\nvalue: $(workspaces.source.path)\n- name: RP_UUID\nvalueFrom:\nsecretKeyRef:\nkey: rp_uuid\nname: $(params.rp-secret)\nimage: $(params.BASE_IMAGE)\nname: pytest\nresources: {}\nscript: &gt;\n#!/usr/bin/env sh\nset -e\nexport PATH=$PATH:$HOME/.local/bin\n$(params.EXTRA_COMMANDS)\n# tests are being run from ./test directory in the project\npytest ./tests --reportportal\nworkingDir: $(workspaces.source.path)/$(params.PATH_CONTEXT)\nworkspaces:\n- name: source\n</code></pre> </li> <li> <p>Add this task ref to your Tekton pipeline after tasks:</p> View: Tekton pipeline <pre><code>- name: pytest\nparams:\n- name: BASE_IMAGE\nvalue: $(params.image)\n- name: EXTRA_COMMANDS\nvalue: |\nset -ex\npip3 install -r requirements.txt\n[ -f run_service.py ] &amp;&amp; python run_service.py &amp;\nrunAfter:\n- compile\ntaskRef:\nkind: Task\nname: pytest-reportportal\nworkspaces:\n- name: source\nworkspace: shared-workspace\n</code></pre> </li> <li> <p>Launch your Tekton pipeline and check that the custom task has been successfully executed:</p> <p> Tekton task successfully executed </p> </li> <li> <p>Test reports will be displayed in the Launches section of the ReportPortal:</p> <p> Test report results </p> </li> </ol>"},{"location":"operator-guide/report-portal-integration-tekton/#related-articles","title":"Related Articles","text":"<ul> <li>ReportPortal Installation</li> <li>Keycloak Integration</li> <li>Pytest Integration With ReportPortal</li> </ul>"},{"location":"operator-guide/reportportal-keycloak/","title":"Keycloak Integration","text":"<p>Follow the steps below to integrate the ReportPortal with Keycloak.</p>"},{"location":"operator-guide/reportportal-keycloak/#prerequisites","title":"Prerequisites","text":"<ul> <li>Installed Keycloak. Please follow the instruction for details.</li> <li>Installed ReportPortal. Please follow the instruction to install it from Helmfile or using the Helm Chart.</li> </ul>"},{"location":"operator-guide/reportportal-keycloak/#keycloak-configuration","title":"Keycloak Configuration","text":"<ol> <li> <p>Navigate to Client Scopes &gt; Create client scope and create a new scope with the SAML protocol type.</p> </li> <li> <p>Navigate to Client Scopes &gt; your_scope_name &gt; Mappers &gt; Configure a new mapper &gt; select the User Attribute mapper type. Add three mappers for the email, first name, and last name by typing <code>lastName</code>, <code>firstName</code>, and <code>email</code> in the User Attribute field:</p> <ul> <li>Name is a display name in Keycloak.</li> <li>User Attribute is a user property for mapping.</li> <li>SAML Attribute Name is an attribute used for requesting information in the ReportPortal configuration.</li> <li>SAML Attribute NameFormat: <code>Basic</code>.</li> <li>Aggregate attribute values: <code>Off</code>.</li> </ul> <p> User mapper sample Scope mappers </p> </li> <li> <p>Navigate to Clients &gt; Create client and fill in the following fields:</p> <ul> <li>Client type: <code>SAML</code>.</li> <li>Client ID: <code>report.portal.sp.id</code>.</li> </ul> <p>Warning</p> <p>The <code>report.portal.sp.id</code> Client ID is a constant value.</p> </li> <li> <p>Navigate to Client &gt; your_client &gt; Settings and add <code>https://&lt;report-portal-url\\&gt;/*</code> to the Valid redirect URIs.</p> </li> <li> <p>Navigate to Client &gt; your_client &gt; Keys and disable Client signature required.</p> <p> Client keys </p> </li> <li> <p>Navigate to Client &gt; your_client &gt; Client scopes and add the scope created on step 3 with the default Assigned type.</p> <p> Client scopes </p> </li> </ol>"},{"location":"operator-guide/reportportal-keycloak/#reportportal-configuration","title":"ReportPortal Configuration","text":"<ol> <li> <p>Log in to the ReportPortal with the admin permissions.</p> </li> <li> <p>Navigate to Client &gt; Administrate &gt; Plugins and select the SAML plugin.</p> <p> Plugins menu </p> </li> <li> <p>To add a new integration, fill in the following fields:</p> <p> Add SAML configuration </p> <ul> <li>Provider name is the display name in the ReportPortal login page.</li> <li>Metadata URL: <code>https://&lt;keycloak_url\\&gt;/auth/realms/&lt;realm\\&gt;/protocol/saml/descriptor</code>.</li> <li>Email is the value from the SAML Attribute Name field in the Keycloak mapper.</li> <li>RP callback URL: <code>https://&lt;report_portal_url\\&gt;/uat</code>.</li> <li>Name attributes mode is the first &amp; last name (type based on your mapper).</li> <li>First name is the value from the SAML Attribute Name field in the Keycloak mapper.</li> <li>Last name is the value from the SAML Attribute Name field in the Keycloak mapper.</li> </ul> </li> <li> <p>Log in to the ReportPortal.</p> <p>Note</p> <p>By default, after the first login, ReportPortal creates the &lt;your_email&gt;_personal project and adds an account with the <code>Project manager</code> role.</p> <p> Report portal login page </p> </li> </ol>"},{"location":"operator-guide/reportportal-keycloak/#related-articles","title":"Related Articles","text":"<ul> <li>ReportPortal Installation</li> <li>Integration With Tekton</li> </ul>"},{"location":"operator-guide/restore-edp-with-velero/","title":"Restore EDP Tenant With Velero","text":"<p>You can use the Velero tool to restore a EDP tenant. Explore the main steps for backup and restoring below.</p> <ol> <li> <p>Delete all related entities in Keycloak: realm and clients from master/openshift realms. Navigate to the entities list in the Keycloak, select the necessary ones, and click the deletion icon on the entity overview page.    If there are customized configs in Keycloak, save them before making backup.</p> <p> Remove keycloak realm </p> </li> <li> <p>To restore EDP, install and configure the Velero tool. Please refer to the Install Velero documentation for details.</p> </li> <li> <p>Remove all locks for operators. Delete all config maps that have \u2039OPERATOR_NAME\u203a-operator-lock names. Then restart all pods with operators, or simply run the following command:</p> <pre><code>     kubectl -n edp delete cm $(kubectl -n edp get cm | grep 'operator-lock' | awk '{print $1}')\n</code></pre> </li> <li> <p>Recreate the admin password and delete the Jenkins pod. Or change the script to update the admin password in Jenkins every time when the pod is updated.</p> </li> </ol>"},{"location":"operator-guide/sast-scaner-semgrep/","title":"Semgrep","text":"<p>Semgrep is an open-source static source code analyzer for finding bugs and enforcing code standards.</p> <p>Semgrep scanner is installed on the EDP Jenkins SAST agent and runs on the <code>sast</code> pipeline stage. For details, please refer to the edp-library-stages repository.</p>"},{"location":"operator-guide/sast-scaner-semgrep/#supported-languages","title":"Supported Languages","text":"<p>Semgrep supports more than 20 languages, see the full list in the official documentation. EDP uses Semgrep to scan Java, JavaScript and Go languages.</p>"},{"location":"operator-guide/sast-scaner-semgrep/#related-articles","title":"Related Articles","text":"<ul> <li>Add Security Scanner</li> </ul>"},{"location":"operator-guide/schedule-pods-restart/","title":"Schedule Pods Restart","text":"<p>In case it is necessary to restart pods, use a CronJob according to the following template:</p> View: template <pre><code>---\nkind: Role\napiVersion: rbac.authorization.k8s.io/v1\nmetadata:\nnamespace: &lt;NAMESPACE&gt;\nname: apps-restart\nrules:\n- apiGroups: [\"apps\"]\nresources:\n- deployments\n- statefulsets\nverbs:\n- 'get'\n- 'list'\n- 'patch'\n---\nkind: RoleBinding\napiVersion: rbac.authorization.k8s.io/v1\nmetadata:\nname: apps-restart\nnamespace: &lt;NAMESPACE&gt;\nsubjects:\n- kind: ServiceAccount\nname: apps-restart-sa\nnamespace: &lt;NAMESPACE&gt;\nroleRef:\nkind: Role\nname: apps-restart\napiGroup: \"\"\n---\napiVersion: v1\nkind: ServiceAccount\nmetadata:\nname: apps-restart-sa\nnamespace: &lt;NAMESPACE&gt;\n---\napiVersion: batch/v1beta1\nkind: CronJob\nmetadata:\nname: apps-rollout-restart\nnamespace: &lt;NAMESPACE&gt;\nspec:\nschedule: \"0 9 * * MON-FRI\"\njobTemplate:\nspec:\ntemplate:\nspec:\nserviceAccountName: apps-restart-sa\ncontainers:\n- name: kubectl-runner\nimage: bitnami/kubectl\ncommand:\n- /bin/sh\n- -c\n- kubectl get -n &lt;NAMESPACE&gt; -o name deployment,statefulset | grep &lt;NAME_PATTERN&gt;| xargs kubectl -n &lt;NAMESPACE&gt; rollout restart\nrestartPolicy: Never\n</code></pre> <p>Modify the Cron expression in the CronJob manifest if needed.</p>"},{"location":"operator-guide/sonarqube/","title":"SonarQube Integration","text":"<p>This documentation guide provides comprehensive instructions for integrating SonarQube with the EPAM Delivery Platform.</p> <p></p> <p>Info</p> <p>In EDP release 3.5, we have changed the deployment strategy for the sonarqube-operator component, now it is not installed by default. The <code>sonarURL</code> parameter management has been transferred from the values.yaml file to Kubernetes secrets.</p>"},{"location":"operator-guide/sonarqube/#prerequisites","title":"Prerequisites","text":"<p>Before proceeding, ensure that you have the following prerequisites:</p> <ul> <li>Kubectl version 1.26.0 is installed.</li> <li>Helm version 3.12.0+ is installed.</li> </ul>"},{"location":"operator-guide/sonarqube/#installation","title":"Installation","text":"<p>To install SonarQube with pre-defined templates, use the sonar-operator installed via Cluster Add-Ons approach.</p>"},{"location":"operator-guide/sonarqube/#configuration","title":"Configuration","text":"<p>To establish robust authentication and precise access control, generating a SonarQube token is essential. This token is a distinct identifier, enabling effortless integration between SonarQube and EDP. To generate the SonarQube token, proceed with the following steps:</p> <ol> <li> <p>Open the SonarQube UI and navigate to <code>Administration</code> -&gt; <code>Security</code> -&gt; <code>User</code>. Create a new user or select an existing one. Click the <code>Options List</code> icon to create a token:</p> <p> SonarQube user settings </p> </li> <li> <p>Type the <code>ci-user</code> username, define an expiration period, and click the <code>Generate</code> button to create the token:</p> <p> SonarQube create token </p> </li> <li> <p>Click the <code>Copy</code> button to copy the generated <code>&lt;Sonarqube-token&gt;</code>:</p> <p> SonarQube token </p> </li> <li> <p>Provision secrets using Manifest, EDP Portal or with the externalSecrets operator:</p> </li> </ol> EDP PortalManifestExternal Secrets Operator <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; SonarQube. Update or fill in the URL and Token fields and click the Save button:</p> <p> SonarQube update manual secret </p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: ci-sonarqube\nnamespace: edp\nlabels:\napp.edp.epam.com/secret-type: sonar\ntype: Opaque\nstringData:\nurl: https://sonarqube.example.com\ntoken: &lt;sonarqube-token&gt;\n</code></pre> <pre><code>\"ci-sonarqube\":\n{\n\"url\": \"https://sonarqube.example.com\",\n\"token\": \"XXXXXXXXXXXX\"\n},\n</code></pre> <p>Go to EDP Portal -&gt; EDP -&gt; Configuration -&gt; SonarQube and see the <code>Managed by External Secret</code> message:</p> <p> SonarQube managed by external secret operator </p> <p>More details about External Secrets Operator integration can be found in the External Secrets Operator Integration page.</p>"},{"location":"operator-guide/sonarqube/#related-articles","title":"Related Articles","text":"<ul> <li>Install EDP With Values File</li> <li>Install External Secrets Operator</li> <li>External Secrets Operator Integration</li> <li>Cluster Add-Ons Overview</li> </ul>"},{"location":"operator-guide/ssl-automation-okd/","title":"Use Cert-Manager in OpenShift","text":"<p>The following material covers Let's Encrypt certificate automation with cert-manager using AWS Route53.</p> <p>The cert-manager is a Kubernetes/OpenShift operator that allows to issue and automatically renew SSL certificates. In this tutorial, the steps to secure DNS Name will be demonstrated.</p> <p>Below is an instruction on how to automatically issue and install wildcard certificates on OpenShift Ingress Controller and API Server covering all cluster Routes. To secure separate OpenShift Routes, please refer to the OpenShift Route Support project for <code>cert-manager</code>.</p>"},{"location":"operator-guide/ssl-automation-okd/#prerequisites","title":"Prerequisites","text":"<ul> <li>The cert-manager;</li> <li>OpenShift v4.7 - v4.11;</li> <li>Connection to the OpenShift Cluster;</li> <li>Enabled AWS IRSA;</li> <li>The latest <code>oc</code> utility. The <code>kubectl</code> tool can also be used for most of the commands.</li> </ul>"},{"location":"operator-guide/ssl-automation-okd/#install-cert-manager-operator","title":"Install Cert-Manager Operator","text":"<p>Install the <code>cert-manager</code> operator via OpenShift OperatorHub that uses Operator Lifecycle Manager (OLM):</p> <ol> <li> <p>Go to the OpenShift Admin Console \u2192 OperatorHub, search for the <code>cert-manager</code>, and click Install:</p> <p> Cert-Manager Installation </p> </li> <li> <p>Modify the <code>ClusterServiceVersion</code> OLM resource, by selecting the Update approval \u2192 Manual. If selecting Update approval \u2192 Automatic after the automatic operator update, the parameters in the <code>ClusterServiceVersion</code> will be reset to default.</p> <p>Note</p> <p>Installing an operator with Manual approval causes all operators installed in namespace <code>openshift-operators</code> to function as manual approval strategy. In case the Manual approval is chosen, review the manual installation plan and approve it.</p> <p> Cert-Manager Installation </p> </li> <li> <p>Navigate to Operators \u2192 Installed Operators and check the operator status to be Succeeded:</p> <p> Cert-Manager Installation </p> </li> <li> <p>In case of errors, troubleshoot the Operator issues:</p> <pre><code>oc describe operator cert-manager -n openshift-operators\noc describe sub cert-manager -n openshift-operators\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#create-aws-role-for-route53","title":"Create AWS Role for Route53","text":"<p>The <code>cert-manager</code> should be configured to validate Wildcard certificates using the DNS-based method.</p> <ol> <li> <p>Check the DNS Hosted zone ID in AWS Route53 for your domain.</p> <p> Hosted Zone ID </p> </li> <li> <p>Create Route53 Permissions policy in AWS for <code>cert-manager</code> to be able to create DNS TXT records for the certificate validation. In this example, <code>cert-manager</code> permissions are given for a particular DNS zone only. Replace Hosted zone ID XXXXXXXX in the \"Resource\": \"arn:aws:route53:::hostedzone/XXXXXXXXXXXX\".</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Action\": \"route53:GetChange\",\n\"Resource\": \"arn:aws:route53:::change/*\"\n},\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"route53:ChangeResourceRecordSets\",\n\"route53:ListResourceRecordSets\"\n],\n\"Resource\": \"arn:aws:route53:::hostedzone/XXXXXXXXXXXX\"\n}\n]\n}\n</code></pre> </li> <li> <p>Create an AWS Role with Custom trust policy for the <code>cert-manager</code> service account to use the AWS IRSA feature and then attach the created policy. Replace the following:</p> <ul> <li><code>${aws-account-id}</code> with the AWS account ID of the EKS cluster.</li> <li><code>${aws-region}</code> with the region where the EKS cluster is located.</li> <li><code>${eks-hash}</code> with the hash in the EKS API URL; this will be a random 32 character hex string, for example, 45DABD88EEE3A227AF0FA468BE4EF0B5.</li> <li><code>${namespace}</code> with the namespace where cert-manager is running.</li> <li><code>${service-account-name}</code> with the name of the ServiceAccount object created by cert-manager.</li> <li>By default, it is \"system:serviceaccount:openshift-operators:cert-manager\" if <code>cert-manager</code> is installed via OperatorHub.</li> <li>Attach the created Permission policy for Route53 to the Role.</li> <li> <p>Optionally, add Permissions boundary to the Role.</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Action\": \"sts:AssumeRoleWithWebIdentity\",\n\"Principal\": {\n\"Federated\": \"arn:aws:iam::* ${aws-account-id}:oidc-provider/oidc.eks.${aws-region}.amazonaws.com/id/${eks-hash}\"\n},\n\"Condition\": {\n\"StringEquals\": {\n\"oidc.eks.${aws-region}.amazonaws.com/id/${eks-hash}:sub\": \"system:serviceaccount:${namespace}:${service-account-name}\"\n}\n}\n}\n]\n}\n</code></pre> </li> </ul> </li> <li> <p>Copy the created Role ARN.</p> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#configure-cert-manager-integration-with-aws-route53","title":"Configure Cert-Manager Integration With AWS Route53","text":"<ol> <li> <p>Annotate the <code>ServiceAccount</code> created by <code>cert-manager</code> (required for AWS IRSA), and restart the <code>cert-manager</code> pod.</p> </li> <li> <p>Replace the <code>eks.amazonaws.com/role-arn</code> annotation value with your own Role ARN.</p> <pre><code>oc edit sa cert-manager -n openshift-operators\n</code></pre> <pre><code>apiVersion: v1\nkind: ServiceAccount\nmetadata:\nannotations:\neks.amazonaws.com/role-arn: arn:aws:iam::XXXXXXXXXXXX:role/cert-manager\n</code></pre> </li> <li> <p>Modify the <code>cert-manager</code> <code>Deployment</code> with the correct file system permissions <code>fsGroup: 1001</code>, so that the <code>ServiceAccount</code> token can be read.</p> <p>Note</p> <p>In case the <code>ServiceAccount</code> token cannot be read and the operator is installed using the OperatorHub, add <code>fsGroup: 1001</code> via OpenShift ClusterServiceVersion OLM resource. It should be a <code>cert-manager</code> controller spec. These actions are not required for OpenShift v4.10.</p> <pre><code>oc get csv\noc edit csv cert-manager.${VERSION}\n</code></pre> <pre><code>spec:\ntemplate:\nspec:\nsecurityContext:\nfsGroup: 1001\nserviceAccountName: cert-manager\n</code></pre> <p> Cert-Manager System Permissions </p> <p>Info</p> <p>A mutating admission controller will automatically modify all pods running with the service account:</p> <p> cert-manager controller pod <pre><code>apiVersion: apps/v1\nkind: Pod\n# ...\nspec:\n# ...\nserviceAccountName: cert-manager\nserviceAccount: cert-manager\ncontainers:\n- name: ...\n# ...\nenv:\n- name: AWS_ROLE_ARN\nvalue: &gt;-\narn:aws:iam::XXXXXXXXXXX:role/cert-manager\n- name: AWS_WEB_IDENTITY_TOKEN_FILE\nvalue: /var/run/secrets/eks.amazonaws.com/serviceaccount/token\nvolumeMounts:\n- name: aws-iam-token\nreadOnly: true\nmountPath: /var/run/secrets/eks.amazonaws.com/serviceaccount\nvolumes:\n- name: aws-iam-token\nprojected:\nsources:\n- serviceAccountToken:\naudience: sts.amazonaws.com\nexpirationSeconds: 86400\npath: token\ndefaultMode: 420\n</code></pre> </p> </li> <li> <p>If you have separate public and private DNS zones for the same domain (split-horizon DNS), modify the <code>cert-manager</code> <code>Deployment</code> in order to validate DNS TXT records via public recursive nameservers.</p> <p>Note</p> <p>Otherwise, you will be getting an error during a record validation:</p> <p><pre><code>Waiting for DNS-01 challenge propagation: NS ns-123.awsdns-00.net.:53 returned REFUSED for _acme-challenge.\n</code></pre> To avoid the error, add <code>--dns01-recursive-nameservers-only --dns01-recursive-nameservers=8.8.8.8:53,1.1.1.1:53</code> as ARGs to the <code>cert-manager</code> controller <code>Deployment</code>.</p> <pre><code>oc get csv\noc edit csv cert-manager.${VERSION}\n</code></pre> <pre><code>  labels:\napp: cert-manager\napp.kubernetes.io/component: controller\napp.kubernetes.io/instance: cert-manager\napp.kubernetes.io/name: cert-manager\napp.kubernetes.io/version: v1.9.1\nspec:\ncontainers:\n- args:\n- '--v=2'\n- '--cluster-resource-namespace=$(POD_NAMESPACE)'\n- '--leader-election-namespace=kube-system'\n- '--dns01-recursive-nameservers-only'\n- '--dns01-recursive-nameservers=8.8.8.8:53,1.1.1.1:53'\n</code></pre> <p>Note</p> <p>The <code>Deployment</code> must be modified via OpenShift ClusterServiceVersion OLM resource if the operator was installed using the OperatorHub. The OpenShift <code>ClusterServiceVersion</code> OLM resource includes several Deployments, and the ARGs must be modified only for the <code>cert-manager</code> controller.</p> <ul> <li>Save the resource. After that, OLM will try to reload the resource automatically and save it to the YAML file. If OLM resets the config file, double-check the entered values.</li> </ul> <p> Cert-Manager Nameservers </p> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#configure-clusterissuers","title":"Configure ClusterIssuers","text":"<p><code>ClusterIssuer</code> is available on the whole cluster.</p> <ol> <li> <p>Create the ClusterIssuer resource for Let's Encrypt Staging and Prod environments that signs a Certificate using <code>cert-manager</code>.</p> <p>Note</p> <p>Let's Encrypt has a limit of duplicate certificates in the Prod environment. Therefore, a <code>ClusterIssuer</code> has been created for Let's Encrypt Staging environment. By default, Let's Encrypt Staging certificates will not be trusted in your browser. The certificate validation cannot be tested in the Let's Encrypt Staging environment.</p> <ul> <li>Change <code>user@example.com</code> with your contact email.</li> <li>Replace <code>hostedZoneID</code> XXXXXXXXXXX with the DNS Hosted zone ID in AWS for your domain.</li> <li>Replace the region value <code>${region}</code>.</li> <li>The secret under <code>privateKeySecretRef</code> will be created automatically by the <code>cert-manager</code> operator.</li> </ul> <pre><code>apiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\nname: letsencrypt-staging\nspec:\nacme:\nemail: user@example.com\nserver: https://acme-staging-v02.api.letsencrypt.org/directory\nprivateKeySecretRef:\nname: letsencrypt-staging-issuer-account-key\nsolvers:\n- dns01:\nroute53:\nregion: ${region}\nhostedZoneID: XXXXXXXXXXX\n</code></pre> <pre><code>apiVersion: cert-manager.io/v1\nkind: ClusterIssuer\nmetadata:\nname: letsencrypt-prod\nspec:\nacme:\nemail: user@example.com\nserver: https://acme-v02.api.letsencrypt.org/directory\nprivateKeySecretRef:\nname: letsencrypt-prod-issuer-account-key\nsolvers:\n- dns01:\nroute53:\nregion: ${region}\nhostedZoneID: XXXXXXXXXXX\n</code></pre> <p> Cert-Manager ClusterIssuer </p> </li> <li> <p>Check the <code>ClusterIssuer</code> status:</p> <p> Cert-Manager ClusterIssuer </p> <pre><code>oc describe clusterissuer letsencrypt-prod\noc describe clusterissuer letsencrypt-staging\n</code></pre> </li> <li> <p>If the <code>ClusterIssuer</code> state is not ready, investigate <code>cert-manager</code> controller pod logs:</p> <pre><code>oc get pod -n openshift-operators | grep 'cert-manager'\noc logs -f cert-manager-${replica_set}-${random_string} -n openshift-operators\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#configure-certificates","title":"Configure Certificates","text":"<ol> <li> <p>In two different namespaces, create a Certificate resource for the OpenShift Router (Ingress controller for OpenShift) and for the OpenShift APIServer.</p> <ul> <li>OpenShift Router supports a single wildcard certificate for Ingress/Route resources in different namespaces (so called, default SSL certificate). The Ingress controller expects the certificates in a <code>Secret</code> to be created in the <code>openshift-ingress</code> namespace; the API Server, in the <code>openshift-config</code> namespace. The <code>cert-manager</code> operator will automatically create these secrets from the <code>Certificate</code> resource.</li> <li>Replace <code>${DOMAIN}</code> with your domain name. It can be checked with <code>oc whoami --show-server</code>. Put domain names in quotes.</li> </ul> The certificate for OpenShift Router in the `openshift-ingress` namespace <pre><code>apiVersion: cert-manager.io/v1\nkind: Certificate\nmetadata:\nname: router-certs\nnamespace: openshift-ingress\nlabels:\napp: cert-manager\nspec:\nsecretName: router-certs\nsecretTemplate:\nlabels:\napp: cert-manager\nduration: 2160h # 90d\nrenewBefore: 360h # 15d\nsubject:\norganizations:\n- Org Name\ncommonName: '*.${DOMAIN}'\nprivateKey:\nalgorithm: RSA\nencoding: PKCS1\nsize: 2048\nrotationPolicy: Always\nusages:\n- server auth\n- client auth\ndnsNames:\n- '*.${DOMAIN}'\n- '*.apps.${DOMAIN}'\nissuerRef:\nname: letsencrypt-staging\nkind: ClusterIssuer\n</code></pre> The certificate for OpenShift APIServer in the `openshift-config` namespace <pre><code>apiVersion: cert-manager.io/v1\nkind: Certificate\nmetadata:\nname: api-certs\nnamespace: openshift-config\nlabels:\napp: cert-manager\nspec:\nsecretName: api-certs\nsecretTemplate:\nlabels:\napp: cert-manager\nduration: 2160h # 90d\nrenewBefore: 360h # 15d\nsubject:\norganizations:\n- Org Name\ncommonName: '*.${DOMAIN}'\nprivateKey:\nalgorithm: RSA\nencoding: PKCS1\nsize: 2048\nrotationPolicy: Always\nusages:\n- server auth\n- client auth\ndnsNames:\n- '*.${DOMAIN}'\n- '*.apps.${DOMAIN}'\nissuerRef:\nname: letsencrypt-staging\nkind: ClusterIssuer\n</code></pre> <p>Info</p> <ul> <li> <p><code>cert-manager</code> supports ECDSA key pairs in the <code>Certificate</code> resource. To use it, change RSA <code>privateKey</code> to ECDSA:</p> <pre><code>privateKey:\nalgorithm: ECDSA\nencoding: PKCS1\nsize: 256\nrotationPolicy: Always\n</code></pre> </li> </ul> <ul> <li><code>rotationPolicy: Always</code> is highly recommended since <code>cert-manager</code> does not rotate private keys by default.</li> <li>Full <code>Certificate</code> spec is described in the <code>cert-manager</code> API documentation.</li> </ul> </li> <li> <p>Check that the certificates in the namespaces are ready:</p> <p> Cert-Manager Certificate Status </p> <p> Cert-Manager Certificate Status </p> </li> <li> <p>Check the details of the certificates via CLI:</p> <pre><code>oc describe certificate api-certs -n openshift-config\noc describe certificate router-certs -n openshift-ingress\n</code></pre> </li> <li> <p>Check the cert-manager controller pod logs if the Staging Certificate condition is not ready for more than 7 minutes:</p> <pre><code>oc get pod -n openshift-operators | grep 'cert-manager'\noc logs -f cert-manager-${replica_set}-${random_string} -n openshift-operators\n</code></pre> </li> <li> <p>When the certificate is ready, its private key will be put into the OpenShift <code>Secret</code> in the namespace indicated in the <code>Certificate</code> resource:</p> <pre><code>oc describe secret api-certs -n openshift-config\noc describe secret router-certs -n openshift-ingress\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#modify-openshift-router-and-api-server-custom-resources","title":"Modify OpenShift Router and API Server Custom Resources","text":"<ol> <li> <p>Update the Custom Resource of your Router (Ingress controller). Patch the <code>defaultCertificate</code> object value with <code>{ \"name\": \"router-certs\" }</code>:</p> <pre><code>oc patch ingresscontroller default -n openshift-ingress-operator --type=merge --patch='{\"spec\": { \"defaultCertificate\": { \"name\": \"router-certs\" }}}' --insecure-skip-tls-verify\n</code></pre> <p>Info</p> <p>After updating the <code>IngressController</code> object, the OpenShift Ingress operator redeploys the router.</p> </li> <li> <p>Update the Custom Resource for the OpenShift API Server:</p> <ul> <li> <p>Export the name of <code>APIServer</code>:</p> <pre><code>export OKD_API=$(oc whoami --show-server --insecure-skip-tls-verify | cut -f 2 -d ':' | cut -f 3 -d '/' | sed 's/-api././')\n</code></pre> </li> </ul> <ul> <li> <p>Patch the <code>servingCertificate</code> object value with <code>{ \"name\": \"api-certs\" }</code>:</p> <pre><code>oc patch apiserver cluster --type merge --patch=\"{\\\"spec\\\": {\\\"servingCerts\\\": {\\\"namedCertificates\\\": [ { \\\"names\\\": [  \\\"$OKD_API\\\"  ], \\\"servingCertificate\\\": {\\\"name\\\": \\\"api-certs\\\" }}]}}}\" --insecure-skip-tls-verify\n</code></pre> </li> </ul> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#move-from-lets-encrypt-staging-environment-to-prod","title":"Move From Let's Encrypt Staging Environment to Prod","text":"<ol> <li> <p>Test the Staging certificate on the OpenShift Admin Console. The <code>--insecure</code> flag is used because Let's Encrypt Staging certificates are not trusted in browsers by default:</p> <pre><code>curl -v --insecure https://console-openshift-console.apps.${DOMAIN}\n</code></pre> </li> <li> <p>Change <code>issuerRef</code> to <code>letsencrypt-prod</code> in both <code>Certificate</code> resources:</p> <pre><code>oc edit certificate api-certs -n openshift-config\noc edit certificate router-certs -n openshift-ingress\n</code></pre> <pre><code>issuerRef:\nname: letsencrypt-prod\nkind: ClusterIssuer\n</code></pre> <p>Note</p> <p>In case the certificate reissue is not triggered after that, try to force the certificate renewal with cmctl:</p> <pre><code>cmctl renew router-certs -n openshift-ingress\ncmctl renew api-certs -n openshift-config\n</code></pre> <p>If this won't work, delete the <code>api-certs</code> and <code>router-certs</code> secrets. It should trigger the Prod certificates issuance:</p> <pre><code>oc delete secret router-certs -n openshift-ingress\noc delete secret api-certs -n openshift-config\n</code></pre> <p>Please note that these actions will lead to logging your account out of the OpenShift Admin Console, since certificates will be deleted. Accept the certificate warning in the browser and log in again after that.</p> </li> <li> <p>Check the status of the Prod certificates:</p> <pre><code>oc describe certificate api-certs -n openshift-config\noc describe certificate router-certs -n openshift-ingress\n</code></pre> <pre><code>cmctl status certificate api-certs -n openshift-config\ncmctl status certificate router-certs -n openshift-ingress\n</code></pre> </li> <li> <p>Check the web console and make sure it has secure connection:</p> <pre><code>curl -v https://console-openshift-console.apps.${DOMAIN}\n</code></pre> </li> </ol>"},{"location":"operator-guide/ssl-automation-okd/#troubleshoot-certificates","title":"Troubleshoot Certificates","text":"<p>Below is an example of the DNS TXT <code>challenge</code> record created by the <code>cert-manager</code> operator:</p> <p> DNS Validation </p> <p>Use <code>nslookup</code> or <code>dig</code> tools to check if the DNS propagation for the TXT record is complete:</p> <pre><code>nslookup -type=txt _acme-challenge.${DOMAIN}\ndig txt _acme-challenge.${DOMAIN}\n</code></pre> <p>Otherwise, use web tools like Google Admin Toolbox:</p> <p> DNS Validation </p> <p>If the correct TXT value is shown (the value corresponds to the current TXT value in the DNS zone), it means that the DNS propagation is complete and Let's Encrypt is able to access the record in order to validate it and issue a trusted certificate.</p> <p>Note</p> <p>If the DNS validation challenge self check fails, <code>cert-manager</code> will retry the self check with a fixed 10-second retry interval. Challenges that do not ever complete the self check will continue retrying until the user intervenes by either retrying the <code>Order</code> (by deleting the <code>Order</code> resource) or amending the associated <code>Certificate</code> resource to resolve any configuration errors.</p> <p>As soon as the domain ownership has been verified, any <code>cert-manager</code> affected validation TXT records in the AWS Route53 DNS zone will be cleaned up.</p> <p>Please find below the issues that may occur and their troubleshooting:</p> <ul> <li>When certificates are not issued for a long time, or a <code>cert-manager</code> resource is not in a Ready state, describing a resource may show the reason for the error.</li> </ul> <ul> <li>Basically, the <code>cert-manager</code> creates the following resources during a <code>Certificate</code> issuance: <code>CertificateRequest</code>, <code>Order</code>, and <code>Challenge</code>. Investigate each of them in case of errors.</li> </ul> <ul> <li>Use the cmctl tool to show the state of a <code>Certificate</code> and its associated resources.</li> </ul> <ul> <li> <p>Check the <code>cert-manager</code> controller pod logs:</p> <pre><code>oc get pod -n openshift-operators | grep 'cert-manager'\noc logs -f cert-manager-${replica_set}-${random_string} -n openshift-operators\n</code></pre> </li> </ul> <ul> <li> <p>Certificate error debugging:   a. Decode certificate chain located in the secrets:</p> <pre><code>oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | while openssl x509 -noout -text; do :; done 2&gt;/dev/null\noc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | while openssl x509 -noout -text; do :; done 2&gt;/dev/null\n</code></pre> <pre><code>cmctl inspect secret router-certs -n openshift-ingress\ncmctl inspect secret api-certs -n openshift-config\n</code></pre> <p>b. Check the SSL RSA private key consistency:</p> <pre><code>oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -check -noout\noc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -check -noout\n</code></pre> <p>c. Match the SSL certificate public key against its RSA private key. Their modulus must be identical:</p> <pre><code>diff &lt;(oc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | openssl x509 -noout -modulus | openssl md5) &lt;(oc get secret api-certs -n openshift-config -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -noout -modulus | openssl md5)\ndiff &lt;(oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.crt\"}}' | base64 -d | openssl x509 -noout -modulus | openssl md5) &lt;(oc get secret router-certs -n openshift-ingress -o 'go-template={{index .data \"tls.key\"}}' | base64 -d | openssl rsa -noout -modulus | openssl md5)\n</code></pre> </li> </ul>"},{"location":"operator-guide/ssl-automation-okd/#remove-obsolete-certificate-authority-data-from-kubeconfig","title":"Remove Obsolete Certificate Authority Data From Kubeconfig","text":"<p>After updating the certificates, the access to the cluster via Lens or CLI will be denied because of the untrusted certificate errors:</p> <pre><code>$ oc whoami\nUnable to connect to the server: x509: certificate signed by unknown authority\n</code></pre> <p>Such behavior appears because the <code>oc</code> tool references an old CA data in the kubeconfig file.</p> <p>Note</p> <p>Examine the Certificate Authority data using the following command:</p> <pre><code>oc config view --minify --raw -o jsonpath='{.clusters[].cluster.certificate-authority-data}' | base64 -d | openssl x509 -text\n</code></pre> <p>This certificate has the <code>CA:TRUE</code> parameter, which means that this is a self-signed root CA certificate.</p> <p>To fix the error, remove the old CA data from your OpenShift kubeconfig file:</p> <pre><code>sed -i \"/certificate-authority-data/d\" $KUBECONFIG\n</code></pre> <p>Since this field will be absent in the kubeconfig file, system root SSL certificate will be used to validate the cluster certificate trust chain. On Ubuntu, Let's Encrypt OpenShift cluster certificates will be validated against <code>Internet Security Research Group</code> root in <code>/etc/ssl/certs/ca-certificates.crt</code>.</p>"},{"location":"operator-guide/ssl-automation-okd/#certificate-renewals","title":"Certificate Renewals","text":"<p>The <code>cert-manager</code> automatically renews the certificates based on the X.509 certificate's duration and the <code>renewBefore</code> value. The minimum value for the <code>spec.duration</code> is 1 hour; for <code>spec.renewBefore</code>, 5 minutes. It is also required that <code>spec.duration</code> &gt; <code>spec.renewBefore</code>.</p> <p>Use the cmctl tool to manually trigger a single instant certificate renewal:</p> <pre><code>cmctl renew router-certs -n openshift-ingress\ncmctl renew api-certs -n openshift-config\n</code></pre> <p>Otherwise, manually renew all certificates in all namespaces with the <code>app=cert-manager</code> label:</p> <pre><code>cmctl renew --all-namespaces -l app=cert-manager\n</code></pre> <p>Run the <code>cmctl renew --help</code> command to get more details.</p>"},{"location":"operator-guide/ssl-automation-okd/#related-articles","title":"Related Articles","text":"<ul> <li>Cert-Manager Official Documentation</li> <li>Installing the Cert-Manager Operator for Red Hat OpenShift</li> <li>Checking Issued Certificate Details</li> </ul>"},{"location":"operator-guide/tekton-monitoring/","title":"Monitoring","text":"<p>This documentation describes how to integrate tekton-pipelines metrics with Prometheus and Grafana monitoring stack.</p>"},{"location":"operator-guide/tekton-monitoring/#prerequisites","title":"Prerequisites","text":"<p>Ensure the following requirements are met first before moving ahead:</p> <ul> <li>Kube prometheus stack is installed;</li> <li>Tekton pipeline is installed.</li> </ul>"},{"location":"operator-guide/tekton-monitoring/#create-and-apply-the-additional-scrape-config","title":"Create and Apply the Additional Scrape Config","text":"<p>To create and apply the additional scrape config, follow the steps below:</p> <ol> <li> <p>Create the kubernetes secret file with the additional scrape config:</p> additional-scrape-configs.yaml file<pre><code>apiVersion: v1\nkind: Secret\nmetadata:\n  name: additional-scrape-configs\nstringData:\n  prometheus-additional-job.yaml: |\n    - job_name: \"tekton-pipelines\"\n      scrape_interval: 30s\n      static_configs:\n      - targets: [\"tekton-pipelines-controller.&lt;tekton-pipelines-namespace&gt;.svc.cluster.local:9090\"]\n</code></pre> </li> <li> <p>Apply the created secret:</p> <pre><code>kubectl apply -f additional-scrape-configs.yaml -n &lt;monitoring-namespace&gt;\n</code></pre> </li> <li> <p>Update the prometheus stack:</p> <pre><code>helm update --install prometheus prometheus-community/kube-prometheus-stack --values values.yaml -n &lt;monitoring-namespace&gt;\n</code></pre> <p>The <code>values.yaml</code> file should have the following contents:</p> values.yaml file<pre><code>prometheus:\nprometheusSpec:\nadditionalScrapeConfigsSecret:\nenabled: true\nname: additional-scrape-configs\nkey: prometheus-additional-job.yaml\n</code></pre> </li> <li> <p>Download the EDP Tekton Pipeline dashboard:</p> <p> Import Grafana dashboard </p> <p>a. Click on the dashboard menu;</p> <p>b. In the dropdown menu, click the <code>+ Import</code> button;</p> <p>c. Select the created <code>edp-tekton-overview_rev1.json</code> file;</p> <p> Import Grafana dashboard: Options </p> <p>d. Type the name of the dashboard;</p> <p>e. Select the folder for the dashboard;</p> <p>f. Type the UID (set of eight numbers or letters and symbols);</p> <p>g. Click the <code>Import</code> button.</p> </li> </ol> <p>As soon as the dashboard procedure is completed, you can track the newcoming metrics in the dashboard menu:</p> <p> Tekton dashboard </p>"},{"location":"operator-guide/tekton-monitoring/#related-articles","title":"Related Articles","text":"<ul> <li>Install Tekton</li> <li>Install EDP</li> <li>Install via Helmfile</li> </ul>"},{"location":"operator-guide/tekton-overview/","title":"Tekton Overview","text":"<p>EPAM Delivery Platform provides Continuous Integration based on Tekton.</p> <p>Tekton is an open-source Kubernetes native framework for creating CI pipelines, allowing a user to compile, build and test applications.</p> <p>The edp-tekton GitHub repository provides all Tekton implementation logic on the platform. The Helm charts are used to deploy the resources inside the Kubernetes cluster. Tekton logic is decoupled into separate components:</p> <p> Edp-tekton components diagram </p> <p>The diagram above describes the following:</p> <ul> <li><code>Common-library</code> is the Helm chart of Library type which stores the common logic shareable across all Tekton pipelines. This library contains Helm templates that generate common Tekton resources.</li> </ul> <ul> <li><code>Pipelines-library</code> is the Helm chart of the Application type which stores the core logic for the EDP pipelines. Tekton CRs like Pipelines, Tasks, EventListeners, Triggers, TriggerTemplates, and other resources are delivered with this chart.</li> </ul> <ul> <li><code>Custom-pipelines</code> is the Helm chart of the Application type which implements custom logic running specifically for internal EDP development, for example, CI and Release. It also demonstrates the customization flow on the platform.</li> </ul> <ul> <li><code>Tekton-dashboard</code> is a multitenancy-adopted implementation of the upstream Tekton Dashboard. It is configured to share Tekton resources across a single namespace.</li> </ul> <ul> <li><code>EDP Interceptor</code> is the custom Tekton Interceptor which enriches the payload from the VCSs events with EDP data from the Codebase CR specification. These data are used to define the Pipeline logic.</li> </ul> <p>Inspect the schema below that describes the logic behind the Tekton functionality on the platform:</p> <p> Component view for the Tekton on EDP </p> <p>The platform logic consists of the following:</p> <ol> <li> <p>The <code>EventListener</code> exposes a dedicated Pod that runs the sink logic and receives incoming events from the VCSs (Gerrit, GitHub, GitLab) through the Ingress. It contains triggers with filtering and routing rules for incoming requests.</p> </li> <li> <p>Upon the Event Payload arrival, the <code>EventListener</code> runs triggers to process information or validate it via different interceptors.</p> </li> <li> <p>The <code>EDP Interceptor</code> extracts information from the codebases.v2.edp.epam.com CR and injects the received data into top-level 'extensions' field of the Event Payload. The Interceptor consists of running Pod and Service.</p> </li> <li> <p>The <code>Tekton Cel Interceptor</code> does simple transformations of the resulting data and prepares them for the Pipeline parameters substitution.</p> </li> <li> <p>The <code>TriggerTemplate</code> creates a PipelineRun instance with the required parameters extracted from the Event Payload by Interceptors. These parameters are mandatory for Pipelines.</p> </li> <li> <p>The <code>PipelineRun</code> has a mapping to the EDP Tekton Pipelines using a template approach which reduces code duplication. Each Pipeline is designed for a specific VCS (Gerrit, GitLab, GitHub), technology stack (such as Java or Python), and type (code-review, build).</p> </li> <li> <p>A <code>Pipeline</code> consists of separate EDP Tekton or open-source Tasks. They are arranged in a specific order of execution in the Pipeline.</p> </li> <li> <p>Each <code>Task</code> is executed as a Pod on the Kubernetes cluster. Also, Tasks can have a different number of steps that are executed as a Container in Pod.</p> </li> <li> <p>The Kubernetes native approach allows the creation of PipelineRun either with the kubectl tool or using the EDP Portal UI.</p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.10/","title":"Upgrade EDP v2.9 to 2.10","text":"<p>This section provides the details on the EDP upgrade to 2.10.2. Explore the actions and requirements below.</p> <p>Note</p> <p>Kiosk is optional for EDP v.2.9.0 and higher, and is enabled by default. To disable it, add the following parameter to the <code>values.yaml</code> file: <code>global.kioskEnabled: false</code>. Please refer to the Set Up Kiosk documentation for the details.</p> <p>Note</p> <p>In the process of updating the EDP, it is necessary to migrate the database for SonarQube, before performing the update procedure, please carefully read section 4 of this guide.</p> <ol> <li> <p>Before updating EDP to 2.10.2, delete SonarQube plugins by executing the following command in SonarQube pod:</p> <pre><code>rm -r /opt/sonarqube/extensions/plugins/*\n</code></pre> </li> <li> <p>Update Custom Resource Definitions. Run the following command to apply all the necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.10/deploy-templates/crds/v2_v1alpha1_jenkins_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakclient_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmcomponent_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmidentityprovider_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmrole_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloakrealmuser_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.10/deploy-templates/crds/v1_v1alpha1_keycloak_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.10/deploy-templates/crds/edp_v1alpha1_nexus_crd.yaml\n</code></pre> </li> <li> <p>To upgrade EDP to the v.2.10.2, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.10.2\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.10.2  --dry-run</code></p> </li> <li> <p>Migrate the database for SonarQube according to the official documentation.</p> <p>Note</p> <p>Please be aware of possible tables duplication for speeding up the migration process during the upgrade. Due to the duplication, the database disk usage can be temporarily increased to twice as the normal usage. Therefore, the recommended database disk usage is below 50% before the migration start.</p> <ul> <li> <p>Navigate to the project http://SonarQubeServerURL/setup link and follow the setup instructions:</p> <p> Migrate SonarQube database </p> </li> </ul> <ul> <li>Click the Upgrade button and wait for the end of the migration process.</li> </ul> </li> <li> <p>Remove the resources related to the deprecated Sonar Gerrit Plugin that is deleted in EDP 2.10.2:</p> <ul> <li>Remove Sonar Gerrit Plugin from Jenkins (go to Manage Jenkins -&gt; Manage Plugins -&gt; Installed -&gt; Uninstall Sonar Gerrit Plugin).</li> <li>In Gerrit, clone the All-Projects repository.</li> <li>Edit the project.config file in the All-Projects repository and remove the Sonar-Verified label declaration:<pre><code>[label \"Sonar-Verified\"]\nfunction = MaxWithBlock\nvalue = -1 Issues found\nvalue = 0 No score\nvalue = +1 Verified\ndefaultValue = 0\n</code></pre> </li> </ul> <ul> <li>Also, remove the following permissions for the Sonar-Verified label in the project.config file:<pre><code>label-Sonar-Verified = -1..+1 group Administrators\nlabel-Sonar-Verified = -1..+1 group Project Owners\nlabel-Sonar-Verified = -1..+1 group Service Users\n</code></pre> </li> </ul> <ul> <li>Save the changes, and commit and push the repository to HEAD:refs/meta/config bypassing the Gerrit code review:<pre><code>git push origin HEAD:refs/meta/config\n</code></pre> </li> </ul> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-codenarc-agent:1.0.1\nepamedp/edp-jenkins-dotnet-21-agent:1.0.5\nepamedp/edp-jenkins-dotnet-31-agent:1.0.4\nepamedp/edp-jenkins-go-agent:1.0.6\nepamedp/edp-jenkins-gradle-java8-agent:1.0.3\nepamedp/edp-jenkins-gradle-java11-agent:2.0.3\nepamedp/edp-jenkins-helm-agent:1.0.10\nepamedp/edp-jenkins-maven-java8-agent:1.0.3\nepamedp/edp-jenkins-maven-java11-agent:2.0.4\nepamedp/edp-jenkins-npm-agent:2.0.3\nepamedp/edp-jenkins-opa-agent:1.0.2\nepamedp/edp-jenkins-python-38-agent:2.0.4\nepamedp/edp-jenkins-terraform-agent:2.0.5\n</code></pre> </li> </ul> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Since EDP version v.2.10.x, the create-release.groovy, code-review.groovy, and build.groovy files are deprecated (<code>pipeline script from SCM</code> is replaced with <code>pipeline script</code>, see below).</p> <ul> <li>Pipeline script from SCM:    Pipeline script from scm example </li> </ul> <ul> <li>Pipeline script:     Pipeline script example </li> </ul> <ul> <li>Update the job-provisioner code and restart the codebase-operator pod. Consult the default job-provisioners code section.</li> </ul> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.10/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Set Up Kiosk</li> <li>SonarQube Upgrade Guide</li> </ul>"},{"location":"operator-guide/upgrade-edp-2.11/","title":"Upgrade EDP v2.10 to 2.11","text":"<p>This section provides the details on the EDP upgrade to 2.11. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions. Run the following command to apply all the necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.12/deploy-templates/crds/edp_v1alpha1_cd_stage_deploy_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.11/deploy-templates/crds/v2_v1alpha1_merge_request_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_user_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_cdpipeline_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.11/deploy-templates/crds/v2_v1alpha1_jenkinssharedlibrary_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.11/deploy-templates/crds/v2_v1alpha1_cdstagejenkinsdeployment_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.11/deploy-templates/crds/v1_v1alpha1_keycloakauthflow_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.11/deploy-templates/crds/v1_v1alpha1_keycloakrealmuser_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.12/deploy-templates/crds/edp_v1alpha1_codebaseimagestream_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.12/deploy-templates/crds/edp_v1alpha1_codebase_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_sonar_group_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.11/deploy-templates/crds/edp_v1alpha1_permission_template_crd.yaml\n</code></pre> </li> <li> <p>Backup kaniko-template config-map and then remove it. This component will be delivered during upgrade.</p> </li> <li> <p>Set required awsRegion parameter. Pay attention that the nesting of the kanikoRoleArn parameter has been changed to the kaniko.roleArn parameter. Check the parameters in the EDP installation chart. For details, please refer to the values.yaml file. To upgrade EDP to the v.2.11.x, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.11.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.11.x  --dry-run</code></p> </li> <li> <p>Update Sonar Project Key:</p> <p>Note</p> <p>Avoid using special characters when creating projects in SonarQube. Allowed characters are: <code>letters</code>, <code>numbers</code>, <code>-</code>, <code>_</code>, <code>.</code> and <code>:</code>, with at least one non-digit. For details, please refer to the SonarQube documentation. As the result, the project name will be: <code>project-name-release-0.0</code> or <code>project-name-branchName</code>.</p> <p>Such actions are required to be followed with the aim to store the SonarQube statistics from the previous EDP version:</p> <p>Warning</p> <p>Do not run any pipeline with the updated sonar stage on any existing application before the completion of the first step.</p> <p>4.1. Update the project key in SonarQube from old to new format by adding the default branch name.</p> <p>- Navigate to Project Settings -&gt; Update Key:   Update SonarQube project key    - Enter the default branch name and click Update:   Update SonarQube project key </p> <p>4.2. As the result, after the first run, the project name will be changed to a new format containing all previous statistics:</p> <p> SonarQube project history activity </p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>  kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-codenarc-agent:3.0.4\nepamedp/edp-jenkins-dotnet-21-agent:3.0.4\nepamedp/edp-jenkins-dotnet-31-agent:3.0.3\nepamedp/edp-jenkins-go-agent:3.0.5\nepamedp/edp-jenkins-gradle-java11-agent:3.0.2\nepamedp/edp-jenkins-gradle-java8-agent:3.0.2\nepamedp/edp-jenkins-helm-agent:3.0.3\nepamedp/edp-jenkins-maven-java11-agent:3.0.3\nepamedp/edp-jenkins-maven-java8-agent:3.0.3\nepamedp/edp-jenkins-npm-agent:3.0.4\nepamedp/edp-jenkins-opa-agent:3.0.2\nepamedp/edp-jenkins-python-38-agent:3.0.2\nepamedp/edp-jenkins-terraform-agent:3.0.3\n</code></pre> </li> </ul> <ul> <li> <p>Add Jenkins agent by following the template:</p> <p> View: values.yaml <pre><code>kaniko-docker-template: |-\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;kaniko-docker&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;kaniko-docker&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-kaniko-docker-agent:1.0.4&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <ul> <li>Restart the Jenkins pod.</li> </ul> <li> <p>Update the Jenkins plugins with the 'pipeline' name and 'HTTP Request Plugin'.</p> </li> <li> <p>Update Jenkins provisioners according to the Manage Jenkins CI Pipeline Job Provisioner and Manage Jenkins CD Pipeline Job Provisioner documentation.</p> </li> <li> <p>Restart the codebase-operator to recreate the Code-review and Build pipelines for codebases.</p> </li> <li>Run the CD job-provisioners for every CD pipeline to align the CD stages.</li>"},{"location":"operator-guide/upgrade-edp-2.12/","title":"Upgrade EDP v2.11 to 2.12","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to 2.12. Explore the actions and requirements below.</p> <p>Notes</p> <ul> <li>EDP now supports Kubernetes 1.22: Ingress Resources use <code>networking.k8s.io/v1</code>, and Ingress Operators use CustomResourceDefinition <code>apiextensions.k8s.io/v1</code>.</li> <li>EDP Team now delivers its own Gerrit Docker image: epamedp/edp-gerrit. It is based on the openfrontier Gerrit Docker image.</li> </ul> <ol> <li> <p>EDP now uses DefectDojo as a SAST tool. It is mandatory to deploy DefectDojo before updating EDP to v.2.12.x.</p> </li> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-admin-console-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_adminconsoles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_cdpipelines.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_cdstagedeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_cdstagejenkinsdeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-component-operator/release/0.12/deploy-templates/crds/v1.edp.epam.com_edpcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritgroupmembers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritmergerequests.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritprojectaccesses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritprojects.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerritreplicationconfigs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_gittags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_imagestreamtags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsagents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationrolemappings.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsfolders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsjobbuildruns.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsjobs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsscripts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinsserviceaccounts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_jenkinssharedlibraries.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_jiraissuemetadatas.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.13/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakauthflows.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakclients.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakclientscopes.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmidentityproviders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmrolebatches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloakrealmusers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.12/deploy-templates/crds/v1.edp.epam.com_keycloaks.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_nexuses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_nexususers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfdatasourcegitlabs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfdatasourcejenkinses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfdatasourcesonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_perfservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_sonargroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_sonarpermissiontemplates.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_sonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.12/deploy-templates/crds/v2.edp.epam.com_stages.yaml\n</code></pre> </li> <li> <p>Set the required parameters. For details, please refer to the values.yaml file.</p> <ul> <li>In version v.2.12.x, EDP contains Gerrit <code>v3.6.1</code>. According to the Official Gerrit Upgrade flow, a user must initially upgrade to Gerrit <code>v3.5.2</code>, and then upgrade to <code>v3.6.1</code>. Therefore, define the <code>gerrit-operator.gerrit.version=3.5.2</code> value in the edp-install <code>values.yaml</code> file.</li> </ul> <ul> <li> <p>Two more components are available with the new functionality:</p> <ul> <li><code>edp-argocd-operator</code></li> <li><code>external-secrets</code></li> </ul> </li> </ul> <ul> <li>If there is no need to use these new operators, define <code>false</code> values for them in the existing <code>value.yaml</code> file:<p> View: values.yaml <pre><code>gerrit-operator:\ngerrit:\nversion: \"3.5.2\"\nexternalSecrets:\nenabled: false\nargocd:\nenabled: false\n</code></pre> <li> <p>The <code>edp-jenkins-role</code> is renamed to the <code>jenkins-resources-role</code>. Delete the <code>edp-jenkins-role</code> with the following command:</p> <pre><code>  kubectl delete role edp-jenkins-role -n &lt;edp-namespace&gt;\n</code></pre> <p>The <code>jenkins-resources-role</code> role will be created automatically while EDP upgrade.</p> </li> <li> <p>Recreate the <code>edp-jenkins-resources-permissions</code> RoleBinding according to the following template:</p> <p> View: jenkins-resources-role <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\nname: edp-jenkins-resources-permissions\nnamespace: &lt;edp-namespace&gt;\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: Role\nname: jenkins-resources-role\n</code></pre> <li> <p>To upgrade EDP to the v.2.12.x, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x  --dry-run</code></p> </li> <li> <p>After the update, please remove the <code>gerrit-operator.gerrit.version</code> value. In this case, the default value will be used, and Gerrit will be updated to the <code>v3.6.1</code> version. Run the following command:</p> <pre><code>  helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.x  --dry-run</code></p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>  kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images must be the following:<pre><code>epamedp/edp-jenkins-codenarc-agent:3.0.8\nepamedp/edp-jenkins-dotnet-21-agent:3.0.7\nepamedp/edp-jenkins-dotnet-31-agent:3.0.7\nepamedp/edp-jenkins-go-agent:3.0.11\nepamedp/edp-jenkins-gradle-java11-agent:3.0.5\nepamedp/edp-jenkins-gradle-java8-agent:3.0.7\nepamedp/edp-jenkins-helm-agent:3.0.8\nepamedp/edp-jenkins-maven-java11-agent:3.0.6\nepamedp/edp-jenkins-maven-java8-agent:3.0.8\nepamedp/edp-jenkins-npm-agent:3.0.7\nepamedp/edp-jenkins-opa-agent:3.0.5\nepamedp/edp-jenkins-python-38-agent:3.0.5\nepamedp/edp-jenkins-terraform-agent:3.0.6\n</code></pre> </li> </ul> <ul> <li> <p>Add Jenkins agents by following the template:</p> <p> View: jenkins-slaves <pre><code>  sast-template: |\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;sast&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;sast&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-sast-agent:0.1.3&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <ul> <li> <p>If required, update the requests and limits for the following Jenkins agents:</p> <ul> <li><code>edp-jenkins-codenarc-agent</code></li> <li><code>edp-jenkins-go-agent</code></li> <li><code>edp-jenkins-gradle-java11-agent</code></li> <li><code>edp-jenkins-gradle-java8-agent</code></li> <li><code>edp-jenkins-maven-java11-agent</code></li> <li><code>edp-jenkins-maven-java8-agent</code></li> <li><code>edp-jenkins-npm-agent</code></li> <li><code>edp-jenkins-dotnet-21-agent</code></li> <li><code>edp-jenkins-dotnet-31-agent</code></li> </ul> <p>EDP requires to start with the following values:</p> <p> View: jenkins-slaves <pre><code>  &lt;resourceRequestCpu&gt;500m&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;1Gi&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;2&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;5Gi&lt;/resourceLimitMemory&gt;\n</code></pre> <ul> <li>Restart the Jenkins pod.</li> </ul> <li> <p>Update Jenkins provisioners according to the Manage Jenkins CI Pipeline Job Provisioner instruction.</p> </li> <li> <p>Restart the <code>codebase-operator</code>, to recreate the Code Review and Build pipelines for the codebases.</p> </li> <p>Warning</p> <p>In case there are different EDP versions on one cluster, the following error may occur on the <code>init</code> stage of Jenkins Groovy pipeline: <code>java.lang.NumberFormatException: For input string: \"\"</code>. To fix this issue, please run the following command using <code>kubectl</code> v1.24.4+:</p> <pre><code>kubectl patch codebasebranches.v2.edp.epam.com &lt;codebase-branch-name&gt;  -n &lt;edp-namespace&gt;  '--subresource=status' '--type=merge' -p '{\"status\": {\"build\": \"0\"}}'\n</code></pre>"},{"location":"operator-guide/upgrade-edp-2.12/#upgrade-edp-to-2122","title":"Upgrade EDP to 2.12.2","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to 2.12.2. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.12.2/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.12.1/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\n</code></pre> </li> <li> <p>To upgrade EDP to 2.12.2, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.2\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.12.2  --dry-run</code></p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.8/","title":"Upgrade EDP v2.7 to 2.8","text":"<p>This section provides the details on the EDP upgrade to 2.8.4. Explore the actions and requirements below.</p> <p>Note</p> <p>Kiosk is implemented and mandatory for EDP v.2.8.4 and is optional for EDP v.2.9.0 and higher.</p> <p>To upgrade EDP to 2.8.4, take the following steps:</p> <ol> <li> <p>Deploy and configure Kiosk (create a Service Account, Account, and ClusterRoleBinging) according to the Set Up Kiosk documentation.</p> <ul> <li>Update the spec field in the Kiosk space:<pre><code>apiVersion: tenancy.kiosk.sh/v1alpha1\nkind: Space\nmetadata:\nname: &lt;edp-project&gt;\nspec:\naccount: &lt;edp-project&gt;-admin\n</code></pre> </li> </ul> <ul> <li> <p>Create RoleBinding (required for namespaces created before using Kiosk):</p> <p>Note</p> <p>In the uid field under the ownerReferences in the Kubernetes manifest, indicate the Account Custom Resource ID from accounts.config.kiosk.sh <code>kubectl get account &lt;edp-project&gt;-admin -o=custom-columns=NAME:.metadata.uid --no-headers=true</code></p> <p> View: rolebinding-kiosk.yaml <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\ngenerateName: &lt;edp-project&gt;-admin-\nnamespace: &lt;edp-project&gt;\nownerReferences:\n- apiVersion: config.kiosk.sh/v1alpha1\nblockOwnerDeletion: true\ncontroller: true\nkind: Account\nname: &lt;edp-project&gt;-admin\nuid: ''\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: ClusterRole\nname: kiosk-space-admin\nsubjects:\n- kind: ServiceAccount\nname: &lt;edp-project&gt;\nnamespace: security\n</code></pre> <pre><code>kubectl create -f rolebinding-kiosk.yaml\n</code></pre> <li> <p>With Amazon Elastic Container Registry to store the images, there are two options:</p> <ul> <li>Enable IRSA and create AWS IAM Role for Kaniko image builder. Please refer to the IAM Roles for Kaniko Service Accounts section for the details.</li> <li>The Amazon Elastic Container Registry Roles can be stored in an instance profile.</li> </ul> </li> <li> <p>Update Custom Resource Definitions by applying all the necessary CRD to the cluster with the command below:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_cdpipeline_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_codebase_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_cd_stage_deploy_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.8/deploy-templates/crds/v2_v1alpha1_jenkinsjobbuildrun_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.8/deploy-templates/crds/v2_v1alpha1_cdstagejenkinsdeployment_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.8/deploy-templates/crds/v2_v1alpha1_jenkinsjob_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.8/deploy-templates/crds/edp_v1alpha1_nexus_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.8/deploy-templates/crds/v1_v1alpha1_keycloakauthflow_crd.yaml\n</code></pre> </li> <li> <p>With Amazon Elastic Container Registry to store and Kaniko to build the images, add the kanikoRoleArn parameter to the values before starting the update process. This parameter is indicated in AWS Roles once IRSA is enabled and AWS IAM Role is created for Kaniko. The value should look as follows:</p> <pre><code>kanikoRoleArn: arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\n</code></pre> </li> <li> <p>To upgrade EDP to the v.2.8.4, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.8.4\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.8.4  --dry-run</code></p> </li> <li> <p>Remove the following Kubernetes resources left from the previous EDP installation (it is optional):</p> <pre><code>kubectl delete cm luminatesec-conf -n &lt;edp-namespace&gt;\nkubectl delete sa edp edp-perf-operator -n &lt;edp-namespace&gt;\nkubectl delete deployment perf-operator -n &lt;edp-namespace&gt;\nkubectl delete clusterrole edp-&lt;edp-namespace&gt; edp-perf-operator-&lt;edp-namespace&gt;\nkubectl delete clusterrolebinding edp-&lt;edp-namespace&gt; edp-perf-operator-&lt;edp-namespace&gt;\nkubectl delete rolebinding edp-&lt;edp-namespace&gt; edp-perf-operator-&lt;edp-namespace&gt;-admin -n &lt;edp-namespace&gt;\nkubectl delete perfserver epam-perf -n &lt;edp-namespace&gt;\nkubectl delete services.v2.edp.epam.com postgres rabbit-mq -n &lt;edp-namespace&gt;\n</code></pre> </li> <li> <p>Update the CI and CD Jenkins job provisioners:</p> <p>Note</p> <p>Please refer to the Manage Jenkins CI Pipeline Job Provisioner section for the details.</p> View: Default CI provisioner template for EDP 2.8.4 <pre><code>/* Copyright 2021 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\nimport hudson.model.*\n\nJenkins jenkins = Jenkins.instance\ndef stages = [:]\ndef jiraIntegrationEnabled = Boolean.parseBoolean(\"${JIRA_INTEGRATION_ENABLED}\" as String)\ndef commitValidateStage = jiraIntegrationEnabled ? ',{\"name\": \"commit-validate\"}' : ''\ndef createJIMStage = jiraIntegrationEnabled ? ',{\"name\": \"create-jira-issue-metadata\"}' : ''\ndef buildTool = \"${BUILD_TOOL}\"\ndef goBuildStage = buildTool.toString() == \"go\" ? ',{\"name\": \"build\"}' : ',{\"name\": \"compile\"}'\n\nstages['Code-review-application'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + goBuildStage +\n',{\"name\": \"tests\"},[{\"name\": \"sonar\"},{\"name\": \"dockerfile-lint\"},{\"name\": \"helm-lint\"}]]'\nstages['Code-review-library'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"compile\"},{\"name\": \"tests\"},' +\n'{\"name\": \"sonar\"}]'\nstages['Code-review-autotests'] = '[{\"name\": \"gerrit-checkout\"},{\"name\": \"get-version\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"},{\"name\": \"sonar\"}' + \"${createJIMStage}\" + ']'\nstages['Code-review-default'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" + ']'\nstages['Code-review-library-terraform'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"terraform-lint\"}]'\nstages['Code-review-library-opa'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"tests\"}]'\nstages['Code-review-library-codenarc'] = '[{\"name\": \"gerrit-checkout\"}' + \"${commitValidateStage}\" +\n',{\"name\": \"sonar\"},{\"name\": \"build\"}]'\n\nstages['Build-library-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"build\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-npm'] = stages['Build-library-maven']\nstages['Build-library-gradle'] = stages['Build-library-maven']\nstages['Build-library-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-terraform'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"terraform-lint\"}' +\n',{\"name\": \"terraform-plan\"},{\"name\": \"terraform-apply\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-opa'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"tests\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-library-codenarc'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"sonar\"},{\"name\": \"build\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n\n\nstages['Build-application-maven'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},[{\"name\": \"sonar\"}],{\"name\": \"build\"},{\"name\": \"build-image-kaniko\"},' +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-npm'] = stages['Build-application-maven']\nstages['Build-application-gradle'] = stages['Build-application-maven']\nstages['Build-application-dotnet'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},[{\"name\": \"sonar\"}],{\"name\": \"build-image-kaniko\"},' +\n'{\"name\": \"push\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-go'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build\"},{\"name\": \"build-image-kaniko\"}' +\n\"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\nstages['Build-application-python'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"},{\"name\": \"compile\"},' +\n'{\"name\": \"tests\"},{\"name\": \"sonar\"},' +\n'{\"name\": \"build-image-kaniko\"},{\"name\": \"push\"}' + \"${createJIMStage}\" +\n',{\"name\": \"git-tag\"}]'\n\nstages['Create-release'] = '[{\"name\": \"checkout\"},{\"name\": \"create-branch\"},{\"name\": \"trigger-job\"}]'\n\ndef defaultBuild = '[{\"name\": \"checkout\"}' + \"${createJIMStage}\" + ']'\n\ndef codebaseName = \"${NAME}\"\ndef gitServerCrName = \"${GIT_SERVER_CR_NAME}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID ? GIT_CREDENTIALS_ID : 'gerrit-ciuser-sshkey'}\"\ndef repositoryPath = \"${REPOSITORY_PATH}\"\ndef defaultBranch = \"${DEFAULT_BRANCH}\"\n\ndef codebaseFolder = jenkins.getItem(codebaseName)\nif (codebaseFolder == null) {\nfolder(codebaseName)\n}\n\ncreateListView(codebaseName, \"Releases\")\ncreateReleasePipeline(\"Create-release-${codebaseName}\", codebaseName, stages[\"Create-release\"], \"create-release.groovy\",\nrepositoryPath, gitCredentialsId, gitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, defaultBranch)\n\nif (buildTool.toString().equalsIgnoreCase('none')) {\nreturn true\n}\n\nif (BRANCH) {\ndef branch = \"${BRANCH}\"\ndef formattedBranch = \"${branch.toUpperCase().replaceAll(/\\\\//, \"-\")}\"\ncreateListView(codebaseName, formattedBranch)\n\ndef type = \"${TYPE}\"\ndef crKey = getStageKeyName(buildTool)\ncreateCiPipeline(\"Code-review-${codebaseName}\", codebaseName, stages[crKey], \"code-review.groovy\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\ndef buildKey = \"Build-${type}-${buildTool.toLowerCase()}\".toString()\nif (type.equalsIgnoreCase('application') || type.equalsIgnoreCase('library')) {\ndef jobExists = false\nif(\"${formattedBranch}-Build-${codebaseName}\".toString() in Jenkins.instance.getAllItems().collect{it.name})\njobExists = true\n\ncreateCiPipeline(\"Build-${codebaseName}\", codebaseName, stages.get(buildKey, defaultBuild), \"build.groovy\",\nrepositoryPath, gitCredentialsId, branch, gitServerCrName, gitServerCrVersion)\n\nif(!jobExists)\nqueue(\"${codebaseName}/${formattedBranch}-Build-${codebaseName}\")\n}\n}\n\ndef createCiPipeline(pipelineName, codebaseName, codebaseStages, pipelineScript, repository, credId, watchBranch, gitServerCrName, gitServerCrVersion) {\npipelineJob(\"${codebaseName}/${watchBranch.toUpperCase().replaceAll(/\\\\//, \"-\")}-${pipelineName}\") {\nlogRotator {\nnumToKeep(10)\ndaysToKeep(7)\n}\ntriggers {\ngerrit {\nevents {\nif (pipelineName.contains(\"Build\"))\nchangeMerged()\nelse\npatchsetCreated()\n}\nproject(\"plain:${codebaseName}\", [\"plain:${watchBranch}\"])\n}\n}\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(repository)\ncredentials(credId)\n}\nbranches(\"${watchBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${codebaseStages}\", \"Consequence of stages in JSON format to be run during execution\")\nstringParam(\"GERRIT_PROJECT_NAME\", \"${codebaseName}\", \"Gerrit project name(Codebase name) to be build\")\nstringParam(\"BRANCH\", \"${watchBranch}\", \"Branch to build artifact from\")\n}\n}\n}\n}\n}\n\ndef getStageKeyName(buildTool) {\nif (buildTool.toString().equalsIgnoreCase('terraform')) {\nreturn \"Code-review-library-terraform\"\n}\nif (buildTool.toString().equalsIgnoreCase('opa')) {\nreturn \"Code-review-library-opa\"\n}\nif (buildTool.toString().equalsIgnoreCase('codenarc')) {\nreturn \"Code-review-library-codenarc\"\n}\ndef buildToolsOutOfTheBox = [\"maven\",\"npm\",\"gradle\",\"dotnet\",\"none\",\"go\",\"python\"]\ndef supBuildTool = buildToolsOutOfTheBox.contains(buildTool.toString())\nreturn supBuildTool ? \"Code-review-${TYPE}\" : \"Code-review-default\"\n}\n\ndef createReleasePipeline(pipelineName, codebaseName, codebaseStages, pipelineScript, repository, credId,\ngitServerCrName, gitServerCrVersion, jiraIntegrationEnabled, defaultBranch) {\npipelineJob(\"${codebaseName}/${pipelineName}\") {\nlogRotator {\nnumToKeep(14)\ndaysToKeep(30)\n}\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(repository)\ncredentials(credId)\n}\nbranches(\"${defaultBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\nparameters {\nstringParam(\"STAGES\", \"${codebaseStages}\", \"\")\nif (pipelineName.contains(\"Create-release\")) {\nstringParam(\"JIRA_INTEGRATION_ENABLED\", \"${jiraIntegrationEnabled}\", \"Is Jira integration enabled\")\nstringParam(\"GERRIT_PROJECT\", \"${codebaseName}\", \"\")\nstringParam(\"RELEASE_NAME\", \"\", \"Name of the release(branch to be created)\")\nstringParam(\"COMMIT_ID\", \"\", \"Commit ID that will be used to create branch from for new release. If empty, HEAD of master will be used\")\nstringParam(\"GIT_SERVER_CR_NAME\", \"${gitServerCrName}\", \"Name of Git Server CR to generate link to Git server\")\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"REPOSITORY_PATH\", \"${repository}\", \"Full repository path\")\nstringParam(\"DEFAULT_BRANCH\", \"${defaultBranch}\", \"Default repository branch\")\n}\n}\n}\n}\n}\n}\n\ndef createListView(codebaseName, branchName) {\nlistView(\"${codebaseName}/${branchName}\") {\nif (branchName.toLowerCase() == \"releases\") {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^Create-release.*\")\n}\n}\n} else {\njobFilters {\nregex {\nmatchType(MatchType.INCLUDE_MATCHED)\nmatchValue(RegexMatchValue.NAME)\nregex(\"^${branchName}-(Code-review|Build).*\")\n}\n}\n}\ncolumns {\nstatus()\nweather()\nname()\nlastSuccess()\nlastFailure()\nlastDuration()\nbuildButton()\n}\n}\n}\n</code></pre> <p>Note</p> <p>Please refer to the Manage Jenkins CD Pipeline Job Provisioner page for the details.</p> View: Default CD provisioner template for EDP 2.8.4 <pre><code>/* Copyright 2021 EPAM Systems.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\nhttp://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n\nSee the License for the specific language governing permissions and\nlimitations under the License. */\n\nimport groovy.json.*\nimport jenkins.model.Jenkins\n\nJenkins jenkins = Jenkins.instance\n\ndef pipelineName = \"${PIPELINE_NAME}-cd-pipeline\"\ndef stageName = \"${STAGE_NAME}\"\ndef qgStages = \"${QG_STAGES}\"\ndef gitServerCrVersion = \"${GIT_SERVER_CR_VERSION}\"\ndef gitCredentialsId = \"${GIT_CREDENTIALS_ID}\"\ndef sourceType = \"${SOURCE_TYPE}\"\ndef libraryURL = \"${LIBRARY_URL}\"\ndef libraryBranch = \"${LIBRARY_BRANCH}\"\ndef autodeploy = \"${AUTODEPLOY}\"\ndef scriptPath = \"Jenkinsfile\"\ndef containerDeploymentType = \"container\"\ndef deploymentType = \"${DEPLOYMENT_TYPE}\"\n\ndef stages = buildStages(deploymentType, containerDeploymentType, qgStages)\n\ndef codebaseFolder = jenkins.getItem(pipelineName)\nif (codebaseFolder == null) {\nfolder(pipelineName)\n}\n\nif (deploymentType == containerDeploymentType) {\ncreateContainerizedCdPipeline(pipelineName, stageName, stages, scriptPath, sourceType,\nlibraryURL, libraryBranch, gitCredentialsId, gitServerCrVersion,\nautodeploy)\n} else {\ncreateCustomCdPipeline(pipelineName, stageName)\n}\n\ndef buildStages(deploymentType, containerDeploymentType, qgStages) {\nreturn deploymentType == containerDeploymentType\n? '[{\"name\":\"init\",\"step_name\":\"init\"},{\"name\":\"deploy\",\"step_name\":\"deploy\"},' + qgStages + ',{\"name\":\"promote-images-ecr\",\"step_name\":\"promote-images\"}]'\n: ''\n}\n\ndef createContainerizedCdPipeline(pipelineName, stageName, stages, pipelineScript, sourceType, libraryURL, libraryBranch, libraryCredId, gitServerCrVersion, autodeploy) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nif (sourceType == \"library\") {\ndefinition {\ncpsScm {\nscm {\ngit {\nremote {\nurl(libraryURL)\ncredentials(libraryCredId)\n}\nbranches(\"${libraryBranch}\")\nscriptPath(\"${pipelineScript}\")\n}\n}\n}\n}\n} else {\ndefinition {\ncps {\nscript(\"@Library(['edp-library-stages', 'edp-library-pipelines']) _ \\n\\nDeploy()\")\nsandbox(true)\n}\n}\n}\nproperties {\ndisableConcurrentBuilds()\n}\nparameters {\nstringParam(\"GIT_SERVER_CR_VERSION\", \"${gitServerCrVersion}\", \"Version of GitServer CR Resource\")\nstringParam(\"STAGES\", \"${stages}\", \"Consequence of stages in JSON format to be run during execution\")\n\nif (autodeploy?.trim() &amp;&amp; autodeploy.toBoolean()) {\nstringParam(\"AUTODEPLOY\", \"${autodeploy}\", \"Is autodeploy enabled?\")\nstringParam(\"CODEBASE_VERSION\", null, \"Codebase versions to deploy.\")\n}\n}\n}\n}\n\ndef createCustomCdPipeline(pipelineName, stageName) {\npipelineJob(\"${pipelineName}/${stageName}\") {\nproperties {\ndisableConcurrentBuilds()\n}\n}\n}\n</code></pre> <ul> <li>It is also necessary to add the string parameter DEPLOYMENT_TYPE to the CD provisioner:<ul> <li>Go to job-provisions - &gt; cd -&gt; default -&gt; configure;</li> <li>Add Parameter - &gt; String parameter;</li> <li>Name -&gt; DEPLOYMENT_TYPE</li> </ul> </li> </ul> </li> <li> <p>Update Jenkins pipelines and stages to the new release tag:</p> <ul> <li>In Jenkins, go to Manage Jenkins -&gt; Configure system -&gt; Find the Global Pipeline Libraries menu.</li> <li>Change the Default version for edp-library-stages from build/2.8.0-RC.6 to build/2.9.0-RC.5</li> <li>Change the Default version for edp-library-pipelines from build/2.8.0-RC.4 to build/2.9.0-RC.3</li> </ul> </li> <li> <p>Update the edp-admin-console Custom Resource in the KeycloakClient Custom Resource Definition:</p> View: keycloakclient.yaml <pre><code>kind: KeycloakClient\napiVersion: v1.edp.epam.com/v1alpha1\nmetadata:\nname: edp-admin-console\nnamespace: &lt;edp-namespace&gt;\nspec:\nadvancedProtocolMappers: false\nattributes: null\naudRequired: true\nclientId: admin-console-client\ndirectAccess: true\npublic: false\nsecret: admin-console-client\nserviceAccount:\nenabled: true\nrealmRoles:\n- developer\ntargetRealm: &lt;keycloak-edp-realm&gt;\nwebUrl: &gt;-\nhttps://edp-admin-console-example.com\n</code></pre> <pre><code>kubectl apply -f keycloakclient.yaml\n</code></pre> </li> <li> <p>Remove the admin-console-client client ID in the edp-namespace-main realm in Keycloak, restart the keycloak-operator pod and check that the new KeycloakClient is created with the confidential access type.</p> <p>Note</p> <p>If \"Internal error\" occurs, regenerate the admin-console-client secret in the Credentials tab in Keycloak and update the admin-console-client secret key \"clientSecret\" and \"password\".</p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-dotnet-21-agent:1.0.2\nepamedp/edp-jenkins-dotnet-31-agent:1.0.2\nepamedp/edp-jenkins-go-agent:1.0.3\nepamedp/edp-jenkins-gradle-java11-agent:2.0.2\nepamedp/edp-jenkins-gradle-java8-agent:1.0.2\nepamedp/edp-jenkins-helm-agent:1.0.6\nepamedp/edp-jenkins-maven-java11-agent:2.0.3\nepamedp/edp-jenkins-maven-java8-agent:1.0.2\nepamedp/edp-jenkins-npm-agent:2.0.2\nepamedp/edp-jenkins-python-38-agent:2.0.3\nepamedp/edp-jenkins-terraform-agent:2.0.4\n</code></pre> </li> </ul> <ul> <li>Add new Jenkins agents under the data field:</li> </ul> View <pre><code>data:\ncodenarc-template: |-\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;codenarc&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;codenarc&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-codenarc-agent:1.0.0&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\nopa-template: |-\n&lt;org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n&lt;inheritFrom&gt;&lt;/inheritFrom&gt;\n&lt;name&gt;opa&lt;/name&gt;\n&lt;namespace&gt;&lt;/namespace&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;instanceCap&gt;2147483647&lt;/instanceCap&gt;\n&lt;slaveConnectTimeout&gt;100&lt;/slaveConnectTimeout&gt;\n&lt;idleMinutes&gt;5&lt;/idleMinutes&gt;\n&lt;activeDeadlineSeconds&gt;0&lt;/activeDeadlineSeconds&gt;\n&lt;label&gt;opa&lt;/label&gt;\n&lt;serviceAccount&gt;jenkins&lt;/serviceAccount&gt;\n&lt;nodeSelector&gt;beta.kubernetes.io/os=linux&lt;/nodeSelector&gt;\n&lt;nodeUsageMode&gt;NORMAL&lt;/nodeUsageMode&gt;\n&lt;workspaceVolume class=\"org.csanchez.jenkins.plugins.kubernetes.volumes.workspace.EmptyDirWorkspaceVolume\"&gt;\n&lt;memory&gt;false&lt;/memory&gt;\n&lt;/workspaceVolume&gt;\n&lt;volumes/&gt;\n&lt;containers&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;name&gt;jnlp&lt;/name&gt;\n&lt;image&gt;epamedp/edp-jenkins-opa-agent:1.0.1&lt;/image&gt;\n&lt;privileged&gt;false&lt;/privileged&gt;\n&lt;alwaysPullImage&gt;false&lt;/alwaysPullImage&gt;\n&lt;workingDir&gt;/tmp&lt;/workingDir&gt;\n&lt;command&gt;&lt;/command&gt;\n&lt;args&gt;${computer.jnlpmac} ${computer.name}&lt;/args&gt;\n&lt;ttyEnabled&gt;false&lt;/ttyEnabled&gt;\n&lt;resourceRequestCpu&gt;&lt;/resourceRequestCpu&gt;\n&lt;resourceRequestMemory&gt;&lt;/resourceRequestMemory&gt;\n&lt;resourceLimitCpu&gt;&lt;/resourceLimitCpu&gt;\n&lt;resourceLimitMemory&gt;&lt;/resourceLimitMemory&gt;\n&lt;envVars&gt;\n&lt;org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;key&gt;JAVA_TOOL_OPTIONS&lt;/key&gt;\n&lt;value&gt;-XX:+UnlockExperimentalVMOptions -Dsun.zip.disableMemoryMapping=true&lt;/value&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.model.KeyValueEnvVar&gt;\n&lt;/envVars&gt;\n&lt;ports/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.ContainerTemplate&gt;\n&lt;/containers&gt;\n&lt;envVars/&gt;\n&lt;annotations/&gt;\n&lt;imagePullSecrets/&gt;\n&lt;podRetention class=\"org.csanchez.jenkins.plugins.kubernetes.pod.retention.Default\"/&gt;\n&lt;/org.csanchez.jenkins.plugins.kubernetes.PodTemplate&gt;\n</code></pre> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Update compatible plugins in Jenkins and install additional plugins:</p> <ul> <li>Go to Manage Jenkins -&gt; Manage Plugins -&gt; Select Compatible -&gt; Click Download now and install after restart</li> <li>Install the following additional plugins (click the Available plugins tab in Jenkins):<ul> <li>Groovy Postbuild</li> <li>CloudBees AWS Credentials</li> <li>Badge</li> <li>Timestamper</li> </ul> </li> </ul> </li> <li> <p>Add the annotation <code>deploy.edp.epam.com/previous-stage-name: ''</code> (it should be empty if the CD pipeline contains one stage) to each Custom Resource in the Custom Resource Definition Stage, for example:</p> <ul> <li>List all Custom Resources in Stage: <code>kubectl get stages.v2.edp.epam.com -n &lt;edp-namespace&gt;</code></li> </ul> <ul> <li>Edit resources: <code>kubectl edit stages.v2.edp.epam.com &lt;cd-stage-name&gt; -n &lt;edp-namespace&gt;</code><pre><code>apiVersion: v2.edp.epam.com/v1alpha1\nkind: Stage\nmetadata:\nannotations:\ndeploy.edp.epam.com/previous-stage-name: ''\n</code></pre> </li> </ul> <p>Note</p> <p>If a pipeline contains several stages, add a previous stage name indicated in the EDP Admin Console to the annotation, for example: <code>deploy.edp.epam.com/previous-stage-name: 'dev'</code>.</p> </li> <li> <p>Execute script to align CDPipeline resources to the new API (jq command-line JSON processor is required):</p> <pre><code>pipelines=$( kubectl get cdpipelines -n &lt;edp-namespace&gt; -ojson | jq -c '.items[]' )\nfor p in $pipelines; do\necho \"$p\" | \\\n    jq '. | .spec.inputDockerStreams = .spec.input_docker_streams | del(.spec.input_docker_streams) | .spec += { \"deploymentType\": \"container\" } ' | \\\n    kubectl apply -f -\ndone\n</code></pre> </li> <li> <p>Update the database in the edp-db pod in the edp-namespace:</p> <ul> <li>Log in to the pod:<pre><code>kubectl exec -i -t -n &lt;edp-namespace&gt; edp-db-&lt;pod&gt; -c edp-db \"--\" sh -c \"(bash || ash || sh)\"\n</code></pre> </li> </ul> <ul> <li>Log in to the Postgress DB (where \"admin\" is the user the secret was created for):<pre><code>psql edp-db &lt;admin&gt;;\nSET search_path to '&lt;edp-namespace&gt;';\nUPDATE cd_pipeline SET deployment_type = 'container';\n</code></pre> </li> </ul> </li> <li> <p>Add <code>\"AUTODEPLOY\":\"true/false\",\"DEPLOYMENT_TYPE\":\"container\"</code> to every Custom Resource in <code>jenkinsjobs.v2.edp.epam.com</code>:</p> <ul> <li>Edit Kubernetes resources:<pre><code>kubectl get jenkinsjobs.v2.edp.epam.com -n &lt;edp-namespace&gt;\n\nkubectl edit jenkinsjobs.v2.edp.epam.com &lt;cd-pipeline-name&gt; -n &lt;edp-namespace&gt;\n</code></pre> </li> </ul> <ul> <li>Alternatively, use this script to update all the necessary jenkinsjobs Custom Resources:<pre><code>edp_namespace=&lt;epd_namespace&gt;\nfor stages in $(kubectl get jenkinsjobs -o=name -n $edp_namespace); do kubectl get $stages -n $edp_namespace -o yaml | grep -q \"container\" &amp;&amp; echo -e \"\\n$stages is already updated\" || kubectl get $stages -n $edp_namespace -o yaml | sed 's/\"GIT_SERVER_CR_VERSION\"/\"AUTODEPLOY\":\"false\",\"DEPLOYMENT_TYPE\":\"container\",\"GIT_SERVER_CR_VERSION\"/g' | kubectl apply -f -; done\n</code></pre> </li> </ul> <ul> <li>Make sure the edited resource looks as follows:<pre><code>job:\nconfig: '{\"AUTODEPLOY\":\"false\",\"DEPLOYMENT_TYPE\":\"container\",\"GIT_SERVER_CR_VERSION\":\"v2\",\"PIPELINE_NAME\":\"your-pipeline-name\",\"QG_STAGES\":\"{\\\"name\\\":\\\"manual\\\",\\\"step_name\\\":\\\"your-step-name\\\"}\",\"SOURCE_TYPE\":\"default\",\"STAGE_NAME\":\"your-stage-name\"}'\nname: job-provisions/job/cd/job/default\n</code></pre> </li> </ul> <ul> <li>Restart the Jenkins operator pod and wait until the CD job provisioner in Jenkins creates the updated pipelines.</li> </ul> </li>"},{"location":"operator-guide/upgrade-edp-2.8/#possible-issues","title":"Possible Issues","text":"<ol> <li> <p>SonarQube fails during the CI pipeline run. The previous builds of SonarQube used the latest version of the OpenID Connect Authentication for SonarQube plugin. Version 2.1.0 of this plugin may have issues with the connection, so it is necessary to downgrade it in order to get rid of errors in the pipeline. Take the following steps:</p> <ul> <li>Log in to the Sonar pod:<pre><code>kubectl exec -i -t -n &lt;edp-namespace&gt; sonar-&lt;pod&gt; -c sonar \"--\" sh -c \"(bash || ash || sh)\"\n</code></pre> </li> </ul> <ul> <li>Run the command in the Sonar container:<pre><code>rm extensions/plugins/sonar-auth-oidc-plugin*\n</code></pre> </li> </ul> <ul> <li>Install the OpenID Connect Authentication for SonarQube plugin v2.0.0:<pre><code>curl -L  https://github.com/vaulttec/sonar-auth-oidc/releases/download/v2.0.0/sonar-auth-oidc-plugin-2.0.0.jar --output extensions/plugins/sonar-auth-oidc-plugin-2.0.0.jar\n</code></pre> </li> </ul> <ul> <li>Restart the SonarQube pod;</li> </ul> </li> <li> <p>The Helm lint checker in EDP 2.8.4 has some additional rules. There can be issues with it during the Code Review pipeline in Jenkins for applications that were transferred from previous EDP versions to EDP 2.8.4. To fix this, add the following annotation to the <code>Chart.yaml</code> file:</p> <ul> <li>Go to the Git repository -&gt; Choose the application -&gt; Edit the <code>deploy-templates/Chart.yaml</code> file.</li> <li>It is necessary to add the following lines to the bottom of the <code>Chart.yaml</code> file:<pre><code>home: https://github.com/your-repo.git\nsources:\n- https://github.com/your-repo.git\nmaintainers:\n- name: DEV Team\n</code></pre> </li> </ul> <ul> <li>Add a new line character at the end of the last line. Please be aware it is important.</li> </ul> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.8/#related-articles","title":"Related Articles","text":"<ul> <li>Set Up Kiosk</li> <li>IAM Roles for Kaniko Service Accounts</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"operator-guide/upgrade-edp-2.9/","title":"Upgrade EDP v2.8 to 2.9","text":"<p>This section provides the details on the EDP upgrade to 2.9.0. Explore the actions and requirements below.</p> <p>Note</p> <p>Kiosk is optional for EDP v.2.9.0 and higher, and enabled by default. To disable it, add the following parameter to the <code>values.yaml</code> file: <code>kioskEnabled: false</code>. Please refer to the Set Up Kiosk documentation for the details.</p> <ol> <li> <p>With Amazon Elastic Container Registry to store the images, there are two options:</p> <ul> <li>Enable IRSA and create AWS IAM Role for Kaniko image builder. Please refer to the IAM Roles for Kaniko Service Accounts section for the details.</li> <li>The Amazon Elastic Container Registry Roles can be stored in an instance profile.</li> </ul> </li> <li> <p>Before updating EDP to 2.9.0, update the <code>gerrit-is-credentials</code> secret by adding the new <code>clientSecret</code> key with the value from <code>gerrit-is-credentials.client_secret</code>:</p> <pre><code>kubectl edit secret gerrit-is-credentials -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>Make sure it looks as follows (replace with the necessary key value):<pre><code>data:\nclient_secret: example\nclientSecret: example\n</code></pre> </li> </ul> </li> <li> <p>Update Custom Resource Definitions. This command will apply all the necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritgroupmember_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritgroup_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritprojectaccess_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_gerritproject_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkins_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkinsagent_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkinsauthorizationrolemapping_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/release/2.9/deploy-templates/crds/v2_v1alpha1_jenkinsauthorizationrole_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.9/deploy-templates/crds/v1_v1alpha1_keycloakclientscope_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.9/deploy-templates/crds/v1_v1alpha1_keycloakrealmuser_crd.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/release/2.9/deploy-templates/crds/edp_v1alpha1_nexus_crd.yaml\n</code></pre> </li> <li> <p>With Amazon Elastic Container Registry to store and Kaniko to build the images, add the kanikoRoleArn parameter to the values before starting the update process. This parameter is indicated in AWS Roles once IRSA is enabled and AWS IAM Role is created for Kaniko.The value should look as follows:</p> <pre><code>kanikoRoleArn: arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039EDP_NAMESPACE\u203aKaniko\n</code></pre> </li> <li> <p>To upgrade EDP to the v.2.9.0, run the following command:</p> <pre><code>helm upgrade --install edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.9.0\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with: <code>helm upgrade --install edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=2.9.0  --dry-run</code></p> </li> <li> <p>Remove the following Kubernetes resources left from the previous EDP installation (it is optional):</p> <pre><code>kubectl delete rolebinding edp-cd-pipeline-operator-&lt;edp-namespace&gt;-admin -n &lt;edp-namespace&gt;\n</code></pre> </li> <li> <p>After EDP update, please restart the 'sonar-operator' pod to address the proper Sonar plugin versioning. After 'sonar-operator' is restarted, check the list of installed plugins in the corresponding SonarQube menu.</p> </li> <li> <p>Update Jenkins pipelines and stages to the new release tag:</p> <ul> <li>Restart the Jenkins pod</li> <li>In Jenkins, go to Manage Jenkins -&gt; Configure system -&gt; Find the Global Pipeline Libraries menu</li> <li>Make sure that the Default version for edp-library-stages is build/2.10.0-RC.1</li> <li>Make sure that the Default version for edp-library-pipelines is build/2.10.0-RC.1</li> </ul> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images should be:<pre><code>epamedp/edp-jenkins-codenarc-agent:1.0.1\nepamedp/edp-jenkins-dotnet-21-agent:1.0.3\nepamedp/edp-jenkins-dotnet-31-agent:1.0.3\nepamedp/edp-jenkins-go-agent:1.0.4\nepamedp/edp-jenkins-gradle-java8-agent:1.0.3\nepamedp/edp-jenkins-gradle-java11-agent:2.0.3\nepamedp/edp-jenkins-helm-agent:1.0.7\nepamedp/edp-jenkins-maven-java8-agent:1.0.3\nepamedp/edp-jenkins-maven-java11-agent:2.0.4\nepamedp/edp-jenkins-npm-agent:2.0.3\nepamedp/edp-jenkins-opa-agent:1.0.2\nepamedp/edp-jenkins-python-38-agent:2.0.4\nepamedp/edp-jenkins-terraform-agent:2.0.5\n</code></pre> </li> </ul> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Update the compatible plugins in Jenkins:</p> <ul> <li>Go to Manage Jenkins -&gt; Manage Plugins -&gt; Select Compatible -&gt; Click Download now and install after restart</li> </ul> </li> </ol>"},{"location":"operator-guide/upgrade-edp-2.9/#related-articles","title":"Related Articles","text":"<ul> <li>Set Up Kiosk</li> <li>IAM Roles for Kaniko Service Accounts</li> </ul>"},{"location":"operator-guide/upgrade-edp-3.0/","title":"Upgrade EDP v2.12 to 3.0","text":"<p>Important</p> <ul> <li>Before starting the upgrade procedure, please make the necessary backups.</li> <li>Kiosk integration is disabled by default. With EDP below v.3.0.x, define the <code>global.kioskEnabled</code> parameter in the values.yaml file. For details, please refer to the Set Up Kiosk page.</li> <li>The <code>gerrit-ssh-port</code> parameter is moved from the <code>gerrit-operator.gerrit.sshport</code> to <code>global.gerritSSHPort</code> values.yaml file.</li> <li>In edp-gerrit-operator, the <code>gitServer.user</code> value is changed from the <code>jenkins</code> to <code>edp-ci</code>values.yaml file.</li> </ul> <p>This section provides the details on upgrading EDP to 3.0. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/d9a4d15244c527ef6d1d029af27574282a281b98/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_cdstagedeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_gittags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_imagestreamtags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_jiraissuemetadatas.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/release/2.14/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakauthflows.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakclients.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakclientscopes.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmidentityproviders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmrolebatches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloakrealmusers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/release/1.14/deploy-templates/crds/v1.edp.epam.com_keycloaks.yaml\n</code></pre> </li> <li> <p>Set the required parameters. For more details, please refer to the values.yaml file.</p> View: values.yaml <pre><code>edp-tekton:\nenabled: false\nadmin-console-operator:\nenabled: true\njenkins-operator:\nenabled: true\n</code></pre> </li> <li> <p>Add proper Helm annotations and labels as indicated below. This step is necessary starting from the release v.3.0.x as custom resources are managed by Helm and removed from the Keycloak Controller logic.       <pre><code>  kubectl label EDPComponent main-keycloak app.kubernetes.io/managed-by=Helm -n &lt;edp-namespace&gt;\n  kubectl annotate EDPComponent main-keycloak meta.helm.sh/release-name=&lt;edp-release-name&gt; -n &lt;edp-namespace&gt;\n  kubectl annotate EDPComponent main-keycloak meta.helm.sh/release-namespace=&lt;edp-namespace&gt; -n &lt;edp-namespace&gt;\n  kubectl label KeycloakRealm main app.kubernetes.io/managed-by=Helm -n &lt;edp-namespace&gt;\n  kubectl annotate KeycloakRealm main meta.helm.sh/release-name=&lt;edp-release-name&gt; -n &lt;edp-namespace&gt;\n  kubectl annotate KeycloakRealm main meta.helm.sh/release-namespace=&lt;edp-namespace&gt; -n &lt;edp-namespace&gt;\n</code></pre></p> </li> <li> <p>To upgrade EDP to 3.0, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.0.x\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.0.x  --dry-run</code></p> </li> <li> <p>Update image versions for the Jenkins agents in the ConfigMap:</p> <pre><code>  kubectl edit configmap jenkins-slaves -n &lt;edp-namespace&gt;\n</code></pre> <ul> <li>The versions of the images must be the following:<pre><code>epamedp/edp-jenkins-codenarc-agent:3.0.10\nepamedp/edp-jenkins-dotnet-31-agent:3.0.9\nepamedp/edp-jenkins-go-agent:3.0.17\nepamedp/edp-jenkins-gradle-java11-agent:3.0.7\nepamedp/edp-jenkins-gradle-java8-agent:3.0.10\nepamedp/edp-jenkins-helm-agent:3.0.11\nepamedp/edp-jenkins-kaniko-docker-agent:1.0.9\nepamedp/edp-jenkins-maven-java11-agent:3.0.7\nepamedp/edp-jenkins-maven-java8-agent:3.0.10\nepamedp/edp-jenkins-npm-agent:3.0.9\nepamedp/edp-jenkins-opa-agent:3.0.7\nepamedp/edp-jenkins-python-38-agent:3.0.8\nepamedp/edp-jenkins-sast-agent:0.1.5\nepamedp/edp-jenkins-terraform-agent:3.0.9\n</code></pre> </li> </ul> <ul> <li>Remove the <code>edp-jenkins-dotnet-21-agent</code> agent manifest.</li> </ul> <ul> <li>Restart the Jenkins pod.</li> </ul> </li> <li> <p>Attach the <code>id_rsa.pub</code> SSH public key from the <code>gerrit-ciuser-sshkey</code> secret to the <code>edp-ci</code> Gerrit user in the <code>gerrit</code> pod:</p> <pre><code>ssh -p &lt;gerrit_ssh_port&gt; &lt;host&gt; gerrit set-account --add-ssh-key ~/id_rsa.pub\n</code></pre> <p>Notes</p> <ul> <li>For this operation, use the <code>gerrit-admin</code> SSH key from secrets.</li> <li><code>&lt;host&gt;</code> is admin@localhost or any other user with permissions.</li> </ul> </li> <li> <p>Change the username from <code>jenkins</code> to <code>edp-ci</code> in the <code>gerrit-ciuser-sshkey</code> secret:</p> <pre><code>kubectl -n &lt;edp-namespace&gt; patch secret gerrit-ciuser-sshkey\\\n --patch=\"{\\\"data\\\": { \\\"username\\\": \\\"$(echo -n edp-ci |base64 -w0)\\\" }}\" -oyaml\n</code></pre> </li> </ol> <p>Warning</p> <p>In EDP v.3.0.x, Admin Console is deprecated, and EDP interface is available only via EDP Portal.</p>"},{"location":"operator-guide/upgrade-edp-3.0/#related-articles","title":"Related Articles","text":"<ul> <li>Migrate CI Pipelines From Jenkins to Tekton</li> </ul>"},{"location":"operator-guide/upgrade-edp-3.1/","title":"Upgrade EDP v3.0 to 3.1","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to v3.1. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.13.2/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.13.4/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\n</code></pre> </li> <li> <p>To upgrade EDP to the v3.1, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.1.0\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.1.0  --dry-run</code></p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-3.2/","title":"Upgrade EDP v3.1 to 3.2","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides the details on the EDP upgrade to v3.2.2. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_cdstagedeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_gittags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_imagestreamtags.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_jiraissuemetadatas.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_cdstagejenkinsdeployments.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsagents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationrolemappings.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsauthorizationroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsfolders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsjobbuildruns.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsjobs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsscripts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinsserviceaccounts.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_jenkinssharedlibraries.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-component-operator/v0.13.0/deploy-templates/crds/v1.edp.epam.com_edpcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_cdpipelines.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_stages.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_nexuses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-nexus-operator/v2.14.1/deploy-templates/crds/v2.edp.epam.com_nexususers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_sonargroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_sonarpermissiontemplates.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-sonar-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_sonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritgroupmembers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritmergerequests.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritprojectaccesses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritprojects.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerritreplicationconfigs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.14.0/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfdatasourcegitlabs.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfdatasourcejenkinses.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfdatasourcesonars.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-perf-operator/v2.13.0/deploy-templates/crds/v2.edp.epam.com_perfservers.yaml\n</code></pre> </li> <li> <p>Generate a cookie-secret for proxy with the following command:</p> <p><pre><code>nexus_proxy_cookie_secret=$(openssl rand -base64 32 | head -c 32)\n</code></pre> Create <code>nexus-proxy-cookie-secret</code> in the  namespace: <pre><code>kubectl -n &lt;edp-project&gt; create secret generic nexus-proxy-cookie-secret \\\n--from-literal=cookie-secret=${nexus_proxy_cookie_secret}\n</code></pre> <li> <p>EDP 3.2.2 features OIDC configuration for EDP Portal. If this parameter is required, create <code>keycloak-client-headlamp-secret</code> as described in this article:</p> <pre><code>kubectl -n &lt;edp-project&gt; create secret generic keycloak-client-edp-portal-secret \\\n--from-literal=clientSecret=&lt;keycloak_client_secret_key&gt;\n</code></pre> </li> <li> <p>Delete the following resources:</p> <pre><code>kubectl -n &lt;edp-project&gt; delete KeycloakClient nexus\nkubectl -n &lt;edp-project&gt; delete EDPComponent nexus\nkubectl -n &lt;edp-project&gt; delete Ingress nexus\nkubectl -n &lt;edp-project&gt; delete deployment edp-tekton-dashboard\n</code></pre> </li> <li> <p>EDP release 3.2.2 uses the default cluster storageClass and we must check previous storageClass parameters. Align , if required, the <code>storageClassName</code> in EDP <code>values.yaml</code> to the same that were used by EDP PVC. For example:</p> <pre><code>edp-tekton:\nbuildTool:\ngo:\ncache:\npersistentVolume:\n# -- Specifies storageClass type. If not specified, a default storageClass for go-cache volume is used\nstorageClass: ebs-sc\n\njenkins-operator:\nenabled: true\njenkins:\nstorage:\n# -- Storageclass for Jenkins data volume\nclass: gp2\n\nsonar-operator:\nsonar:\nstorage:\ndata:\n# --  Storageclass for Sonar data volume\nclass: gp2\ndatabase:\n# --  Storageclass for database data volume\nclass: gp2\n\ngerrit-operator:\ngerrit:\nstorage:\n# --  Storageclass for Gerrit data volume\nclass: gp2\n\nnexus-operator:\nnexus:\nstorage:\n# --  Storageclass for Nexus data volume\nclass: gp2\n</code></pre> </li> <li> <p>To upgrade EDP to the v3.2.2, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.2.2\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the following command: <code>helm upgrade edp epamedp/edp-install -n &lt;edp-namespace&gt; --values values.yaml --version=3.2.2  --dry-run</code></p> </li>"},{"location":"operator-guide/upgrade-edp-3.3/","title":"Upgrade EDP v3.2 to 3.3","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>Note</p> <p>We currently disabled cache volumes for go and npm in the EDP 3.3 release.</p> <p>This section provides the details on the EDP upgrade to v3.3.0. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.16.0/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-jenkins-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_jenkins.yaml\n</code></pre> </li> <li> <p>If you use Gerrit VCS, delete the corresponding resource due to changes in annotations:</p> <p><pre><code>kubectl -n edp delete EDPComponent gerrit\n</code></pre> The deployment will create a new EDPComponent called <code>gerrit</code> instead.</p> </li> <li> <p>To upgrade EDP to the v3.3.0, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.3.0\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the <code>--dry-run</code> tag: <code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.3.0  --dry-run</code></p> </li> <li> <p>In EDP v3.3.0, a new feature was introduced allowing manual pipeline re-triggering by sending a comment with <code>/recheck</code>. To enable the re-trigger feature for applications that were added before the upgrade, please proceed with the following:</p> <p>4.1 For Gerrit VCS, add the following event to the <code>webhooks.config</code> configuration file in the <code>All-Projects</code> repository:</p> <pre><code>[remote \"commentadded\"]\n  url = http://el-gerrit-listener:8080\n  event = comment-added\n</code></pre> <p>4.2 For GitHub VCS, check the <code>Issue comments</code> permission for each webhook in every application added before the EDP upgrade to 3.3.0.</p> <p>4.3 For GitLab VCS, check the <code>Comments</code> permission for each webhook in every application added before the EDP upgrade to 3.3.0.</p> </li> </ol>"},{"location":"operator-guide/upgrade-edp-3.4/","title":"Upgrade EDP v3.3 to 3.4","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>Note</p> <p>Pay attention that the following components: <code>perf-operator</code>, <code>edp-admin-console</code>, <code>edp-admin-console-operator</code>, and <code>edp-jenkins-operator</code> are deprecated and should be additionally migrated in order to avoid their deletion. For migration details, please refer to the Migrate CI Pipelines From Jenkins to Tekton instruction.</p> <p>This section provides the details on the EDP upgrade to v3.4.1. Explore the actions and requirements below.</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_cdpipelines.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-cd-pipeline-operator/v2.15.0/deploy-templates/crds/v2.edp.epam.com_stages.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_clusterkeycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_clusterkeycloaks.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakauthflows.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakclients.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakclientscopes.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmcomponents.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmgroups.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmidentityproviders.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmrolebatches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmroles.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealms.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloakrealmusers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-keycloak-operator/v1.17.0/deploy-templates/crds/v1.edp.epam.com_keycloaks.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_templates.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_codebasebranches.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_codebaseimagestreams.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_codebases.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.17.0/deploy-templates/crds/v2.edp.epam.com_jiraservers.yaml\nkubectl apply -f https://raw.githubusercontent.com/epam/edp-gerrit-operator/v2.16.0/deploy-templates/crds/v2.edp.epam.com_gerrits.yaml\n</code></pre> </li> <li> <p>Remove deprecated components:</p> <p> View: values.yaml <p><pre><code>perf-operator:\nenabled: false\nadmin-console-operator:\nenabled: false\njenkins-operator:\nenabled: false\n</code></pre> </p> <li> <p>Since the values.yaml file structure has been modified, move the dockerRegistry subsection to the global section:</p> <p>The dockerRegistry value has been moved to the global section:</p> <pre><code>global:\ndockerRegistry:\n# -- Define Image Registry that will to be used in Pipelines. Can be ecr (default), harbor\ntype: \"ecr\"\n# -- Docker Registry endpoint\nurl: \"&lt;AWS_ACCOUNT_ID&gt;.dkr.ecr.&lt;AWS_REGION&gt;.amazonaws.com\"\n</code></pre> </li> <li> <p>(Optional) To integrate EDP with Jira, rename the default values from <code>epam-jira-user</code> to <code>jira-user</code> for a secret name. In case Jira is already integrated, it will continue working.</p> <pre><code>codebase-operator:\njira:\ncredentialName: \"jira-user\"\n</code></pre> </li> <li> <p>(Optional) To switch to the Harbor registry, change the secret format for the external secret from kaniko-docker-config v3.3.0 to kaniko-docker-config v3.4.1:</p> View: old format <pre><code> \"kaniko-docker-config\": {\"secret-string\"} //base64 format\n</code></pre> View: new format <pre><code>\"kaniko-docker-config\": {\n\"auths\" : {\n\"registry.com\" :\n{\"username\":\"&lt;registry-username&gt;\",\"password\":\"&lt;registry-password&gt;\",\"auth\":\"secret-string\"}\n}\n}\n</code></pre> </li> <li> <p>To upgrade EDP to the v3.4.1, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.4.1\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the <code>--dry-run</code> tag: <code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.4.1 --dry-run</code></p> </li>"},{"location":"operator-guide/upgrade-edp-3.5/","title":"Upgrade EDP v3.4 to 3.5","text":"<p>Important</p> <p>We suggest making a backup of the EDP environment before starting the upgrade procedure.</p> <p>This section provides detailed instructions for upgrading EPAM Delivery Platform to version 3.5.3. Follow the steps and requirements outlined below:</p> <ol> <li> <p>Update Custom Resource Definitions (CRDs). Run the following command to apply all necessary CRDs to the cluster:</p> <pre><code>kubectl apply -f https://raw.githubusercontent.com/epam/edp-codebase-operator/v2.19.0/deploy-templates/crds/v2.edp.epam.com_gitservers.yaml\n</code></pre> <p>Danger</p> <p>Codebase-operator v2.19.0 is not compatible with the previous versions. Please become familiar with the breaking change in Git Server Custom Resource Definition.</p> </li> <li> <p>Familiarize yourself with the updated file structure of the values.yaml file and adjust your values.yaml file accordingly:</p> <ol> <li> <p>By default, the deployment of sub components such as <code>edp-sonar-operator</code>, <code>edp-nexus-operator</code>, <code>edp-gerrit-operator</code>, and <code>keycloak-operator</code>, have been disabled. Set them back to <code>true</code> in case they are needed or manually deploy external tools, such as SonarQube, Nexus, Gerrit and integrate them with the EPAM Delivery Platform.</p> </li> <li> <p>The default Git provider has been changed from Gerrit to GitHub:</p> <p>Old format:</p> <pre><code>global:\ngitProvider: gerrit\ngerritSSHPort: \"22\"\n</code></pre> <p>New format:</p> <pre><code>global:\ngitProvider: github\n#gerritSSHPort: \"22\"\n</code></pre> </li> <li> <p>The sonarUrl and nexusUrl parameters have been deprecated. All the URLs from external components are stored in integration secrets:</p> <pre><code>global:\n# -- Optional parameter. Link to use custom sonarqube. Format: http://&lt;service-name&gt;.&lt;sonarqube-namespace&gt;:9000 or http://&lt;ip-address&gt;:9000\nsonarUrl: \"\"\n# -- Optional parameter. Link to use custom nexus. Format: http://&lt;service-name&gt;.&lt;nexus-namespace&gt;:8081 or http://&lt;ip-address&gt;:&lt;port&gt;\nnexusUrl: \"\"\n</code></pre> </li> <li> <p>Keycloak integration has been moved from the global section to the sso section. Update the parameters accordingly:</p> <p>Old format:</p> <pre><code>global:\n# -- Keycloak URL\nkeycloakUrl: https://keycloak.example.com\n# -- Administrators of your tenant\nadmins:\n- \"stub_user_one@example.com\"\n# -- Developers of your tenant\ndevelopers:\n- \"stub_user_one@example.com\"\n- \"stub_user_two@example.com\"\n</code></pre> <p>New format:</p> <pre><code>sso:\nenabled: true\n# -- Keycloak URL\nkeycloakUrl: https://keycloak.example.com\n# -- Administrators of your tenant\nadmins:\n- \"stub_user_one@example.com\"\n# -- Developers of your tenant\ndevelopers:\n- \"stub_user_one@example.com\"\n- \"stub_user_two@example.com\"\n</code></pre> </li> <li> <p>(Optional) The default secret name for Jira integration has been changed from <code>jira-user</code> to <code>ci-jira</code>. Please adjust the secret name in the parameters accordingly:</p> <pre><code>codebase-operator:\njira:\ncredentialName: \"ci-jira\"\n</code></pre> </li> </ol> </li> <li> <p>The secret naming and format have been refactored. Below are patterns of the changes for various components:</p> SonarQubeNexusDependency-TrackDefectDojoJiraGitLabGitHub <p>Old format: <pre><code>\"sonar-ciuser-token\": {\n\"username\": \"xxxxx\",\n\"secret\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n}\n</code></pre> New format: <pre><code>\"ci-sonarqube\": {\n\"token\": \"xxxxxxxxxxxxxxxxxxxxxxx\",\n\"url\":\"https://sonar.example.com\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"nexus-ci-user\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxxxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-nexus\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxx\",\n\"url\": \"http://nexus.example.com\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"ci-dependency-track\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-dependency-track\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\",\n\"url\": \"http://dependency-track.example.com\"}\n</code></pre></p> <p>Old format: <pre><code>\"defectdojo-ciuser-token\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\"\n\"url\": \"http://defectdojo.example.com\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-defectdojo\": {\n\"token\": \"xxxxxxxxxxxxxxxxxx\",\n\"url\": \"http://defectdojo.example.com\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"jira-user\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-jira\": {\n\"username\": \"xxxxx\",\n\"password\": \"xxxxx\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"gitlab\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-gitlab\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>Old format: <pre><code>\"github\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>New format: <pre><code>\"ci-github\": {\n\"id_rsa\": \"xxxxxxxxxxxxxx\",\n\"token\": \"xxxxxxxxxxxxxx\",\n\"secretString\": \"xxxxxxxxxxxxxx\"\n}\n</code></pre></p> <p>The tables below illustrate the difference between the old and new format:</p> <p>Old format</p> Secret Name Username Password Token Secret URL jira-user * * nexus-ci.user * * sonar-ciuser-token * * defectdojo-ciuser-token * * ci-dependency-track * <p>New format</p> Secret Name Username Password Token URL ci-jira * * ci-nexus * * * ci-sonarqube * * ci-defectdojo * * ci-dependency-track * * </li> <li> <p>To upgrade EDP to the v3.5.3, run the following command:</p> <pre><code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.5.3\n</code></pre> <p>Note</p> <p>To verify the installation, it is possible to test the deployment before applying it to the cluster with the <code>--dry-run</code> tag: <code>helm upgrade edp epamedp/edp-install -n edp --values values.yaml --version=3.5.3 --dry-run</code></p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/","title":"Upgrade Keycloak v17.0 to 19.0","text":"<p>Starting from Keycloak v.18.x.x, the Keycloak server has been moved from the Wildfly (JBoss) Application Server to Quarkus framework and is called Keycloak.X.</p> <p>There are two ways to upgrade Keycloak v.17.0.x-legacy to v.19.0.x on Kubernetes, please perform the steps described in the Prerequisites section of this tutorial, and then select a suitable upgrade strategy for your environment:</p> <ul> <li>Upgrade Postgres database to a minor release v.11.17</li> <li>Migrate Postgres database from Postgres v.11.x to v.14.5</li> </ul>"},{"location":"operator-guide/upgrade-keycloak-19.0/#prerequisites","title":"Prerequisites","text":"<p>Before upgrading Keycloak, please perform the steps below:</p> <ol> <li> <p>Create a backup/snapshot of the Keycloak database volume. Locate the AWS <code>volumeID</code> and then create its snapshot on AWS:</p> <ul> <li> <p>Find the <code>PVC</code> name attached to the Postgres pod. It can be similar to <code>data-keycloak-postgresql-0</code> if the Postgres <code>StatefulSet</code> name is <code>keycloak-postgresql</code>:</p> <pre><code>kubectl get pods keycloak-postgresql-0 -n security -o jsonpath='{.spec.volumes[*].persistentVolumeClaim.claimName}{\"\\n\"}'\n</code></pre> </li> </ul> <ul> <li> <p>Locate the <code>PV</code> <code>volumeName</code> in the <code>data-keycloak-postgresql-0</code> Persistent Volume Claim:</p> <pre><code>kubectl get pvc data-keycloak-postgresql-0 -n security -o jsonpath='{.spec.volumeName}{\"\\n\"}'\n</code></pre> </li> </ul> <ul> <li> <p>Get <code>volumeID</code> in the Persistent Volume:</p> <pre><code>kubectl get pv ${pv_name} -n security -o jsonpath='{.spec.awsElasticBlockStore.volumeID}{\"\\n\"}'\n</code></pre> </li> </ul> </li> <li> <p>Add two additional keys: <code>password</code> and <code>postgres-password</code>, to the <code>keycloak-postgresql</code> secret in the Keycloak namespace.</p> <p>Note</p> <ul> <li>The <code>password</code> key must have the same value as the <code>postgresql-password</code> key.</li> <li>The <code>postgres-password</code> key must have the same value as the <code>postgresql-postgres-password</code> key.</li> </ul> <p>The latest chart for Keycloak.X does not have an option to override Postgres password and admin password keys in the secret, and it uses the Postgres defaults, therefore, a new secret scheme must be implemented:</p> <pre><code>kubectl -n security edit secret keycloak-postgresql\n</code></pre> <pre><code>data:\npostgresql-password: XXXXXX\npostgresql-postgres-password: YYYYYY\npassword: XXXXXX\npostgres-password: YYYYYY\n</code></pre> </li> <li> <p>Save Keycloak <code>StatefulSet</code> names, for example, <code>keycloak</code> and <code>keycloak-postgresql</code>. These names will be used in the new Helm deployments:</p> <pre><code>$ kubectl get statefulset -n security\nNAME                  READY   AGE\nkeycloak              1/1     18h\nkeycloak-postgresql   1/1     18h\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#upgrade-postgres-database-to-a-minor-release-v1117","title":"Upgrade Postgres Database to a Minor Release v.11.17","text":"<p>To upgrade Keycloak by upgrading Postgres Database to a minor release v.11.17, perform the steps described in the Prerequisites section of this tutorial, and then perform the following steps:</p>"},{"location":"operator-guide/upgrade-keycloak-19.0/#delete-keycloak-resources","title":"Delete Keycloak Resources","text":"<ol> <li> <p>Delete <code>Keycloak</code> and <code>Prostgres</code> <code>StatefulSets</code>:</p> <pre><code>kubectl delete statefulset keycloak keycloak-postgresql -n security\n</code></pre> </li> <li> <p>Delete the Keycloak <code>Ingress</code>object, to prevent hostname duplication issues:</p> <pre><code>kubectl delete ingress keycloak -n security\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#upgrade-keycloak","title":"Upgrade Keycloak","text":"<ol> <li> <p>Make sure the Keycloak chart repository is added:</p> <pre><code>helm repo add codecentric https://codecentric.github.io/helm-charts\nhelm repo update\n</code></pre> </li> <li> <p>Create values for Keycloak:</p> <p>Note</p> <p>Since the Keycloak.X release, Keycloak  and Postgres database charts are separated. Upgrade Keycloak, and then install the Postgres database.</p> <p>Note</p> <ul> <li><code>nameOverride: \"keycloak\"</code> sets the name of the Keycloak pod. It must be the same Keycloak name as in the previous <code>StatefulSet</code>.</li> <li>Change Ingress host name to the Keycloak host name.</li> <li><code>hostname: keycloak-postgresql</code> is the hostname of the pod with the Postgres database that is the same as Postgres StatefulSet name, for example, <code>keycloak-postgresql</code>.</li> <li><code>\"/opt/keycloak/bin/kc.sh start --auto-build\"</code> was used in the legacy Keycloak version. However, it is no longer required in the new Keycloak version since it is deprecated and used by default.</li> <li> <p>Optionally, use the following command for applying the old Keycloak theme:</p> <p><pre><code>bin/kc.sh start --features-disabled=admin2\n</code></pre> </p> </li> </ul> View: keycloak-values.yaml <pre><code>nameOverride: \"keycloak\"\n\nreplicas: 1\n\n# Deploy the latest verion\nimage:\ntag: \"19.0.1\"\n\n# start: create OpenShift realm which is required by EDP\nextraInitContainers: |\n- name: realm-provider\nimage: busybox\nimagePullPolicy: IfNotPresent\ncommand:\n- sh\nargs:\n- -c\n- |\necho '{\"realm\": \"openshift\",\"enabled\": true}' &gt; /opt/keycloak/data/import/openshift.json\nvolumeMounts:\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumeMounts: |\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumes: |\n- name: realm\nemptyDir: {}\n\ncommand:\n- \"/opt/keycloak/bin/kc.sh\"\n- \"--verbose\"\n- \"start\"\n- \"--http-enabled=true\"\n- \"--http-port=8080\"\n- \"--hostname-strict=false\"\n- \"--hostname-strict-https=false\"\n- \"--spi-events-listener-jboss-logging-success-level=info\"\n- \"--spi-events-listener-jboss-logging-error-level=warn\"\n- \"--import-realm\"\n\nextraEnv: |\n- name: KC_PROXY\nvalue: \"passthrough\"\n- name: KEYCLOAK_ADMIN\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: username\n- name: KEYCLOAK_ADMIN_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: password\n- name: JAVA_OPTS_APPEND\nvalue: &gt;-\n-XX:+UseContainerSupport\n-XX:MaxRAMPercentage=50.0\n-Djava.awt.headless=true\n-Djgroups.dns.query={{ include \"keycloak.fullname\" . }}-headless\n\n# This block should be uncommented if you install Keycloak on Kubernetes\ningress:\nenabled: true\nannotations:\nkubernetes.io/ingress.class: nginx\ningress.kubernetes.io/affinity: cookie\nrules:\n- host: keycloak.&lt;ROOT_DOMAIN&gt;\npaths:\n- path: '{{ tpl .Values.http.relativePath $ | trimSuffix \"/\" }}/'\npathType: Prefix\n\n# This block should be uncommented if you set Keycloak to OpenShift and change the host field\n# route:\n#   enabled: false\n#   # Path for the Route\n#   path: '/'\n#   # Host name for the Route\n#   host: \"keycloak.&lt;ROOT_DOMAIN&gt;\"\n#   # TLS configuration\n#   tls:\n#     enabled: true\n\nresources:\nlimits:\nmemory: \"2048Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"512Mi\"\n\n# Check database readiness at startup\ndbchecker:\nenabled: true\n\ndatabase:\nvendor: postgres\nexistingSecret: keycloak-postgresql\nhostname: keycloak-postgresql\nport: 5432\nusername: admin\ndatabase: keycloak\n</code></pre> </li> <li> <p>Upgrade the Keycloak Helm chart:</p> <p>Note</p> <ul> <li>The Helm chart is substituted with the new Keyacloak.X instance.</li> <li>Change the namespace and the values file name if required.</li> </ul> <pre><code>helm upgrade keycloak codecentric/keycloakx --version 1.6.0 --values keycloak-values.yaml -n security\n</code></pre> <p>Note</p> <p>If there are error messages when upgrading via Helm, make sure that <code>StatefulSets</code> are removed. If they are removed and the error still persists, try to add the <code>--force</code> flag to the Helm command:</p> <pre><code>helm upgrade keycloak codecentric/keycloakx --version 1.6.0 --values keycloak-values.yaml -n security --force\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#install-postgres","title":"Install Postgres","text":"<ol> <li> <p>Add Bitnami chart repository and update Helm repos:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create values for Postgres:</p> <p>Note</p> <ul> <li>Postgres v.11 and Postgres v.14.5 are not compatible.</li> <li>Postgres image will be upgraded to a minor release v.11.17.</li> <li><code>fullnameOverride: \"keycloak-postgresql\"</code> sets the name of the Postgres StatefulSet. It must be the same as in the previous <code>StatefulSet</code>.</li> </ul> View: postgres-values.yaml <pre><code>fullnameOverride: \"keycloak-postgresql\"\n\n# PostgreSQL read only replica parameters\nreadReplicas:\n# Number of PostgreSQL read only replicas\nreplicaCount: 1\n\nglobal:\npostgresql:\nauth:\nusername: admin\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\ndatabase: keycloak\n\nimage:\nregistry: docker.io\nrepository: bitnami/postgresql\ntag: 11.17.0-debian-11-r3\n\nauth:\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\n\nprimary:\npersistence:\nenabled: true\nsize: 3Gi\n# If the StorageClass with reclaimPolicy: Retain is used, install an additional StorageClass before installing PostgreSQL\n# (the code is given below).\n# If the default StorageClass will be used - change \"gp2-retain\" to \"gp2\"\nstorageClass: \"gp2-retain\"\n</code></pre> </li> <li> <p>Install the Postgres database chart:</p> <p>Note</p> <p>Change the namespace and the values file name if required.</p> <pre><code>helm install postgresql bitnami/postgresql \\\n--version 11.7.6 \\\n--values postgres-values.yaml \\\n--namespace security\n</code></pre> </li> <li> <p>Log in to Keycloak and check that everything works as expected.</p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#clean-and-analyze-database","title":"Clean and Analyze Database","text":"<p>Optionally, run the vacuumdb application on the database, to recover space occupied by \"dead tuples\" in the tables, analyze the contents of database tables, and collect statistics for PostgreSQL query engine to improve performance:</p> <p><pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose -d keycloak -U postgres\n</code></pre> For all databases, run the following command:</p> <pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose --all -U postgres\n</code></pre>"},{"location":"operator-guide/upgrade-keycloak-19.0/#migrate-postgres-database-from-postgres-v11x-to-v145","title":"Migrate Postgres Database From Postgres v.11.x to v.14.5","text":"<p>Info</p> <p>There is a Postgres database migration script at the end of this tutorial. Please read the section below before using the script.</p> <p>To upgrade Keycloak by migrating Postgres database from Postgres v.11.x to v.14.5, perform the steps described in the Prerequisites section of this tutorial, and then perform the following steps:</p>"},{"location":"operator-guide/upgrade-keycloak-19.0/#export-postgres-databases","title":"Export Postgres Databases","text":"<ol> <li> <p>Log in to the current Keycloak Postgres pod and create a logical backup of all roles and databases using the pg_dumpall application. If there is no access to the Postgres Superuser, backup the Keycloak database with the pg_dump application:</p> <p>Note</p> <ul> <li>The secret key <code>postgresql-postgres-password</code> is for the <code>postgres</code> Superuser and <code>postgresql-password</code> is for <code>admin</code> user. The <code>admin</code> user is indicated by default in the Postgres Helm chart. The <code>admin</code> user may not have enough permissions to dump all Postgres databases and roles, so the preferred option for exporting all objects is using the <code>pg_dumpall</code> tool with the <code>postgres</code> Superuser.</li> <li>If the <code>PGPASSWORD</code> variable is not specified before using the <code>pg_dumpall</code> tool, you will be prompted to enter a password for each database during the export.</li> <li>If the <code>-l keycloak</code> parameter is specified, <code>pg_dumpall</code> will connect to the <code>keycloak</code> database for dumping global objects and discovering what other databases should be dumped. By default, <code>pg_dumpall</code> will try to connect to <code>postgres</code> or <code>template1</code> databases. This parameter is optional.</li> <li>The <code>pg_dumpall --clean</code> option adds SQL commands to the dumped file for dropping databases before recreating them during import, as well as <code>DROP</code> commands for roles and tablespaces (<code>pg_dump</code> also has this option). If the <code>--clean</code> parameter is specified, connect to the <code>postgres</code> database initially during import via <code>psql</code>. The <code>psql</code> script will attempt to drop other databases immediately, and that will fail for the database you are connected to. This flag is optional, and it is not included into this tutorial.</li> </ul> <pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" pg_dumpall -h localhost -p 5432 -U postgres -l keycloak &gt; /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> <p>Note</p> <p>If there is no working password for the <code>postgres</code> Superuser, try the <code>admin</code> user using the pg_dump tool to export the <code>keycloak</code> database without global roles:</p> <pre><code>PGPASSWORD=\"${postgresql_password}\" pg_dump -h localhost -p 5432 -U admin -d keycloak &gt; /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> <p>Info</p> <p>Double-check that the contents of the dumped file is not empty. It usually contains more than 4000 lines.</p> </li> <li> <p>Copy the file with the database dump to a local machine. Since <code>tar</code> may not be present in the pod and <code>kubectl cp</code> will not work without <code>tar</code>, use the following command:</p> <pre><code>kubectl exec -n security ${postgresql_pod} -- cat /tmp/keycloak_wildfly_db_dump.sql  &gt; keycloak_wildfly_db_dump.sql\n</code></pre> <p>Note</p> <p>Please find below the alternative commands for exporting the database to the local machine without copying the file to a pod for Postgres and admin users:</p> <pre><code>kubectl exec -n security ${postgresql_pod} \"--\" sh -c \"PGPASSWORD='\"${postgresql_postgres-password}\"' pg_dumpall -h localhost -p 5432 -U postgres\" &gt; keycloak_wildfly_db_dump.sql\nkubectl exec -n security ${postgresql_pod} \"--\" sh -c \"PGPASSWORD='\"${postgresql_password}\"' pg_dump -h localhost -p 5432 -U admin -d keycloak\" &gt; keycloak_wildfly_db_dump.sql\n</code></pre> </li> <li> <p>Delete the dumped file from the pod for security reasons:</p> <pre><code>kubectl exec -n security ${postgresql_pod} \"--\" sh -c \"rm /tmp/keycloak_wildfly_db_dump.sql\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#delete-keycloak-resources_1","title":"Delete Keycloak Resources","text":"<ol> <li> <p>Delete all previous Keycloak resources along with the Postgres database and keycloak <code>StatefulSets</code>, <code>Ingress</code>, and custom resources via Helm, or via the tool used for their deployment.</p> <pre><code>helm list -n security\nhelm delete keycloak -n security\n</code></pre> <p>Warning</p> <p>Don't delete the whole namespace. Keep the <code>keycloak-postgresql</code> and <code>keycloak-admin-creds</code> secrets.</p> </li> <li> <p>Delete the volume in AWS, from which a snapshot has been created. Then delete the PVC:</p> <pre><code>kubectl delete pvc data-keycloak-postgresql-0 -n security\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#install-postgres_1","title":"Install Postgres","text":"<ol> <li> <p>Add Bitnami chart repository and update Helm repos:</p> <pre><code>helm repo add bitnami https://charts.bitnami.com/bitnami\nhelm repo update\n</code></pre> </li> <li> <p>Create Postgres values:</p> <p>Note</p> <p><code>fullnameOverride: \"keycloak-postgresql\"</code> sets the name of the Postgres StatefulSet. It must be same as in the previous <code>StatefulSet</code>.</p> View: postgres-values.yaml <pre><code>nameOverride: \"keycloak-postgresql\"\n\n# PostgreSQL read only replica parameters\nreadReplicas:\n# Number of PostgreSQL read only replicas\nreplicaCount: 1\n\nglobal:\npostgresql:\nauth:\nusername: admin\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\ndatabase: keycloak\n\nauth:\nexistingSecret: keycloak-postgresql\nsecretKeys:\nadminPasswordKey: postgres-password\nuserPasswordKey: password\n\nprimary:\npersistence:\nenabled: true\nsize: 3Gi\n# If the StorageClass with reclaimPolicy: Retain is used, install an additional StorageClass before installing PostgreSQL\n# (the code is given below).\n# If the default StorageClass will be used - change \"gp2-retain\" to \"gp2\"\nstorageClass: \"gp2-retain\"\n</code></pre> </li> <li> <p>Install the Postgres database:</p> <p>Note</p> <p>Change the namespace and the values file name if required.</p> <pre><code>helm install postgresql bitnami/postgresql \\\n--version 11.7.6 \\\n--values postgres-values.yaml \\\n--namespace security\n</code></pre> </li> <li> <p>Wait for the database to be ready.</p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#import-postgres-databases","title":"Import Postgres Databases","text":"<ol> <li> <p>Upload the database dump to the new Keycloak Postgres pod:</p> <pre><code>cat keycloak_wildfly_db_dump.sql | kubectl exec -i -n security ${postgresql_pod} \"--\" sh -c \"cat &gt; /tmp/keycloak_wildfly_db_dump.sql\"\n</code></pre> <p>Warning</p> <p>Database import must be done before deploying Keycloak, because Keycloak will write its own data to the database during the start, and the import will partially fail. If that happened, scale down the keycloak <code>StatefulSet</code>, and try to drop the Keycloak database in the Postgres pod:</p> <pre><code>dropdb -i -e keycloak -p 5432 -h localhost -U postgres\n</code></pre> <p>If there still are some conflicting objects like roles, drop them via the DROP ROLE command.</p> <p>If the previous steps do not help, downscale the Keycloak and Postgres <code>StatefulSets</code> and delete the attached <code>PVC</code> (save the <code>volumeID</code> before removing), and delete the volume on AWS if using <code>gp2-retain</code>. In case of using <code>gp2</code>, the volume will be deleted automatically after removing PVC. After that, redeploy the Postgres database, so that the new <code>PVC</code> is automatically created.</p> </li> <li> <p>Import the SQL dump file to the Postgres database cluster:</p> <p>Info</p> <p>Since the databases were exported in the <code>sql</code> format, the psql tool will be used to restore (reload) them. pg_restore does not support this plain-text format.</p> <ul> <li> <p>If the entire Postgres database cluster was migrated with the <code>postgres</code> Superuser using <code>pg_dumpall</code>, use the import command without indicating the database:</p> <pre><code>psql -U postgres -f /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> </li> </ul> <ul> <li> <p>If the database was migrated with the <code>admin</code> user using <code>pg_dump</code>, the <code>postgres</code> Superuser still can be used to restore it, but, in this case, a database must be indicated:</p> <p>Warning</p> <p>If the database name was not indicated during the import for the file dumped with <code>pg_dump</code>, the <code>psql</code> tool will import this database to a default Postgres database called <code>postgres</code>.</p> <pre><code>psql -U postgres -d keycloak -f /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> </li> </ul> <ul> <li> <p>If the <code>postgres</code> Superuser is not accessible in the Postgres pod, run the command under the <code>admin</code> or any other user that has the database permissions. In this case, indicate the database as well:</p> <pre><code>psql -U admin -d keycloak -f /tmp/keycloak_wildfly_db_dump.sql\n</code></pre> </li> </ul> </li> <li> <p>After a successful import, delete the dump file from the pod for security reasons:</p> <pre><code>kubectl exec -n security ${postgresql_pod} \"--\" sh -c \"rm /tmp/keycloak_wildfly_db_dump.sql\"\n</code></pre> <p>Note</p> <p>Please find below the alternative commands for importing the database from the local machine to the pod without storing the backup on a pod for <code>postgres</code> or <code>admin</code> users:</p> <pre><code>cat \"keycloak_wildfly_db_dump.sql\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" sh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\"\ncat \"keycloak_wildfly_db_dump.sql\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" sh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\ncat \"keycloak_wildfly_db_dump.sql\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" sh -c \"cat | PGPASSWORD='\"${postgresql_admin_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\n</code></pre> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#install-keycloak","title":"Install Keycloak","text":"<ol> <li> <p>Make sure the Keycloak chart repository is added:</p> <pre><code>helm repo add codecentric https://codecentric.github.io/helm-charts\nhelm repo update\n</code></pre> </li> <li> <p>Create Keycloak values:</p> <p>Note</p> <ul> <li><code>nameOverride: \"keycloak\"</code> sets the name of the Keycloak pod. It must be the same Keycloak name as in the previous <code>StatefulSet</code>.</li> <li>Change Ingress host name to the Keycloak host name.</li> <li><code>hostname: keycloak-postgresql</code> is the hostname of the pod with the Postgres database that is the same as Postgres StatefulSet name, for example, <code>keycloak-postgresql</code>.</li> <li><code>\"/opt/keycloak/bin/kc.sh start --auto-build\"</code> was used in the legacy Keycloak version. However, it is no longer required in the new Keycloak version since it is deprecated and used by default.</li> <li> <p>Optionally, use the following command for applying the old Keycloak theme:</p> <pre><code>bin/kc.sh start --features-disabled=admin2\n</code></pre> </li> </ul> <p>Info</p> <p>Automatic database migration will start after the Keycloak installation.</p> View: keycloak-values.yaml <pre><code>nameOverride: \"keycloak\"\n\nreplicas: 1\n\n# Deploy the latest verion\nimage:\ntag: \"19.0.1\"\n\n# start: create OpenShift realm which is required by EDP\nextraInitContainers: |\n- name: realm-provider\nimage: busybox\nimagePullPolicy: IfNotPresent\ncommand:\n- sh\nargs:\n- -c\n- |\necho '{\"realm\": \"openshift\",\"enabled\": true}' &gt; /opt/keycloak/data/import/openshift.json\nvolumeMounts:\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumeMounts: |\n- name: realm\nmountPath: /opt/keycloak/data/import\n\nextraVolumes: |\n- name: realm\nemptyDir: {}\n\ncommand:\n- \"/opt/keycloak/bin/kc.sh\"\n- \"--verbose\"\n- \"start\"\n- \"--http-enabled=true\"\n- \"--http-port=8080\"\n- \"--hostname-strict=false\"\n- \"--hostname-strict-https=false\"\n- \"--spi-events-listener-jboss-logging-success-level=info\"\n- \"--spi-events-listener-jboss-logging-error-level=warn\"\n- \"--import-realm\"\n\nextraEnv: |\n- name: KC_PROXY\nvalue: \"passthrough\"\n- name: KEYCLOAK_ADMIN\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: username\n- name: KEYCLOAK_ADMIN_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: keycloak-admin-creds\nkey: password\n- name: JAVA_OPTS_APPEND\nvalue: &gt;-\n-XX:+UseContainerSupport\n-XX:MaxRAMPercentage=50.0\n-Djava.awt.headless=true\n-Djgroups.dns.query={{ include \"keycloak.fullname\" . }}-headless\n\n# This block should be uncommented if you install Keycloak on Kubernetes\ningress:\nenabled: true\nannotations:\nkubernetes.io/ingress.class: nginx\ningress.kubernetes.io/affinity: cookie\nrules:\n- host: keycloak.&lt;ROOT_DOMAIN&gt;\npaths:\n- path: '{{ tpl .Values.http.relativePath $ | trimSuffix \"/\" }}/'\npathType: Prefix\n\n# This block should be uncommented if you set Keycloak to OpenShift and change the host field\n# route:\n#   enabled: false\n#   # Path for the Route\n#   path: '/'\n#   # Host name for the Route\n#   host: \"keycloak.&lt;ROOT_DOMAIN&gt;\"\n#   # TLS configuration\n#   tls:\n#     enabled: true\n\nresources:\nlimits:\nmemory: \"2048Mi\"\nrequests:\ncpu: \"50m\"\nmemory: \"512Mi\"\n\n# Check database readiness at startup\ndbchecker:\nenabled: true\n\ndatabase:\nvendor: postgres\nexistingSecret: keycloak-postgresql\nhostname: keycloak-postgresql\nport: 5432\nusername: admin\ndatabase: keycloak\n</code></pre> </li> <li> <p>Deploy Keycloak:</p> <p>Note</p> <p>Change the namespace and the values file name if required.</p> <pre><code>helm install keycloak codecentric/keycloakx --version 1.6.0 --values keycloak-values.yaml -n security\n</code></pre> </li> <li> <p>Log in to Keycloak and check if everything has been imported correctly.</p> </li> </ol>"},{"location":"operator-guide/upgrade-keycloak-19.0/#clean-and-analyze-database_1","title":"Clean and Analyze Database","text":"<p>Optionally, run the vacuumdb application on the database, to analyze the contents of database tables and collect statistics for the Postgres query optimizer:</p> <p><pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose -d keycloak -U postgres\n</code></pre> For all databases, run the following command:</p> <pre><code>PGPASSWORD=\"${postgresql_postgres-password}\" vacuumdb --analyze --verbose --all -U postgres\n</code></pre>"},{"location":"operator-guide/upgrade-keycloak-19.0/#postgres-database-migration-script","title":"Postgres Database Migration Script","text":"<p>Info</p> <p>Please read the Migrate Postgres Database From Postgres v.11.x to v.14.5 section of this tutorial before using the script.</p> <p>Note</p> <ul> <li>The <code>kubectl</code> tool is required for using this script.</li> <li>This script will likely work for any other Postgres database besides Keycloak after some adjustments. It queries the <code>pg_dump</code>, <code>pg_dumpall</code>, <code>psql</code>, and <code>vacuumdb</code> commands under the hood.</li> </ul> <p>The following script can be used for exporting and importing Postgres databases as well as optimizing them with the vacuumdb application. Please examine the code and make the adjustments if required.</p> <ul> <li> <p>By default, the following command exports Keycloak Postgres databases from a Kubernetes pod to a local machine:</p> <pre><code>./script.sh\n</code></pre> <p>After running the command, please follow the prompt.</p> </li> </ul> <ul> <li>To import a database backup to a newly created Postgres Kubernetes pod, pass a database dump sql file to the script:<pre><code>./script.sh path-to/db_dump.sql\n</code></pre> </li> </ul> <ul> <li>The <code>-h</code> flag prints help, and <code>-c|-v</code> runs the <code>vacuumdb</code> garbage collector and analyzer.</li> </ul> View: keycloak_db_migration.sh <pre><code>#!/bin/bash\n\n# set -x\n\ndb_migration_help(){\necho \"Keycloak Postgres database migration\"\necho\necho \"Usage:\"\necho \"------------------------------------------\"\necho \"Export Keycloak Postgres database from pod\"\necho \"Run without parameters:\"\necho \"      $0\"\necho \"------------------------------------------\"\necho \"Import Keycloak Postgres database to pod\"\necho \"Pass filename to script:\"\necho \"      $0 path/to/db_dump.sql\"\necho \"------------------------------------------\"\necho \"Additional options: \"\necho \"      $0 [OPTIONS...]\"\necho \"Options:\"\necho \"h     Print Help.\"\necho \"c|v   Run garbage collector and analyzer.\"\n}\n\nkeycloak_ns(){\nprintf '%s\\n' 'Enter keycloak namespace: '\nread -r keycloak_namespace\n\n    if [ -z \"${keycloak_namespace}\" ]; then\necho \"Don't skip namespace\"\nexit 1\nfi\n}\n\npostgres_pod(){\nprintf '%s\\n' 'Enter postgres pod name: '\nread -r postgres_pod_name\n\n    if [ -z \"${postgres_pod_name}\" ]; then\necho \"Don't skip pod name\"\nexit 1\nfi\n}\n\npostgres_user(){\nprintf '%s\\n' 'Enter postgres username: '\nprintf '%s' \"Skip to use [postgres] superuser: \"\nread -r postgres_username\n\n    if [ -z \"${postgres_username}\" ]; then\npostgres_username='postgres'\nfi\n}\n\npgdb_host_info(){\ndatabase_name='keycloak'\ndb_host='localhost'\ndb_port='5432'\n}\n\npostgresql_admin_pass(){\npostgresql_password='POSTGRES_PASSWORD'\npostgresql_admin_password=\"$(kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"printenv ${postgresql_password}\")\"\n}\n\npostgresql_su_pass(){\npostgresql_postgres_password='POSTGRES_POSTGRES_PASSWORD'\npostgresql_superuser_password=\"$(kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"printenv ${postgresql_postgres_password}\")\"\n\nif [ -z \"${postgresql_superuser_password}\" ]; then\necho \"SuperUser password variable does not exist. Using user password instead...\"\npostgresql_admin_pass\n        postgresql_superuser_password=\"${postgresql_admin_password}\"\nfi\n}\n\nkeycloak_pgdb_export(){\ncurrent_cluster=\"$(kubectl config current-context | tr -dc '[:alnum:]-')\"\nexported_db_name=\"keycloak_db_dump_${current_cluster}_${keycloak_namespace}_${postgres_username}_$(date +\"%Y%m%d%H%M\").sql\"\n\nif [ \"${postgres_username}\" == 'postgres' ]; then\n# call a function to get a pass for postgres user\npostgresql_su_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_superuser_password}\"' pg_dumpall -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\" &gt; \"${exported_db_name}\"\nelse\n# call a function to get a pass for admin user\npostgresql_admin_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_admin_password}\"' pg_dump -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\" &gt; \"${exported_db_name}\"\nfi\n\nseparate_lines=\"---------------\"\n\nif [ ! -s \"${exported_db_name}\" ]; then\nrm -f \"${exported_db_name}\"\necho \"${separate_lines}\"\necho \"Something went wrong. The database dump file is empty and was not saved.\"\nelse\necho \"${separate_lines}\"\ngrep 'Dumped' \"${exported_db_name}\" | sort -u\n        echo \"Database has been exported to $(pwd)/${exported_db_name}\"\nfi\n}\n\nkeycloak_pgdb_import(){\necho \"Preparing Import\"\necho \"----------------\"\n\nif [ ! -f \"$1\" ]; then\necho \"The file $1 does not exist.\"\nexit 1\nfi\n\nkeycloak_ns\n    postgres_pod\n    postgres_user\n    pgdb_host_info\n\n    if [ \"${postgres_username}\" == 'postgres' ]; then\n# restore full backup with all databases and roles as superuser or a single database\npostgresql_su_pass\n        if [ -n \"$(cat \"$1\" | grep 'CREATE ROLE')\" ]; then\ncat \"$1\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\"\nelse\ncat \"$1\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"cat | PGPASSWORD='\"${postgresql_superuser_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\nfi\nelse\n# restore a single database\npostgresql_admin_pass\n        cat \"$1\" | kubectl exec -i -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"cat | PGPASSWORD='\"${postgresql_admin_password}\"' psql -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\nfi\n}\n\nvacuum_pgdb(){\necho \"Preparing garbage collector and analyzer\"\necho \"----------------------------------------\"\n\nkeycloak_ns\n    postgres_pod\n    postgres_user\n    pgdb_host_info\n\n    if [ \"${postgres_username}\" == 'postgres' ]; then\npostgresql_su_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_superuser_password}\"' vacuumdb --analyze --all -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\"\"\nelse\npostgresql_admin_pass\n        kubectl exec -n \"${keycloak_namespace}\" \"${postgres_pod_name}\" \"--\" \\\nsh -c \"PGPASSWORD='\"${postgresql_admin_password}\"' vacuumdb --analyze -h \"${db_host}\" -p \"${db_port}\" -U \"${postgres_username}\" -d \"${database_name}\"\"\nfi\n}\n\nwhile [ \"$#\" -eq 1 ]; do\ncase \"$1\" in\n-h | --help)\ndb_migration_help\n            exit 0\n;;\n-c | --clean | -v | --vacuum)\nvacuum_pgdb\n            exit 0\n;;\n--)\nbreak\n;;\n-*)\necho \"Invalid option '$1'. Use -h|--help to see the valid options\" &gt;&amp;2\nexit 1\n;;\n*)\nkeycloak_pgdb_import \"$1\"\nexit 0\n;;\nesac\nshift\ndone\n\nif [ \"$#\" -gt 1 ]; then\necho \"Please pass a single file to the script\"\nexit 1\nfi\n\necho \"Preparing Export\"\necho \"----------------\"\nkeycloak_ns\npostgres_pod\npostgres_user\npgdb_host_info\nkeycloak_pgdb_export\n</code></pre>"},{"location":"operator-guide/upgrade-keycloak-19.0/#related-articles","title":"Related Articles","text":"<ul> <li>Deploy OKD 4.10 Cluster</li> </ul>"},{"location":"operator-guide/vcs/","title":"Overview","text":"<p>The Version Control Systems (VCS) section is dedicated to delivering comprehensive information on VCS within the EPAM Delivery Platform. This section comprises detailed descriptions of all the deployment strategies, along with valuable recommendations for their optimal usage, and the list of supported VCS, facilitating seamless integration with EDP.</p>"},{"location":"operator-guide/vcs/#supported-vcs","title":"Supported VCS","text":"<p>EDP can be integrated with the following Version Control Systems:</p> <ul> <li>Gerrit (used by default);</li> <li>GitHub;</li> <li>GitLab.</li> </ul> <p>Note</p> <p>So far, EDP doesn't support authorization mechanisms in the upstream GitLab.</p>"},{"location":"operator-guide/vcs/#vcs-deployment-strategies","title":"VCS Deployment Strategies","text":"<p>EDP offers the following strategies to work with repositories:</p> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with an application language, a build tool, and a framework selected while creating application. This strategy is recommended for projects that start developing their applications from scratch.</li> </ul> <p>Note</p> <p>Under the hood, all the built-in application frameworks, build tools and frameworks are stored in our public GitHub repository.</p> <ul> <li>Import project - enables working with the repository located in the added Git server. This scenario is preferred when the users already have an application stored in their own pre-configured repository and intends to continue working with their repository while also utilizing EDP simultaneously.</li> </ul> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitHub/GitLab in Jenkins or Integrate GitHub/GitLab in Tekton page. The Import project strategy is not applicable for Gerrit. Also, it is impossible to choose the Empty project field when using the Import project strategy while creating appication since it is implied that you already have a ready-to-work application in your own repository, whereas the \"Empty project\" option creates a repository but doesn't put anything in it.</p> <ul> <li>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. In this scenario, the application repository is forked from the original application repository to EDP. Since EDP doesn't support multiple VCS integration for now, this strategy is recommended when the user has several applications located in several repositories.</li> </ul>"},{"location":"operator-guide/vcs/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Add Application</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> </ul>"},{"location":"operator-guide/velero-irsa/","title":"IAM Roles for Velero Service Accounts","text":"<p>Note</p> <p>Make sure that IRSA is enabled and amazon-eks-pod-identity-webhook is deployed according to the Associate IAM Roles With Service Accounts documentation.</p> <p>Velero AWS plugin requires access to AWS resources. Follow the steps below to create a required role:</p> <ol> <li> <p>Create AWS IAM Policy \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero_policy\":</p> <pre><code>{\n\"Version\": \"2012-10-17\",\n\"Statement\": [\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"ec2:DescribeVolumes\",\n\"ec2:DescribeSnapshots\",\n\"ec2:CreateTags\",\n\"ec2:CreateVolume\",\n\"ec2:CreateSnapshot\",\n\"ec2:DeleteSnapshot\"\n],\n\"Resource\": \"*\"\n},\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"s3:GetObject\",\n\"s3:DeleteObject\",\n\"s3:PutObject\",\n\"s3:AbortMultipartUpload\",\n\"s3:ListMultipartUploadParts\"\n],\n\"Resource\": [\n\"arn:aws:s3:::velero-*/*\"\n]\n},\n{\n\"Effect\": \"Allow\",\n\"Action\": [\n\"s3:ListBucket\"\n],\n\"Resource\": [\n\"arn:aws:s3:::velero-*\"\n]\n}\n]\n}\n</code></pre> </li> <li> <p>Create AWS IAM Role \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\" with trust relationships:</p> <pre><code>{\n  \"Version\": \"2012-10-17\",\n  \"Statement\": [\n    {\n      \"Effect\": \"Allow\",\n      \"Principal\": {\n        \"Federated\": \"arn:aws:iam::&lt;AWS_ACCOUNT_ID&gt;:oidc-provider/&lt;OIDC_PROVIDER&gt;\"\n      },\n      \"Action\": \"sts:AssumeRoleWithWebIdentity\",\n      \"Condition\": {\n        \"StringEquals\": {\n          \"&lt;OIDC_PROVIDER&gt;:sub\": \"system:serviceaccount:&lt;VELERO_NAMESPACE&gt;:edp-velero\"\n       }\n     }\n   }\n ]\n}\n</code></pre> </li> <li> <p>Attach the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero_policy\" policy to the \"AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\" role.</p> </li> <li> <p>Make sure that Amazon S3 bucket with name velero-\u2039CLUSTER_NAME\u203a exists.</p> </li> <li> <p>Provide key value eks.amazonaws.com/role-arn: \"arn:aws:iam:::role/AWSIRSA\u2039CLUSTER_NAME\u203a\u2039VELERO_NAMESPACE\u203aVelero\" into the serviceAccount.server.annotations parameter in values.yaml during the Velero Installation."},{"location":"operator-guide/velero-irsa/#related-articles","title":"Related Articles","text":"<ul> <li>Associate IAM Roles With Service Accounts</li> <li>Install Velero</li> </ul>"},{"location":"operator-guide/waf-tf-configuration/","title":"Configure AWS WAF With Terraform","text":"<p>This page contains accurate information on how to configure AWS WAF using Terraform with the aim to have a secured traffic exposure and to prevent the Host Header vulnerabilities.</p>"},{"location":"operator-guide/waf-tf-configuration/#prerequisites","title":"Prerequisites","text":"<p>To follow the instruction, check the following prerequisites:</p> <ol> <li>Deployed infrastructure includes Nginx Ingress Controller</li> <li>Deployed services for testing</li> <li>Separate and exposed AWS ALB</li> <li>terraform 0.14.10</li> <li>hishicorp/aws = 4.8.0</li> </ol>"},{"location":"operator-guide/waf-tf-configuration/#solution-overview","title":"Solution Overview","text":"<p>The solution includes two parts:</p> <ol> <li>Prerequisites (mostly the left part of the scheme) - AWS ALB, Compute Resources (EC2, EKS, etc.).</li> <li>WAF configuration (the right part of the scheme).</li> </ol> <p>The WAF ACL resource is the main resource used for the configuration; The default web ACL option is Block.</p> <p> Overview WAF Solution </p> <p>The ACL includes three managed AWS rules that secure the exposed traffic:</p> <ul> <li>AWS-AWSManagedRulesCommonRuleSet</li> <li>AWS-AWSManagedRulesLinuxRuleSet</li> <li>AWS-AWSManagedRulesKnownBadInputsRuleSet</li> </ul> <p>AWS provides a lot of rules such as baseline and use-case specific rules, for details, please refer to the Baseline rule groups.</p> <p>There is the PreventHostInjections rule that prevents the Host Header vulnerabilities. This rule includes one statement that declares that the Host Header should match Regex Pattern Set, thus only in this case it will be passed.</p> <p>The Regex Pattern Set is another resource that helps to organize regexes, in fact, is a set of regexes. All regexes added to the single set are matched by the OR statement, i.e. when exposing several URLs, it is necessary to add this statement to the set and refer to it in the rule.</p>"},{"location":"operator-guide/waf-tf-configuration/#waf-acl-configuration","title":"WAF ACL Configuration","text":"<p>To create the Regex Pattern Set, inspect the following code:</p> <pre><code>resource \"aws_wafv2_regex_pattern_set\" \"common\" {\nname  = \"Common\"\nscope = \"REGIONAL\"\n\nregular_expression {\nregex_string = \"^.*(some-url).*((.edp-epam)+)\\\\.com$\"\n}\n\n  #  Add here additional regular expressions for other endpoints, they are merging with OR operator, e.g.\n\n  /*\n   regular_expression {\n      regex_string = \"^.*(jenkins).*((.edp-epam)+)\\\\.com$\"\n   }\n   */\n\ntags = var.tags\n}\n</code></pre> <p>It includes 'regex_string', for example: url - some-url.edp-epam.com, In addition, it is possible to add other links to the same resource using the regular_expression element.</p> <p>There is the Terraform code for the aws_wafv2_web_acl resource:</p> <pre><code>resource \"aws_wafv2_web_acl\" \"external\" {\nname  = \"ExternalACL\"\nscope = \"REGIONAL\"\n\ndefault_action {\nblock {}\n}\n\nrule {\nname     = \"AWS-AWSManagedRulesCommonRuleSet\"\npriority = 1\n\noverride_action {\nnone {}\n}\n\nstatement {\nmanaged_rule_group_statement {\nname        = \"AWSManagedRulesCommonRuleSet\"\nvendor_name = \"AWS\"\n}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"AWS-AWSManagedRulesCommonRuleSet\"\nsampled_requests_enabled   = true\n}\n}\n\nrule {\nname     = \"AWS-AWSManagedRulesLinuxRuleSet\"\npriority = 2\n\nstatement {\nmanaged_rule_group_statement {\nname        = \"AWSManagedRulesLinuxRuleSet\"\nvendor_name = \"AWS\"\n}\n}\n\noverride_action {\nnone {}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"AWS-AWSManagedRulesLinuxRuleSet\"\nsampled_requests_enabled   = true\n}\n}\n\nrule {\nname     = \"AWS-AWSManagedRulesKnownBadInputsRuleSet\"\npriority = 3\n\noverride_action {\nnone {}\n}\n\nstatement {\nmanaged_rule_group_statement {\nname        = \"AWSManagedRulesKnownBadInputsRuleSet\"\nvendor_name = \"AWS\"\n}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"AWS-AWSManagedRulesKnownBadInputsRuleSet\"\nsampled_requests_enabled   = true\n}\n}\n\nrule {\nname     = \"PreventHostInjections\"\npriority = 0\n\nstatement {\nregex_pattern_set_reference_statement {\narn = aws_wafv2_regex_pattern_set.common.arn\n\nfield_to_match {\nsingle_header {\nname = \"host\"\n}\n}\n\ntext_transformation {\npriority = 0\ntype     = \"NONE\"\n}\n}\n}\n\naction {\nallow {}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"PreventHostInjections\"\nsampled_requests_enabled   = true\n}\n}\n\nvisibility_config {\ncloudwatch_metrics_enabled = true\nmetric_name                = \"ExternalACL\"\nsampled_requests_enabled   = true\n}\n\ntags = var.tags\n}\n</code></pre> <p>As mentioned previously, ACL includes three managed AWS rules (group rules), for visibility, enabling sampling, and CloudWatch in the config. The 'PreventHostInjections' custom rule refers to the created pattern set and declares the Host Header, as well as sets the 'Action' if matched to 'Allow'.</p>"},{"location":"operator-guide/waf-tf-configuration/#associate-aws-resource","title":"Associate AWS Resource","text":"<p>To have the created ACL working, it is necessary to associate an AWS resource with it, in this case, it is AWS ALB:</p> <pre><code>resource \"aws_wafv2_web_acl_association\" \"waf_alb\" {\nresource_arn = aws_lb.&lt;aws_alb_for_waf&gt;.arn\nweb_acl_arn  = aws_wafv2_web_acl.external.arn\n}\n</code></pre> <p>Note</p> <p>AWS ALB can be created in the scope of this Terraform code or created previously. When creating ALB to expose links, the ALB should have a security group that allows some external traffic.</p> <p>When ALB is associated with the WAF ACL, direct the traffic to the ALB by the Route53 CNAME record:</p> <pre><code>module \"some_url_exposure\" {\nsource  = \"terraform-aws-modules/route53/aws//modules/records\"\nversion = \"2.0.0\"\n\nzone_name = \"edp-epam.com\"\n\nrecords = [\n{\nname    = \"some-url\"\ntype    = \"CNAME\"\nttl     = 300\nrecords = [aws_lb.&lt;aws_alb_for_waf&gt;.dns_name]\n}\n]\n}\n</code></pre> <p>In the sample above, the module is used, but it is also possible to use a Terraform resource.</p>"},{"location":"use-cases/","title":"Overview","text":"<p>The Use Cases section provides useful recommendations of how to operate with the EPAM Delivery Platform tools and manage the custom resources. Get acquainted with the description of technical scenarios and solutions.</p> <ul> <li>Scaffold and Deploy FastAPI Application</li> <li>Deploy Application With Custom Build Tool/Framework</li> <li>Secured Secrets Management for Application Deployment</li> <li>Autotest as a Quality Gate</li> </ul>"},{"location":"use-cases/application-scaffolding/","title":"Scaffold and Deploy FastAPI Application","text":""},{"location":"use-cases/application-scaffolding/#overview","title":"Overview","text":"<p>This use case describes the creation and deployment of a FastAPI application to enable a developer to quickly generate a functional code structure for a FastAPI web application (with basic read functionality), customize it to meet specific requirements, and deploy it to a development environment. By using a scaffolding tool and a standardized process for code review, testing and deployment, developers can reduce the time and effort required to build and deploy a new application while improving the quality and reliability of the resulting code. Ultimately, the goal is to enable the development team to release new features and applications more quickly and efficiently while maintaining high code quality and reliability.</p> <p></p>"},{"location":"use-cases/application-scaffolding/#roles","title":"Roles","text":"<p>This documentation is tailored for the Developers and Team Leads.</p>"},{"location":"use-cases/application-scaffolding/#goals","title":"Goals","text":"<ul> <li>Create a new FastAPI application quickly.</li> <li>Deploy the initial code to the DEV environment.</li> <li>Check CI pipelines.</li> <li>Perform code review.</li> <li>Delivery update by deploying the new version.</li> </ul>"},{"location":"use-cases/application-scaffolding/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance is configured with Gerrit, Tekton and Argo CD.</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach.</li> <li>Developer has the <code>Administrator</code> role (to perform merge in Gerrit).</li> </ul>"},{"location":"use-cases/application-scaffolding/#scenario","title":"Scenario","text":"<p>To scaffold and deploy FastAPI Application, follow the steps below.</p>"},{"location":"use-cases/application-scaffolding/#scaffold-the-new-fastapi-application","title":"Scaffold the New FastAPI Application","text":"<ol> <li> <p>Open EDP Portal URL. Use the Sign-In option.</p> <p> Logging screen </p> </li> <li> <p>Ensure <code>Namespace</code> value in the User <code>Settings</code> tab points to the namespace with the EDP installation.</p> <p> Settings button </p> </li> <li> <p>Create the new <code>Codebase</code> with the <code>Application</code> type using the <code>Create</code> strategy. To do this, open EDP tab.</p> <p> Cluster overview </p> </li> <li> <p>Select the <code>Components</code> Section under the EDP tab and push the create <code>+</code> button.</p> <p> Components tab </p> </li> <li> <p>Select the <code>Application</code> Codebase type because we are going to deliver our application as a container and deploy it inside the Kubernetes cluster. Choose the <code>Create</code> strategy to scaffold our application from the template provided by the EDP and press the <code>Proceed</code> button.</p> <p> Step codebase info </p> </li> <li> <p>On the Application Info tab, define the following values and press the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>fastapi-demo</code></li> <li>Default branch: <code>main</code></li> <li>Application code language: <code>Python</code></li> <li>Language version/framework: <code>FastAPI</code></li> <li>Build tool: <code>Python</code></li> </ul> <p> Application info </p> </li> <li> <p>On the <code>Advances Settings</code> tab, define the below values and push the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>edp</code></li> <li>Start version from: <code>0.0.1</code> and <code>SNAPSHOT</code></li> </ul> <p> Advanced settings </p> </li> <li> <p>Check the application status. It should be green:</p> <p> Application status </p> </li> </ol>"},{"location":"use-cases/application-scaffolding/#deploy-the-application-to-the-development-environment","title":"Deploy the Application to the Development Environment","text":"<p>This section describes the application deployment approach from the latest branch commit. The general steps are:</p> <ul> <li>Build the initial version (generated from the template) of the application from the last commit of the <code>main</code> branch.</li> </ul> <ul> <li>Create a <code>CD Pipeline</code> to establish continuous delivery to the development environment. </li> </ul> <ul> <li>Deploy the initial version to the development env.</li> </ul> <p>To succeed with the steps above, follow the instructions below:</p> <ol> <li> <p>Build Container from the latest branch commit. To build the initial version of the application's main branch, go to the fastapi-demo application -&gt; branches -&gt; main and select the <code>Build</code> menu.</p> <p> Application building </p> </li> <li> <p>Build pipeline for the <code>fastapi-demo</code> application starts.</p> <p> Pipeline building </p> </li> <li> <p>Track Pipeline's status by accessing Tekton Dashboard by clicking the <code>fastapi-demo-main-build-lb57m</code> application link.</p> <p> Console logs </p> </li> <li> <p>Ensure that Build Pipeline was successfully completed.</p> </li> <li> <p>Create CD Pipeline. To enable application deployment create a CD Pipeline with a single environment - Development (with the name <code>dev</code>).</p> </li> <li> <p>Go to EDP Portal -&gt; EDP -&gt; CD Pipelines tab and push the <code>+</code> button to create pipeline. In the <code>Create CD Pipeline</code> dialog, define the below values:</p> <ul> <li> <p>Pipeline tab:</p> <ul> <li>Pipeline name: <code>mypipe</code></li> <li>Deployment type: <code>Container</code>, since we are going to deploy containers</li> </ul> <p> Pipeline tab with parameters </p> </li> </ul> <ul> <li> <p>Applications tab. Add <code>fastapi-demo</code> application, select <code>main</code> branch, and leave <code>Promote in pipeline</code> unchecked:</p> <p> Applications tab with parameters </p> </li> </ul> <ul> <li> <p>Stages tab. Add the <code>dev</code> stage with the values below:</p> <ul> <li>Stage name: <code>dev</code></li> <li>Description: <code>Development Environment</code></li> <li>Trigger type: <code>Manual</code>. We plan to deploy applications to this environment manually</li> <li>Quality gate type: <code>Manual</code></li> <li>Step name: <code>approve</code></li> <li>Push the <code>Apply</code> button</li> </ul> <p> Stages tab with parameters </p> </li> </ul> </li> <li> <p>Deploy the initial version of the application to the development environment:</p> <ul> <li>Open CD Pipeline with the name <code>mypipe</code>.</li> <li>Select the <code>dev</code> stage from the Stages tab.</li> <li>In the <code>Image stream version</code> select version <code>0.0.1-SNAPSHOT.1</code> and push the <code>Deploy</code> button.</li> </ul> <p> CD Pipeline deploy </p> </li> </ol>"},{"location":"use-cases/application-scaffolding/#check-the-application-status","title":"Check the Application Status","text":"<p>To ensure the application is deployed successfully, follow the steps below:</p> <ol> <li> <p>Ensure application status is <code>Healthy</code> and <code>Synced</code>, and the <code>Deployed version</code> points to <code>0.0.1-SNAPSHOT.1</code>:</p> <p> Pipeline health status </p> </li> <li> <p>Check that the selected version of the container is deployed on the <code>dev</code> environment. <code>${EDP_ENV}</code> - is the EDP namespace name:</p> <pre><code># Check the deployment status of fastapi-demo application\n$ kubectl get deployments -n ${EDP_ENV}-mypipe-dev\nNAME                 READY   UP-TO-DATE   AVAILABLE   AGE\nfastapi-demo-dl1ft   1/1     1            1           30m\n\n# Check the image version of fastapi-demo application\n$ kubectl get pods -o jsonpath=\"{.items[*].spec.containers[*].image}\" -n ${EDP_ENV}-mypipe-dev\n012345678901.dkr.ecr.eu-central-1.amazonaws.com/${EDP_ENV}/fastapi-demo:0.0.1-SNAPSHOT.1\n</code></pre> </li> </ol>"},{"location":"use-cases/application-scaffolding/#deliver-new-code","title":"Deliver New Code","text":"<p>This section describes the <code>Code Review</code> process for a new code. We need to deploy a new version of our <code>fastapi-demo</code> application that deploys <code>Ingress</code> object to expose API outside the Kubernetes cluster.</p> <p>Perform the below steps to merge new code (Pull Request) that passes the Code Review flow. For the steps below, we use Gerrit UI but the same actions can be performed using the command line and git tool:</p> <ol> <li> <p>Login to Gerrit UI, select <code>fastapi-demo</code> project, and create a change request.</p> </li> <li> <p>Browse Gerrit Repositories and select <code>fastapi-demo</code> project.</p> <p> Browse Gerrit repositories </p> </li> <li> <p>In the <code>Commands</code> section of the project, push the <code>Create Change</code> button.</p> <p> Create Change request </p> </li> <li> <p>In the <code>Create Change</code> dialog, provide the branch <code>main</code> and the <code>Description</code> (commit message):</p> <pre><code>Enable ingress for application\n\nCloses: #xyz\n</code></pre> </li> <li> <p>Push the <code>Create</code> button.</p> <p> Create Change </p> </li> <li> <p>Push the <code>Edit</code> button of the merge request and add <code>deployment-templates/values.yaml</code> for modification.</p> <p> Update values.yaml file </p> </li> <li> <p>Review the <code>deployment-templates/values.yaml</code> file and change the <code>ingress.enabled</code> flag from <code>false</code> to <code>true</code>. Then push the <code>SAVE &amp; PUBLISH</code> button. As soon as you get <code>Verified +1</code> from CI, you are ready for review: Push the <code>Mark as Active</code> button.</p> <p> Review Change </p> </li> <li> <p>You can always check your pipelines status from:</p> <ul> <li>Gerrit UI.</li> </ul> <p> Pipeline Status Gerrit </p> <ul> <li>EDP Portal.</li> </ul> <p> Pipeline Status EDP Portal </p> </li> <li> <p>With no Code Review Pipeline issues, set <code>Code-Review +2</code> for the patchset and push the <code>Submit</code> button. Then, your code is merged to the <code>main</code> branch, triggering the Build Pipeline. The build Pipeline produces the new version of artifact: <code>0.0.1-SNAPSHOT.2</code>, which is available for the deployment.</p> <p> Gerrit Code Review screen </p> </li> <li> <p>Deliver the New Version to the Environment. Before the new version deployment, check the ingress object in <code>dev</code> namespace:</p> <pre><code>$ kubectl get ingress -n ${EDP_ENV}-mypipe-dev\nNo resources found in ${EDP_ENV}-mypipe-dev namespace.\n</code></pre> <p>No ingress object exists as expected.</p> </li> <li> <p>Deploy the new version <code>0.0.1-SNAPSHOT.2</code> which has the ingress object in place. Since we use <code>Manual</code> deployment approach, we perform version upgrade by hand.</p> <ul> <li>Go to the <code>CD Pipelines</code> section of the <code>EDP Portal</code>, select <code>mypipe</code> pipeline and choose <code>dev</code> stage.</li> <li>In the <code>Image stream version</code> select the new version <code>0.0.1-SNAPSHOT.2</code> and push the <code>Update</code> button.</li> <li>Check that the new version is deployed: application status is <code>Healthy</code> and <code>Synced</code>, and the <code>Deployed version</code> points to <code>0.0.1-SNAPSHOT.2</code>.</li> </ul> <p> CD Pipeline Deploy New Version </p> </li> <li> <p>Check that the new version with Ingress is deployed:</p> <pre><code># Check the version of the deployed image\nkubectl get pods -o jsonpath=\"{.items[*].spec.containers[*].image}\" -n ${EDP_ENV}-mypipe-dev\n012345678901.dkr.ecr.eu-central-1.amazonaws.com/edp-delivery-tekton-dev/fastapi-demo:0.0.1-SNAPSHOT.2\n\n# Check Ingress object\nkubectl get ingress -n ${EDP_ENV}-mypipe-dev\nNAME                 CLASS    HOSTS                            ADDRESS          PORTS   AGE\nfastapi-demo-ko1zs   &lt;none&gt;   fastapi-demo-ko1zs-example.com   12.123.123.123   80      115s\n\n# Check application external URL\ncurl https://your-hostname-appeared-in-hosts-column-above.example.com/\n{\"Hello\":\"World\"}\n</code></pre> </li> </ol>"},{"location":"use-cases/application-scaffolding/#related-articles","title":"Related Articles","text":"<ul> <li>Use Cases</li> </ul>"},{"location":"use-cases/autotest-as-quality-gate/","title":"Autotest as a Quality Gate","text":"<p>This use case describes the flow of adding an autotest as a quality gate to a newly created CD pipeline with a selected build version of an application to be promoted. The purpose of autotests is to check if application meets predefined criteria for stability and functionality, ensuring that only reliable versions are promoted. The promotion feature allows users to implement complicated testing, thus improving application stability.</p>"},{"location":"use-cases/autotest-as-quality-gate/#roles","title":"Roles","text":"<p>This documentation is tailored for the Developers and Quality Assurance specialists.</p>"},{"location":"use-cases/autotest-as-quality-gate/#goals","title":"Goals","text":"<ul> <li>Create several applications and autotests quickly.</li> <li>Create a pipeline for Continuous Deployment.</li> <li>Perform testing.</li> <li>Update delivery by deploying the new version.</li> </ul>"},{"location":"use-cases/autotest-as-quality-gate/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance is configured with Gerrit, Tekton and Argo CD.</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach.</li> <li>Developer has the Administrator role (to perform merge in Gerrit).</li> </ul>"},{"location":"use-cases/autotest-as-quality-gate/#create-applications","title":"Create Applications","text":"<p>To implement autotests as Quality Gates, follow the steps below:</p> <ol> <li> <p>Ensure the namespace is specified in the cluster settings. Click the Settings icon in the top right corner and select Cluster settings:</p> <p> Cluster settings </p> </li> <li> <p>Enter the name of the default namespace, then enter your default namespace in the Allowed namespaces field and click the + button. You can also add other namespaces to the Allowed namespaces:</p> <p> Specify namespace </p> </li> <li> <p>Create several applications using the Create strategy. Navigate to the EDP tab, choose Components, click the + button:</p> <p> Add component </p> </li> <li> <p>Select Application and Create from template:</p> <p> Create new component menu </p> <p>Note</p> <p>Please refer to the Add Application section for details.</p> </li> <li> <p>On the Codebase info tab, define the following values and press the Proceed button:</p> <ul> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>js-application</code></li> <li>Component name: <code>js-application</code></li> <li>Description: <code>js application</code></li> <li>Application code language: <code>JavaScript</code></li> <li>Language version/Provider: <code>Vue</code></li> <li>Build tool: <code>NPM</code></li> </ul> <p> Codebase info tab </p> </li> <li> <p>On the Advanced settings tab, define the below values and push the Apply button:</p> <ul> <li>Default branch: <code>main</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> <p> Advanced settings tab </p> </li> <li> <p>Repeat the procedure twice to create the go-application and python-application applications. These applications will have the following parameters:</p> <p>go-application:</p> <ul> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>go-application</code></li> <li>Component name: <code>go-application</code></li> <li>Description: <code>go application</code></li> <li>Application code language: <code>Go</code></li> <li>Language version/Provider: <code>Gin</code></li> <li>Build tool: <code>Go</code></li> <li>Default branch: <code>main</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> <p>python-application:</p> <ul> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>python-application</code></li> <li>Component name: <code>python-application</code></li> <li>Description: <code>python application</code></li> <li>Application code language: <code>Python</code></li> <li>Language version/Provider: <code>FastAPI</code></li> <li>Build tool: <code>Python</code></li> <li>Default branch: <code>main</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> </li> <li> <p>In the Components tab, click one of the applications name to enter the application menu:</p> <p> Components list </p> </li> <li> <p>Click the three dots (\u22ee) button, select Build:</p> <p> Application menu </p> </li> <li> <p>Click the down arrow (v) to observe and wait for the application to be built:</p> <p> Application building </p> </li> <li> <p>Click the application run name to watch the building logs in Tekton:</p> <p> Tekton pipeline run </p> </li> <li> <p>Wait till the build is successful:</p> <p> Successful build </p> </li> <li> <p>Repeat steps 8-12 for the rest of the applications.</p> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#create-autotests","title":"Create Autotests","text":"<p>The steps below instruct how to create autotests in EDP:</p> <ol> <li> <p>Create a couple of autotests using the Create strategy. Navigate to the EDP tab, choose Components, click on the + button. Select Autotest and Clone project:</p> <p> Add autotest </p> <p>Note</p> <p>Please refer to the Add Autotest section for details.</p> </li> <li> <p>On the Codebase info tab, define the following values and press the Proceed button:</p> <ul> <li>Repository URL: <code>https://github.com/SergK/autotests.git</code></li> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>demo-autotest-gradle</code></li> <li>Component name: <code>demo-autotest-gradle</code></li> <li>Description: <code>demo-autotest-gradle</code></li> <li>Autotest code language: <code>Java</code></li> <li>Language version/framework: <code>Java11</code></li> <li>Build tool: <code>Gradle</code></li> <li>Autotest report framework: <code>Allure</code></li> </ul> <p> Codebase info tab for autotests </p> </li> <li> <p>On the Advanced settings tab, leave the settings as is and click the Apply button:</p> <p> Advanced settings tab for autotests </p> </li> <li> <p>Repeat the steps 1-3 to create one more autotest with the parameters below:</p> <ul> <li>Repository URL: <code>https://github.com/Rolika4/autotests.git</code></li> <li>Git server: <code>gerrit</code></li> <li>Git repo relative path: <code>demo-autotest-maven</code></li> <li>Component name: <code>demo-autotest-maven</code></li> <li>Description: <code>demo-autotest-maven</code></li> <li>Autotest code language: <code>Java</code></li> <li>Language version/framework: <code>Java11</code></li> <li>Build tool: <code>Maven</code></li> <li>Autotest report framework: <code>Allure</code></li> </ul> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#create-cd-pipeline","title":"Create CD Pipeline","text":"<p>Now that applications and autotests are created, create pipeline for them by following the steps below:</p> <ol> <li> <p>Navigate to the CD Pipelines tab and click the + button:</p> <p> CD pipelines tab </p> </li> <li> <p>On the Pipeline tab, in the Pipeline name field, enter demo-pipeline:</p> <p> Pipeline tab </p> </li> <li> <p>On the Applications tab, add all the three applications, specify the main branch for all for them and check Promote in pipeline for Go and JavaScript applications:</p> <p> Applications tab </p> </li> <li> <p>On the Stages tab, click the Add stage button to open the Create stage menu:</p> <p> Stages tab </p> </li> <li> <p>In the Create stage menu, specify the following parameters and click Apply:</p> <ul> <li>Cluster: <code>In cluster</code></li> <li>Stage name: <code>dev</code></li> <li>Description: <code>dev</code></li> <li>Trigger type: <code>manual</code></li> <li>Quality gate type: <code>Autotests</code></li> <li>Step name: <code>dev</code></li> <li>Autotest: <code>demo-autotest-gradle</code></li> <li>Autotest branch: <code>main</code></li> </ul> <p> Create stage menu </p> </li> <li> <p>After the dev stage is added, click Apply:</p> <p> Create stage menu </p> </li> <li> <p>After the pipeline is created, click its name to open the pipeline details page:</p> <p> Enter pipeline </p> </li> <li> <p>In the pipeline details page, click the Create button to create a new stage:</p> <p> Create a new stage </p> </li> <li> <p>In the Create stage menu, specify the following parameters:</p> <ul> <li>Cluster: <code>In cluster</code></li> <li>Stage name: <code>sit</code></li> <li>Description: <code>sit</code></li> <li>Trigger type: <code>manual</code></li> <li>Quality gate type: <code>Autotests</code></li> <li>Step name: <code>dev</code></li> <li>Autotest: <code>demo-autotest-maven</code></li> <li>Autotest branch: <code>main</code></li> </ul> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#run-autotests","title":"Run Autotests","text":"<p>After the CD pipeline is created, deploy applications and run autotests by following the steps below:</p> <ol> <li> <p>Click the dev stage name to expand its details, specify image versions for each of the applications in the Image stream version field and click Deploy:</p> <p> Deploy applications </p> </li> <li> <p>Once applications are built, scroll down to Quality Gates and click Promote:</p> <p> Promote in pipeline </p> </li> <li> <p>Once promotion procedure is finished, the promoted applications will become available in the Sit stage. You will be able to select image stream versions for the promoted applications. The non-promoted application will stay grey in the stage and won't be allowed to get deployed:</p> <p> Sit stage </p> </li> </ol>"},{"location":"use-cases/autotest-as-quality-gate/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add CD Pipeline</li> <li>Add Quality Gate</li> </ul>"},{"location":"use-cases/external-secrets/","title":"Secured Secrets Management for Application Deployment","text":"<p>This Use Case demonstrates how to securely manage sensitive data, such as passwords, API keys, and other credentials, that are consumed by application during development or runtime in production. The approach involves storing sensitive data in an external secret store that is located in a \"vault\" namespace (but can be Vault, AWS Secret Store or any other provider). The process implies transmitting confidential information from the vault namespace to the deployed namespace for the purpose of establishing a connection to a database.</p>"},{"location":"use-cases/external-secrets/#roles","title":"Roles","text":"<p>This documentation is tailored for the Developers and Team Leads.</p>"},{"location":"use-cases/external-secrets/#goals","title":"Goals","text":"<ul> <li>Make confidential information usage secure in the deployment environment.</li> </ul>"},{"location":"use-cases/external-secrets/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance is configured with Gerrit, Tekton and Argo CD;</li> <li>External Secrets is installed;</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach;</li> <li>Developer has the <code>Administrator</code> role (to perform merge in Gerrit);</li> <li>Developer has access to manage secrets in demo-vault namespace.</li> </ul>"},{"location":"use-cases/external-secrets/#scenario","title":"Scenario","text":"<p>To use External Secret in EDP approach, follow the steps below:</p>"},{"location":"use-cases/external-secrets/#add-application","title":"Add Application","text":"<p>To begin, you will need an application first. Here are the steps to create it:</p> <ol> <li> <p>Open EDP Portal URL. Use the <code>Sign-In</code> option:</p> <p> Logging screen </p> </li> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and ensure that both <code>Default namespace</code> and <code>Allowed namespace</code> are set:</p> <p> Cluster settings </p> </li> <li> <p>Create the new <code>Codebase</code> with the <code>Application</code> type using the <code>Create</code> strategy. To do this, click the <code>EDP</code> tab:</p> <p> Cluster overview </p> </li> <li> <p>Select the <code>Components</code> section under the EDP tab and push the <code>+</code> button:</p> <p> Components tab </p> </li> <li> <p>Select the <code>Application</code> Codebase type because we are going to deliver our application as a container and deploy it inside the Kubernetes cluster. Select the <code>Create</code> strategy to use predefined template:</p> <p> Step codebase info </p> </li> <li> <p>On the <code>Application Info</code> tab, define the following values and press the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>es-usage</code></li> <li>Default branch: <code>master</code></li> <li>Application code language: <code>Java</code></li> <li>Language version/framework: <code>Java 17</code></li> <li>Build tool: <code>Maven</code></li> </ul> <p> Step application info </p> </li> <li> <p>On the <code>Advanced Settings</code> tab, define the below values and push the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>default</code></li> </ul> <p> Step application info </p> </li> <li> <p>Check the application status. It should be green:</p> <p> Application status </p> </li> </ol>"},{"location":"use-cases/external-secrets/#create-cd-pipeline","title":"Create CD Pipeline","text":"<p>This section outlines the process of establishing a CD pipeline within EDP Portal. There are two fundamental steps in this procedure:</p> <ul> <li>Build the application from the last commit of the <code>master</code> branch;</li> </ul> <ul> <li>Create a <code>CD Pipeline</code> to establish continuous delivery to the SIT environment.</li> </ul> <p>To succeed with the steps above, follow the instructions below:</p> <ol> <li> <p>Create CD Pipeline. To enable application deployment, create a CD Pipeline with a single environment - System Integration Testing (SIT for short). Select the <code>CD Pipelines</code> section under the <code>EDP</code> tab and push the <code>+</code> button:</p> <p> CD-Pipeline tab </p> </li> <li> <p>On the <code>Pipeline</code> tab, define the following values and press the <code>Proceed</code> button:</p> <ul> <li>Pipeline name: <code>deploy</code></li> <li>Deployment type: <code>Container</code></li> </ul> <p> Pipeline tab </p> </li> <li> <p>On the <code>Applications</code> tab, add <code>es-usage</code> application, select <code>master</code> branch, leave <code>Promote in pipeline</code> unchecked and press the <code>Proceed</code> button:</p> <p> Pipeline tab </p> </li> <li> <p>On the <code>Stage</code> tab, add the <code>sit</code> stage with the values below and push the <code>Apply</code> button:</p> <ul> <li>Stage name: <code>sit</code></li> <li>Description: <code>System integration testing</code></li> <li>Trigger type: <code>Manual</code>. We plan to deploy applications to this environment manually</li> <li>Quality gate type: <code>Manual</code></li> <li> <p>Step name: <code>approve</code></p> <p> Stage tab </p> </li> </ul> </li> </ol>"},{"location":"use-cases/external-secrets/#configure-rbac-for-external-secret-store","title":"Configure RBAC for External Secret Store","text":"<p>Note</p> <p>In this scenario, three namespaces are used: <code>demo</code>, which is the namespace where EDP is deployed, <code>demo-vault</code>, which is the vault where developers store secrets, and<code>demo-deploy-sit</code>, which is the namespace used for deploying the application. The target namespace name for deploying application is formed with the pattern: <code>edp-&lt;cd_pipeline_name&gt;-&lt;stage_name&gt;</code>.</p> <p>To make the system to function properly, it is imperative to create the following resources:</p> <ol> <li> <p>Create namespace <code>demo-vault</code> to store secrets:</p> <pre><code> kubectl create namespace demo-vault\n</code></pre> </li> <li> <p>Create Secret:</p> <pre><code>apiVersion: v1\nkind: Secret\nmetadata:\nname: mongo\nnamespace: demo-vault\nstringData:\npassword: pass\nusername: user\ntype: Opaque\n</code></pre> </li> <li> <p>Create Role to access the secret:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: Role\nmetadata:\nnamespace: demo-vault\nname: external-secret-store\nrules:\n- apiGroups: [\"\"]\nresources:\n- secrets\nverbs:\n- get\n- list\n- watch\n- apiGroups:\n- authorization.k8s.io\nresources:\n- selfsubjectrulesreviews\nverbs:\n- create\n</code></pre> </li> <li> <p>Create RoleBinding:</p> <pre><code>apiVersion: rbac.authorization.k8s.io/v1\nkind: RoleBinding\nmetadata:\nname: eso-from-edp\nnamespace: demo-vault\nsubjects:\n- kind: ServiceAccount\nname: secret-manager\nnamespace: demo-deploy-sit\nroleRef:\napiGroup: rbac.authorization.k8s.io\nkind: Role\nname: external-secret-store\n</code></pre> </li> </ol>"},{"location":"use-cases/external-secrets/#add-external-secret-to-helm-chart","title":"Add External Secret to Helm Chart","text":"<p>Now that RBAC is configured properly, it is time to add external secrets templates to application Helm chart. Follow the instructions provided below:</p> <ol> <li> <p>Navigate to <code>EDP Portal</code> -&gt; <code>EDP</code> -&gt; <code>Overview</code>, and push the Gerrit link:</p> <p> Overview page </p> </li> <li> <p>Log in to Gerrit UI, select <code>Repositories</code> and select <code>es-usage</code> project:</p> <p> Browse Gerrit repositories </p> </li> <li> <p>In the <code>Commands</code> section of the project, push the <code>Create Change</code> button:</p> <p> Create Change request </p> </li> <li> <p>In the <code>Create Change</code> dialog, provide the branch <code>master</code> and fill in the <code>Description</code> (commit message) field and push the <code>Create</code> button:</p> <pre><code>Add external secrets templates\n</code></pre> <p> Create Change </p> </li> <li> <p>Push the <code>Edit</code> button of the merge request and then the <code>ADD/OPEN/UPLOAD</code> button and add files:</p> <p> Add files to repository </p> <p>Once the file menu is opened, and click <code>SAVE</code> after editing each of the files:</p> <ol> <li> <p>deploy-templates/templates/sa.yaml:</p> <pre><code>apiVersion: v1\nkind: ServiceAccount\nmetadata:\nname: secret-manager\nnamespace: demo-deploy-sit\n</code></pre> </li> <li> <p>deploy-templates/templates/secret-store.yaml:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: SecretStore\nmetadata:\nname: demo\nnamespace: demo-deploy-sit\nspec:\nprovider:\nkubernetes:\nremoteNamespace: demo-vault\nauth:\nserviceAccount:\nname: secret-manager\nserver:\ncaProvider:\ntype: ConfigMap\nname: kube-root-ca.crt\nkey: ca.crt\n</code></pre> </li> <li> <p>deploy-templates/templates/external-secret.yaml:</p> <pre><code>apiVersion: external-secrets.io/v1beta1\nkind: ExternalSecret\nmetadata:\nname: mongo                            # target secret name\nnamespace: demo-deploy-sit    # target namespace\nspec:\nrefreshInterval: 1h\nsecretStoreRef:\nkind: SecretStore\nname: demo\ndata:\n- secretKey: username                   # target value property\nremoteRef:\nkey: mongo                          # remote secret key\nproperty: username                  # value will be fetched from this field\n- secretKey: password                   # target value property\nremoteRef:\nkey: mongo                          # remote secret key\nproperty: password                  # value will be fetched from this field\n</code></pre> </li> <li> <p>deploy-templates/templates/deployment.yaml. Add the environment variable for mongodb to the existing deployment configuration that used the secret:</p> <pre><code>          env:\n- name: MONGO_USERNAME\nvalueFrom:\nsecretKeyRef:\nname: mongo\nkey: username\n- name: MONGO_PASSWORD\nvalueFrom:\nsecretKeyRef:\nname: mongo\nkey: password\n</code></pre> </li> </ol> </li> <li> <p>Push the <code>Publish Edit</code> button.</p> </li> <li> <p>As soon as review pipeline finished, and you get <code>Verified +1</code> from CI, you are ready for review. Click <code>Mark as Active</code> -&gt; <code>Code-Review +2</code> -&gt; <code>Submit</code>:</p> <p> Apply change </p> </li> </ol>"},{"location":"use-cases/external-secrets/#deploy-application","title":"Deploy Application","text":"<p>Deploy the application by following the steps provided below:</p> <ol> <li> <p>When build pipeline is finished, navigate to <code>EDP Portal</code> -&gt; <code>EDP</code> -&gt; <code>CD-Pipeline</code> and select <code>deploy</code> pipeline.</p> </li> <li> <p>Deploy the initial version of the application to the SIT environment:</p> <ul> <li>Select the <code>sit</code> stage from the Stages tab;</li> <li>In the <code>Image stream version</code>, select latest version and push the <code>Deploy</code> button.</li> </ul> </li> <li> <p>Ensure application status is <code>Healthy</code> and <code>Synced</code>:</p> <p> CD-Pipeline status </p> </li> </ol>"},{"location":"use-cases/external-secrets/#check-application-status","title":"Check Application Status","text":"<p>To ensure the application is deployed successfully, do the following:</p> <ol> <li> <p>Check that the resources are deployed:</p> <pre><code>kubectl get secretstore -n demo-deploy-sit\nNAME                           AGE     STATUS   READY\ndemo                           5m57s   Valid    True\n</code></pre> <pre><code>kubectl get externalsecret -n demo-deploy-sit\nNAME    STORE                          REFRESH INTERVAL   STATUS         READY\nmongo   demo                           1h                 SecretSynced   True\n</code></pre> </li> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and add <code>demo-deploy-sit</code> to the <code>Allowed namespace</code>.</p> </li> <li> <p>Navigate <code>EDP Portal</code> -&gt; <code>Configuration</code> -&gt; <code>Secrets</code> and ensure that secret was created:</p> <p> Secrets </p> </li> <li> <p>Navigate <code>EDP Portal</code> -&gt; <code>Workloads</code> -&gt; <code>Pods</code> and select deployed application:</p> <p> Pod information </p> </li> </ol>"},{"location":"use-cases/external-secrets/#related-articles","title":"Related Articles","text":"<ul> <li>Use Cases</li> <li>Add Application</li> <li>CD Pipeline</li> </ul>"},{"location":"use-cases/tekton-custom-pipelines/","title":"Deploy Application With Custom Build Tool/Framework","text":"<p>This Use Case describes the procedure of adding custom Tekton libraries that include pipelines with tasks. In addition to it, the process of modifying custom pipelines and tasks is enlightened as well.</p>"},{"location":"use-cases/tekton-custom-pipelines/#goals","title":"Goals","text":"<ul> <li>Add custom Tekton pipeline library;</li> <li>Modify existing pipelines and tasks in a custom Tekton library.</li> </ul>"},{"location":"use-cases/tekton-custom-pipelines/#preconditions","title":"Preconditions","text":"<ul> <li>EDP instance with Gerrit and Tekton inside is configured;</li> <li>Developer has access to the EDP instances using the Single-Sign-On approach;</li> <li>Developer has the <code>Administrator</code> role to perform merge in Gerrit.</li> </ul>"},{"location":"use-cases/tekton-custom-pipelines/#scenario","title":"Scenario","text":"<p>Note</p> <p>This case is based on our predefined repository and application. Your case may be different.</p> <p>To create and then modify a custom Tekton library, please follow the steps below:</p>"},{"location":"use-cases/tekton-custom-pipelines/#add-custom-application-to-edp","title":"Add Custom Application to EDP","text":"<ol> <li> <p>Open EDP Portal URL. Use the Sign-In option:</p> <p> Logging screen </p> </li> <li> <p>In the top right corner, enter the <code>Cluster settings</code> and ensure that both <code>Default namespace</code> and <code>Allowed namespace</code> are set:</p> <p> Cluster settings </p> </li> <li> <p>Create the new <code>Codebase</code> with the <code>Application</code> type using the <code>Clone</code> strategy. To do this, click the EDP tab:</p> <p> Cluster overview </p> </li> <li> <p>Select the <code>Components</code> section under the EDP tab and push the create <code>+</code> button:</p> <p> Components tab </p> </li> <li> <p>Select the <code>Application</code> codebase type because is meant to be delivered as a container and deployed inside the Kubernetes cluster. Choose the <code>Clone</code> strategy and this example repository:</p> <p> Step codebase info </p> </li> <li> <p>In the Application Info tab, define the following values and click the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>tekton-hello-world</code></li> <li>Default branch: <code>master</code></li> <li>Application code language: <code>Other</code></li> <li>Language version/framework: <code>go</code></li> <li>Build tool: <code>shell</code></li> </ul> <p> Application info </p> <p>Note</p> <p>These application details are required to match the Pipeline name <code>gerrit-shell-go-app-build-default</code>.</p> <p>The PipelineRun name is formed with the help of TriggerTemplates in <code>pipelines-library</code> so the Pipeline name should correspond to the following structure: <pre><code>  pipelineRef:\n    name: gerrit-$(tt.params.buildtool)-$(tt.params.framework)-$(tt.params.cbtype)-build-$(tt.params.versioning-type)\n</code></pre> The PipelineRun is created as soon as Gerrit (or, if configured, GitHub, GitLab) sends a payload during Merge Request events.</p> </li> <li> <p>In the <code>Advances Settings</code> tab, define the below values and click the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>default</code></li> <li>Leave <code>Specify the pattern to validate a commit message</code> empty.</li> </ul> <p> Advanced settings </p> </li> <li> <p>Check the application status. It should be green:</p> <p> Application status </p> <p>Now that the application is created successfully, proceed to adding the Tekton library.</p> </li> </ol>"},{"location":"use-cases/tekton-custom-pipelines/#add-tekton-library","title":"Add Tekton Library","text":"<ol> <li> <p>Select the <code>Components</code> section under the EDP tab and push the create <code>+</code> button:</p> <p> Components tab </p> </li> <li> <p>Create a new Codebase with the <code>Library</code> type using the <code>Create</code> strategy:</p> <p> Step codebase info </p> <p>Note</p> <p>The EDP Create strategy will automatically pull the code for the Tekton Helm application from here.</p> </li> <li> <p>In the Application Info tab, define the following values and click the <code>Proceed</code> button:</p> <ul> <li>Application name: <code>custom-tekton-chart</code></li> <li>Default branch: <code>master</code></li> <li>Application code language: <code>Helm</code></li> <li>Language version/framework: <code>Pipeline</code></li> <li>Build tool: <code>Helm</code></li> </ul> <p> Step codebase info </p> </li> <li> <p>In the <code>Advances Settings</code> tab, define the below values and click the <code>Apply</code> button:</p> <ul> <li>CI tool: <code>Tekton</code></li> <li>Codebase versioning type: <code>default</code></li> <li>Leave <code>Specify the pattern to validate a commit message</code> empty.</li> </ul> <p> Advanced settings </p> </li> <li> <p>Check the codebase status:</p> <p> Codebase status </p> </li> </ol>"},{"location":"use-cases/tekton-custom-pipelines/#modify-tekton-pipeline","title":"Modify Tekton Pipeline","text":"<p>Note</p> <p>Our recommendation is to avoid modifying the default Tekton resources. Instead, we suggest creating and modifying your own custom Tekton library.</p> <p>Now that the Tekton Helm library is created, it is time to clone, modify and then apply it to the Kubernetes cluster.</p> <ol> <li> <p>Generate SSH key to work with Gerrit repositories:</p> <pre><code>ssh-keygen -t ed25519 -C \"your_email@example.com\"\n</code></pre> </li> <li> <p>Log into Gerrit UI.</p> </li> <li> <p>Go to Gerrit <code>Settings</code> -&gt; <code>SSH keys</code>, paste your generated public SSH key to the <code>New SSH key</code> field and click <code>ADD NEW SSH KEY</code>:</p> <p> Gerrit settings Gerrit settings </p> </li> <li> <p>Browse Gerrit Repositories and select <code>custom-tekton-chart</code> project:</p> <p> Browse Gerrit repositories </p> </li> <li> <p>Clone the repository with <code>SSH</code> using <code>Clone with commit-msg hook</code> command:</p> <p> Gerrit clone </p> <p>Note</p> <p>In case of the strict firewall configurations, please use the <code>HTTP</code> protocol to pull and configure the <code>HTTP Credentials</code> in Gerrit.</p> </li> <li> <p>Examine the repository structure. It should look this way by default:</p> <pre><code>custom-tekton-chart\n  \u251c\u2500\u2500 Chart.yaml\n  \u251c\u2500\u2500 chart_schema.yaml\n  \u251c\u2500\u2500 ct.yaml\n  \u251c\u2500\u2500 lintconf.yaml\n  \u251c\u2500\u2500 templates\n  \u2502\u00a0\u00a0 \u251c\u2500\u2500 pipelines\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0 \u2514\u2500\u2500 hello-world\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-lib-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-build-lib-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-review-lib.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gerrit-review.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-lib-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-build-lib-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-review-lib.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 github-review.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-lib-default.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-build-lib-edp.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u251c\u2500\u2500 gitlab-review-lib.yaml\n  \u2502\u00a0\u00a0 \u2502\u00a0\u00a0     \u2514\u2500\u2500 gitlab-review.yaml\n  \u2502\u00a0\u00a0 \u2514\u2500\u2500 tasks\n  \u2502\u00a0\u00a0     \u2514\u2500\u2500 task-hello-world.yaml\n  \u2514\u2500\u2500 values.yaml\n</code></pre> <p>Note</p> <p>Change the values in the <code>values.yaml</code> file.</p> <p>The <code>gitProvider</code> parameter is the git hosting provider, Gerrit in this example. The similar approach be made with GitHub, or GitLab.</p> <p>The dnsWildCard parameter is the cluster DNS address.</p> <p>The gerritSSHPort parameter is the SSH port of the Gerrit service on Kubernetes. Check the Gerrit port in your edp installation  global section.</p> <p>Note</p> <p>Our custom Helm chart includes edp-tekton-common-library dependencies in the <code>Chart.yaml</code> file. This library allows to use our predefined code snippets.</p> <p>Here is an example of the filled in <code>values.yaml</code> file:</p> <pre><code>nameOverride: \"\"\nfullnameOverride: \"\"\n\nglobal:\n  gitProvider: gerrit\n  dnsWildCard: \"example.domain.com\"\n  gerritSSHPort: \"30009\"\n</code></pre> </li> <li> <p>Modify and add tasks or pipelines.</p> <p>As an example, let's assume that we need to add the <code>helm-lint</code> pipeline task to the review pipeline. To implement this, insert the code below to the gerrit-review.yaml file underneath the hello task:</p> <pre><code>    - name: hello\n      taskRef:\n        name: hello\n      runAfter:\n      - init-values\n      params:\n      - name: BASE_IMAGE\n        value: \"$(params.shell-image-version)\"\n      - name: username\n        value: \"$(params.username)\"\n      workspaces:\n        - name: source\n          workspace: shared-workspace\n\n    - name: helm-lint\n      taskRef:\n        kind: Task\n        name: helm-lint\n      runAfter:\n        - hello\n      params:\n        - name: EXTRA_COMMANDS\n          value: |\n            ct lint --validate-maintainers=false --charts deploy-templates/\n      workspaces:\n        - name: source\n          workspace: shared-workspace\n</code></pre> <p>Note</p> <p>The <code>helm-lint</code> task references to the default <code>pipeline-library</code> Helm chart which is applied to the cluster during EDP installation.</p> <p>The <code>runAfter</code> parameter shows that this Pipeline task will be run after the <code>hello</code> pipeline task.</p> </li> <li> <p>Build Helm dependencies in the custom chart:</p> <pre><code>helm dependency update .\n</code></pre> </li> <li> <p>Ensure that the chart is valid and all the indentations are fine:</p> <pre><code>helm lint .\n</code></pre> <p>To validate if the values are substituted in the templates correctly, render the templated YAML files with the values using the following command. It generates and displays all the manifest files with the substituted values:</p> <pre><code>helm template .\n</code></pre> </li> <li> <p>Install the custom chart with the command below. You can also use the <code>--dry-run</code> flag to simulate the chart installation and catch possible errors:</p> <pre><code>helm upgrade --install edp-tekton-custom . -n edp --dry-run\n</code></pre> <pre><code>helm upgrade --install edp-tekton-custom . -n edp\n</code></pre> </li> <li> <p>Check the created pipelines and tasks in the cluster:</p> <pre><code>kubectl get tasks -n edp\nkubectl get pipelines -n edp\n</code></pre> </li> <li> <p>Commit and push the modified Tekton Helm chart to Gerrit:</p> <pre><code>git add .\ngit commit -m \"Add Helm chart testing for go-shell application\"\ngit push origin HEAD:refs/for/master\n</code></pre> </li> <li> <p>Check the Gerrit code review for the custom Helm chart pipelines repository in Tekton:</p> <p> Gerrit code review status </p> </li> <li> <p>Go to <code>Changes</code> -&gt; <code>Open</code>, click <code>CODE-REVIEW</code> and submit the merge request:</p> <p> Gerrit merge Gerrit merge </p> </li> <li> <p>Check the build Pipeline status for the custom Pipelines Helm chart repository in Tekton:</p> <p> Tekton status </p> </li> </ol>"},{"location":"use-cases/tekton-custom-pipelines/#create-application-merge-request","title":"Create Application Merge Request","text":"<p>Since we applied the Tekton library to the Kubernetes cluster in the previous step, let's test the review and build pipelines for our <code>tekton-hello-world</code> application.</p> <p>Perform the below steps to merge new code (Merge Request) that passes the Code Review flow. For the steps below, we use Gerrit UI but the same actions can be performed using the command line and Git tool:</p> <ol> <li> <p>Log into Gerrit UI, select <code>tekton-hello-world</code> project, and create a change request.</p> </li> <li> <p>Browse Gerrit Repositories and select <code>tekton-hello-world</code> project:</p> <p> Browse Gerrit repositories </p> </li> <li> <p>Clone the  <code>tekton-hello-world</code> repository to make the necessary changes or click the <code>Create Change</code> button in the <code>Commands</code> section of the project to make changes via Gerrit GUI:</p> <p> Create Change request </p> </li> <li> <p>In the <code>Create Change</code> dialog, provide the branch <code>master</code>, write some text in the <code>Description</code> (commit message) and click the <code>Create</code> button:</p> <p> Create Change </p> </li> <li> <p>Click the <code>Edit</code> button of the merge request and add <code>deployment-templates/values.yaml</code> to modify it and change the <code>ingress.enabled flag</code> from <code>false</code> to <code>true</code>:</p> <p> Update values.yaml file Update values.yaml file </p> </li> <li> <p>Check the Review Pipeline status. The <code>helm-lint</code> pipeline task should be displayed there:</p> <p> Review Change </p> </li> <li> <p>Review the <code>deployment-templates/values.yaml</code> file and push the <code>SAVE &amp; PUBLISH</code> button. As soon as you get <code>Verified +1</code> from CI bot, the change is ready for review. Click the <code>Mark as Active</code> and <code>Code-review</code> buttons:</p> <p> Review Change </p> </li> <li> <p>Click the <code>Submit</code> button. Then, your code is merged to the main branch, triggering the Build Pipeline.</p> <p> Review Change </p> <p>Note</p> <p>If the build is added and configured, push steps in the pipeline, it will produce a new version of artifact, which will be available for the deployment in EDP Portal.</p> </li> <li> <p>Check the pipelines in the Tekton dashboard:</p> <p> Tekton custom pipelines Tekton custom pipelines </p> </li> </ol> <p>What happens under the hood:   1) Gerrit sends a payload during Merge Request event to the Tekton EventListener;   2) EventListener catches it with the help of Interceptor;   3) TriggerTemplate creates a PipelineRun.</p> <p>The detailed scheme is shown below:</p> <pre><code>graph LR;\n    A[Gerrit events] --&gt; |Payload| B(Tekton EventListener) --&gt; C(Tekton Interceptor CEL filter) --&gt; D(TriggerTemplate)--&gt; E(PipelineRun)</code></pre> <p>This chart will be using the core of <code>common-library</code> and <code>pipelines-library</code> and custom resources on the top of them.</p>"},{"location":"use-cases/tekton-custom-pipelines/#related-articles","title":"Related Articles","text":"<ul> <li>Tekton Overview</li> <li>Add Application using EDP Portal</li> </ul>"},{"location":"user-guide/","title":"Overview","text":"<p>The EDP Portal user guide is intended for developers and provides details on working with EDP Portal, different codebase types, and EDP CI/CD flow.</p>"},{"location":"user-guide/#edp-portal","title":"EDP Portal","text":"<p>EDP Portal is a central management tool in the EDP ecosystem that provides the ability to define pipelines, project resources and new technologies in a simple way. Using EDP Portal enables to manage business entities:</p> <ul> <li>Create such codebase types as Applications, Libraries, Autotests and Infrastructures;</li> <li>Create/Update CD Pipelines;</li> <li>Add external Git servers and Clusters.</li> </ul> <p> Overview page </p> <ul> <li>Navigation bar \u2013 consists of the following sections: Overview, Marketplace, Components, CD Pipelines, and Configuration.</li> <li>Top panel bar \u2013 contains documentation link, notifications, EDP Portal settings, and cluster settings, such as default and allowed namespaces.</li> <li>Main links \u2013 displays the corresponding links to the major adjusted toolset, to the management tool and to the OpenShift cluster.</li> <li>Filters \u2013 used for searching and filtering the namespaces.</li> </ul> <p>EDP Portal is a complete tool allowing to manage and control the codebases (applications, autotests, libraries and infrastructures) added to the environment as well as to create a CD pipeline.</p> <p>Inspect the main features available in EDP Portal by following the corresponding link:</p> <ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Add Git Server</li> <li>Add CD Pipeline</li> <li>Add Quality Gate</li> </ul>"},{"location":"user-guide/add-application/","title":"Add Application","text":"<p>Portal allows to create, clone and import an application and add it to the environment. It can also be deployed in Gerrit (if the Clone or Create strategy is used) with the Code Review and Build pipelines built in Jenkins/Tekton.</p> <p>To add an application, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Application and choose one of the strategies which will be described later in this page. You can create an Application in YAML or via the two-step menu in the dialog.</p>"},{"location":"user-guide/add-application/#create-application-in-yaml","title":"Create Application in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Application dialog to open the YAML editor and create the Application.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Application dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-application/#create-application-via-ui","title":"Create Application via UI","text":"<p>The Create Application dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-application/#codebase-info-menu","title":"Codebase Info Menu","text":"<p>Follow the instructions below to fill in the fields of the Codebase Info menu:</p> <ol> <li> <p>In the Create new component menu, select Application:</p> <p> Application info </p> </li> <li> <p>Select the necessary configuration strategy. There are three configuration strategies:</p> </li> </ol> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with an application language, a build tool, and a framework. This strategy is recommended for projects that start developing their applications from scratch.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> </li> </ul> <ul> <li> <p>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well:</p> <p> Clone application </p> <p>In our example, we will use the Create from template strategy:</p> <p> Create application </p> <ol> <li> <p>Select the Git server from the drop-down list and define the relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code>.</p> </li> <li> <p>Type the name of the application in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> </li> <li> <p>Type the application description.</p> </li> <li> <p>To create an application with an empty repository in Gerrit, select the Empty project check box.</p> </li> <li> <p>Select any of the supported application languages with their providers in the Application Code Language field:</p> <ul> <li>Java \u2013 selecting specific Java version (8,11,17 are available).</li> <li>JavaScript - selecting JavaScript allows using React, Vue, Angular, Express, Next.js and Antora frameworks.</li> <li>Python - selecting Python allows using the Python v.3.8, FastAPI, Flask frameworks.</li> <li>Go - selecting Go allows using the Beego, Gin and Operator SDK frameworks.</li> <li>C# - selecting C# allows using the .Net v.3.1 and .Net v.6.0 frameworks.</li> <li>Helm - selecting Helm allows using the Helm framework.</li> <li>Other - selecting Other allows extending the default code languages when creating a codebase with the clone/import strategy. To add another code language, inspect the Add Other Code Language section.</li> </ul> <p>Note</p> <p>The Create from template strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select necessary Language version/framework depending on the Application code language field.</p> </li> <li> <p>Choose the necessary build tool in the Build Tool field:</p> <ul> <li>Java - selecting Java allows using the Gradle or Maven tool.</li> <li>JavaScript - selecting JavaScript allows using the NPM tool.</li> <li>C# - selecting C# allows using the .Net tool.</li> <li>Python - selecting Python allows using Python tool.</li> <li>Go - selecting Go allows using Go tool.</li> <li>Helm - selecting Helm allows using Helm tool.</li> </ul> <p>Note</p> <p>The Select Build Tool field disposes of the default tools and can be changed in accordance with the selected code language.</p> <p>Note</p> <p>Tekton pipelines offer built-in support for Java Maven Multi-Module projects. These pipelines are capable of recognizing Java deployable modules based on the information in the pom.xml file and performing relevant deployment actions. It's important to note that although the Dockerfile is typically located in the root directory, Kaniko, the tool used for building container images, uses the targets folder within the deployable module's context. For a clear illustration of a Multi-Module project structure, please refer to this example on GitHub, which showcases a commonly used structure for Java Maven Multi-Module projects.</p> </li> </ol> </li> </ul>"},{"location":"user-guide/add-application/#advanced-settings-menu","title":"Advanced Settings Menu","text":"<p>The Advanced Settings menu should look similar to the picture below:</p> <p> Advanced settings </p> <p>Follow the instructions below to fill in the fields of the Advanced Setting menu:</p> <p>a. Specify the name of the Default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted. For the Clone project and Import project strategies: if you want to use the existing branch, enter its name into this field.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default - using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li> <p>edp - using the edp versioning type, a developer indicates the version number that will be used for all the artifacts stored in artifactory: binaries, pom.xml, metadata, etc. The version stored in repository (e.g. pom.xml) will not be affected or used. Using this versioning overrides any version stored in the repository files without changing actual file.</p> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> Edp versioning </p> </li> </ul> <p>Type the version number from which you want the artifacts to be versioned.</p> <p>Note</p> <p>The Start Version From field should be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code>.</p> <p> JIRA integration </p> <p>d. Select the Integrate with Jira Server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and setup the Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. In the Jira Server field, select the Jira server.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira. Combine several variables to obtain the desired value.</p> <p>Note</p> <p>The GitLab CI tool is available only with the Import strategy and makes the Jira integration feature unavailable.</p> <p> Mapping fields </p> <p>g. In the Mapping field name section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket from the Mapping field name drop-down menu. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field, select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field, select the EDP_GITTAG variable that defines a tag assigned to the commit in GitHub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the application to the Applications list.</p> <p>Note</p> <p>After the complete adding of the application, inspect the Application Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-application/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Applications</li> <li>Add CD Pipeline</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-autotest/","title":"Add Autotest","text":"<p>Portal enables to clone or import an autotest, add it to the environment with its subsequent deployment in Gerrit (in case the Clone strategy is used) and building of the Code Review pipeline in Jenkins/Tekton, as well as to use it for work with an application under development.  It is also possible to use autotests as quality gates in a newly created CD pipeline.</p> <p>Info</p> <p>Please refer to the Add Application section for the details on how to add an application codebase type. For the details on how to use autotests as quality gates, please refer to the Stages Menu section of the Add CD Pipeline documentation.</p> <p>To add an autotest, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Autotest and choose one of the strategies which will be described later in this page. You can create an autotest in YAML or via the two-step menu in the dialog.</p>"},{"location":"user-guide/add-autotest/#create-autotest-in-yaml","title":"Create Autotest in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Autotest dialog to open the YAML editor and create an autotest:</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Autotest dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-autotest/#create-autotest-via-ui","title":"Create Autotest via UI","text":"<p>The Create Autotest dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-autotest/#the-codebase-info-menu","title":"The Codebase Info Menu","text":"<p>There are two available strategies: clone and import.</p> <ol> <li> <p>The Create new component menu should look like the picture below:</p> <p> Create new component menu </p> </li> <li> <p>In the Repository onboarding strategy field, select the necessary configuration strategy:</p> <ul> <li>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> <p>In our example, we will use the Clone project strategy:</p> <p> Clone autotest </p> <ol> <li> <p>While cloning the existing repository, it is required to fill in the Repository URL field.</p> </li> <li> <p>Select the Git server from the drop-down list and define the relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code>.</p> </li> <li> <p>Select the Repository credentials check box in case you clone the private repository, and fill in the repository login and password/access token.</p> </li> <li> <p>Fill in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> </li> <li> <p>Type the necessary description in the Description field.</p> </li> <li> <p>In the Autotest code language field, select the Java code language with its framework (specify Java 8 or Java 11 to be used) and get the default Maven build tool OR add another code language. Selecting Other allows extending the default code languages and get the necessary build tool, for details, inspect the Add Other Code Language section.</p> <p>Note</p> <p>Using the Create strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select the Java framework if Java is selected above.</p> </li> <li> <p>The Build Tool field can dispose of the default Maven tool, Gradle or other built tool in accordance with the selected code language.</p> </li> <li> <p>All the autotest reports will be created in the Allure framework that is available in the Autotest Report Framework field by default.</p> </li> </ol> </li> </ul> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol> <p>The Advanced Settings menu should look like the picture below:</p> <p> Advanced settings </p> <p>a. Specify the name of the default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default: Using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li> <p>edp: Using the edp versioning type, a developer indicates the version number from which all the artifacts will be versioned and, as a result, automatically registered in the corresponding file (e.g. pom.xml).</p> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> Edp versioning </p> <p>Type the version number from which you want the artifacts to be versioned.</p> </li> </ul> <p>Note</p> <p>The Start Version From field must be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code></p> <p> Jira integration </p> <p>d. Select the Integrate with Jira Server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. As soon as the Jira server is set, select it in the Jira Server field.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira.</p> <p> Mapping field name </p> <p>g. In the Advanced Mapping section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field select the EDP_GITTAGvariable that defines a tag assigned to the commit in Git Hub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the library to the Libraries list.</p> <p>Note</p> <p>After the complete adding of the autotest, inspect the Autotest Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-autotest/#the-advanced-settings-menu","title":"The Advanced Settings Menu","text":""},{"location":"user-guide/add-autotest/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Autotests</li> <li>Add Application</li> <li>Add CD Pipelines</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-cd-pipeline/","title":"Add CD Pipeline","text":"<p>Portal provides the ability to deploy an environment on your own and specify the essential components.</p> <p>Navigate to the CD Pipelines section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create CD Pipeline dialog will appear.</p> <p>The creation of the CD pipeline becomes available as soon as an application is created including its provisioning in a branch and the necessary entities for the environment. You can create the CD pipeline in YAML or via the three-step menu in the dialog.</p>"},{"location":"user-guide/add-cd-pipeline/#create-cd-pipeline-in-yaml","title":"Create CD Pipeline in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create CD Pipeline dialog to open the YAML editor and create the CD Pipeline.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create CD Pipeline dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-cd-pipeline/#create-cd-pipeline-in-the-dialog","title":"Create CD Pipeline in the Dialog","text":"<p>The Create CD Pipeline dialog contains the three steps:</p> <ul> <li>The Pipeline Menu</li> <li>The Applications Menu</li> <li>The Stages Menu</li> </ul>"},{"location":"user-guide/add-cd-pipeline/#the-pipeline-menu","title":"The Pipeline Menu","text":"<p>The Pipeline tab of the Create CD Pipeline menu should look like the picture below:</p> <p> Create CD pipeline </p> <ol> <li> <p>Type the name of the pipeline in the Pipeline Name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> <p>Note</p> <p>The namespace created by the CD pipeline has the following pattern combination: [edp namespace]-[cd pipeline name]-[stage name]. Please be aware that the namespace length should not exceed 63 symbols.</p> </li> <li> <p>Select the deployment type from the drop-down list:</p> <ul> <li>Container - the pipeline will be deployed in a Docker container;</li> <li>Custom - this mode allows to deploy non-container applications and customize the Init stage of CD pipeline.</li> </ul> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#the-applications-menu","title":"The Applications Menu","text":"<p>The Pipeline tab of the Create CD Pipeline menu should look like the picture below:</p> <p> CD pipeline applications </p> <ol> <li>Select the necessary application from the Mapping field name drop-down menu.</li> <li>Select the plus sign icon near the selected application to specify the necessary codebase Docker branch for the application (the output for the branch and other stages from other CD pipelines).</li> <li>Select the application branch from the drop-down menu.</li> <li> <p>Select the Promote in pipeline check box in order to transfer the application from one to another stage   by the specified codebase Docker branch. If the Promote in pipeline check box is not selected,   the same codebase Docker stream will be deployed regardless of the stage, i.e. the codebase Docker stream input,   which was selected for the pipeline, will always be used.</p> <p>Note</p> <p>The newly created CD pipeline has the following pattern combination: [pipeline name]-[branch name]. If there is another deployed CD pipeline stage with the respective codebase Docker stream (= image stream as an OpenShift term), the pattern combination will be as follows: [pipeline name]-[stage name]-[application name]-[verified].</p> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#the-stages-menu","title":"The Stages Menu","text":"<ol> <li> <p>Click the plus sign icon in the Stages menu and fill in the necessary fields in the Adding Stage window :</p> <p> CD stages </p> <p> Adding stage </p> <p>a. Type the stage name;</p> <p>Note</p> <p>The namespace created by the CD pipeline has the following pattern combination: [cluster name]-[cd pipeline name]-[stage name]. Please be aware that the namespace length should not exceed 63 symbols.</p> <p>b. Enter the description for this stage;</p> <p>c. Select the trigger type. The key benefit of the automatic deploy feature is to keep environments up-to-date. The available trigger types are Manual and Auto. When the Auto trigger type is chosen, the CD pipeline will initiate automatically once the image is built. Manual implies that user has to perform deploy manually by clicking the Deploy button in the CD Pipeline menu. Please refer to the Architecture Scheme of CD Pipeline Operator page for additional details.</p> <p>Note</p> <p>In Tekton deploy scenario, automatic deploy will start working only after the first manual deploy.</p> <p>d. Select the job provisioner. In case of working with non-container-based applications, there is an option to use a custom job provisioner. Please refer to the Manage Jenkins CD Job Provision page for details.</p> <p>e. Select the groovy-pipeline library;</p> <p>f. Select the branch;</p> <p>g. Add an unlimited number of quality gates by clicking a corresponding plus sign icon and remove them as well by clicking the recycle bin icon;</p> <p>h. Type the step name, which will be displayed in Jenkins/Tekton, for every quality gate;</p> <p>i. Select the quality gate type:</p> <ul> <li>Manual - means that the promoting process should be confirmed in Jenkins/Tekton manually;</li> <li>Autotests - means that the promoting process should be confirmed by the successful passing of the autotests.</li> </ul> <p>In the additional fields, select the previously created autotest name (j) and specify its branch for the autotest that will be launched on the current stage (k).</p> <p>Note</p> <p>Execution sequence. The image promotion and execution of the pipelines depend on the sequence in which the environments are added.</p> <p>l. Click the Apply button to display the stage in the Stages menu.</p> <p> Continuous delivery menu </p> </li> <li> <p>Edit the stage by clicking its name and applying changes, and remove the added stage by clicking the recycle bin icon    next to its name.</p> </li> <li> <p>Click the Apply button to start the provisioning of the pipeline. After the CD pipeline is added, the new project with the stage name will be created in OpenShift.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#manage-cd-pipeline","title":"Manage CD Pipeline","text":"<p>As soon as the CD pipeline is provisioned and added to the CD Pipelines list, there is an ability to:</p> <p> CD pipeline page </p> <ol> <li> <p>Create another application by clicking the plus sign icon in the lower-right corner of the screen and performing the same steps as described in the Add CD Pipeline section.</p> </li> <li> <p>Open CD pipeline data by clicking its link name. Once clicked, the following blocks will be displayed:</p> <ul> <li>General Info - displays common information about the CD pipeline, such as name and deployment type.</li> <li>Applications - displays the CD pipeline applications to promote.</li> <li>Stages - displays the CD pipeline stages and stage metadata (by selecting the information icon near the stage name); allows to add, edit and delete stages, as well as deploy or uninstall image stream versions of the related applications for a stage.</li> <li>Metadata - displays the CD pipeline name, namespace, creation date, finalizers, generation, resource version, and UID. Open this block by selecting the information icon near the options icon next to the CD pipeline name.</li> </ul> </li> <li> <p>Edit the CD pipeline by selecting the options icon next to its name in the CD Pipelines list, and then selecting Edit. For details see the Edit Existing CD Pipeline section.</p> </li> <li> <p>Delete the added CD pipeline by selecting the options icon next to its name in the CD Pipelines list, and then selecting Delete.</p> <p>Info</p> <p>In OpenShift, if the deployment fails with the ImagePullBackOff error, delete the POD.</p> </li> <li> <p>Sort the existing CD pipelines in a table by clicking the sorting icons in the table header. When sorting by name, the CD pipelines will be displayed in alphabetical order. You can also sort the CD pipelines by their status.</p> </li> <li> <p>Search the necessary CD pipeline by the namespace or by entering the corresponding name, language or the build tool into the Filter tool.</p> </li> <li> <p>Select a number of CD pipelines displayed per page (15, 25 or 50 rows) and navigate between pages if the number of CD pipelines exceeds the capacity of a single page.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#edit-existing-cd-pipeline","title":"Edit Existing CD Pipeline","text":"<p>Edit the CD pipeline directly from the CD Pipelines overview page or when viewing the CD Pipeline data:</p> <ol> <li> <p>Select Edit in the options icon menu next to the CD pipeline name:</p> <p> Edit CD pipeline on the CD Pipelines overview page </p> <p> Edit CD pipeline when viewing the CD pipeline data </p> </li> <li> <p>Apply the necessary changes (edit the list of applications for deploy, application branches, and promotion in the pipeline). Add new extra stages by clicking the plus sign icon and filling in the application branch and promotion in the pipeline.</p> <p> Edit CD pipeline dialog </p> </li> <li> <p>Select the Apply button to confirm the changes.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#add-a-new-stage","title":"Add a New Stage","text":"<p>In order to create a new stage for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Add CD pipeline stage </p> </li> <li> <p>Select Create to open the Create stage dialog.</p> </li> <li> <p>Click Edit YAML in the upper-right corner of the Create stage dialog to open the YAML editor and add a stage. Otherwise, fill in the required fields in the dialog. Please see the Stages Menu section for details.</p> </li> <li> <p>Click the Apply button.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#edit-stage","title":"Edit Stage","text":"<p>In order to edit a stage for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Edit CD pipeline stage </p> </li> <li> <p>Select the options icon related to the necessary stage and then select Edit.</p> <p> Edit CD pipeline stage dialog </p> </li> <li> <p>In the Edit Stage dialog, change the stage trigger type. See more about this field in the Stages Menu section.</p> </li> <li> <p>Click the Apply button.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#delete-stage","title":"Delete Stage","text":"<p>Note</p> <p>You cannot remove the last stage, as the CD pipeline does not exist without stages.</p> <p>In order to delete a stage for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Delete CD pipeline stage </p> </li> <li> <p>Select the options icon related to the necessary stage and then select Delete. After the confirmation, the CD stage is deleted with all its components: database record, Jenkins/Tekton pipeline, and cluster namespace.</p> </li> </ol>"},{"location":"user-guide/add-cd-pipeline/#view-stage-data","title":"View Stage Data","text":"<p>To view the CD pipeline stage data for the existing CD pipeline, follow the steps below:</p> <ol> <li> <p>Navigate to the Stages block by clicking the CD pipeline name link in the CD Pipelines list.</p> <p> Expand CD pipeline stage </p> </li> <li> <p>Select the expand icon near the stage name. The following blocks will be displayed:</p> <p> CD pipeline stage overview </p> </li> </ol> <ul> <li>Applications - displays the status of the applications related to the stage and allows deploying the applications. Applications health and sync statuses are returned from the Argo CD tool.</li> <li>General Info - displays the stage status, CD pipeline, description, job provisioning, order, trigger type, and source.</li> <li>Quality Gates - displays the stage quality gate type, step name, autotest name, and branch name.</li> </ul>"},{"location":"user-guide/add-cd-pipeline/#deploy-application","title":"Deploy Application","text":"<p>Navigate to the Applications block of the stage and select an application. Select the image stream version from the drop-down list and click Deploy. The application will be deployed in the Argo CD tool as well.</p> <p> Deploy the promoted application </p> <p>To update or uninstall the application, select Update or Uninstall.</p> <p> Update or uninstall the application </p> <p>After this, the application will be updated or uninstalled in the Argo CD tool as well.</p> <p>Note</p> <p>In a nutshell, the Update button updates your image version in the Helm chart, whereas the Uninstall button deletes the Helm chart from the namespace where the pipeline is deployed.</p>"},{"location":"user-guide/add-cd-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Jenkins CD Pipeline Job Provision</li> </ul>"},{"location":"user-guide/add-cluster/","title":"Add Cluster","text":"<p>Adding other clusters allows deploying applications to several clusters when creating a stage of CD pipeline in EDP Portal.</p> <p>To add a cluster, follow the steps below:</p> <ol> <li> <p>Navigate to the Configuration section on the navigation bar and select Clusters. The appearance differs depending on the chosen display option:</p> List optionTiled option <p> Configuration menu (List option) </p> <p> Configuration menu (Tiled option) </p> </li> <li> <p>Click the + button to enter the Create new cluster menu:</p> <p> Add Cluster </p> </li> <li> <p>Once clicked, the Create new cluster dialog will appear. You can create a Cluster in YAML or via UI:</p> </li> </ol> Add cluster in YAMLAdd cluster via UI <p>To add cluster in YAML, follow the steps below:</p> <ul> <li>Click the Edit YAML button in the upper-right corner of the Create New Cluster dialog to open the YAML editor and create a Kubernetes secret.</li> </ul> <p> Edit YAML </p> <ul> <li>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create new cluster dialog.</li> </ul> <ul> <li>To save the changes, select the Save &amp; Apply button.</li> </ul> <p>To add cluster in YAML, follow the steps below:</p> <ul> <li> <p>To add a new cluster via the dialog menu, fill in the following fields in the Create New Cluster dialog:</p> <ul> <li>Cluster Name - enter a cluster name;</li> <li>Cluster Host - enter a cluster host;</li> <li>Cluster Token - enter a cluster token;</li> <li>Cluster Certificate - enter a cluster certificate.</li> </ul> </li> </ul> <p> Add Cluster </p> <ul> <li>Click the Apply button to add the cluster to the clusters list.</li> </ul> <p>As a result, the Kubernetes secret will be created for further integration.</p> <p>Currently, the EDP uses the shared Argo CD and the secret needs to be copied to the namespace where the Argo CD is installed.</p>"},{"location":"user-guide/add-cluster/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add Autotest</li> <li>Add CD Pipeline</li> </ul>"},{"location":"user-guide/add-custom-global-pipeline-lib/","title":"Add a Custom Global Pipeline Library","text":"<p>In order to add a new custom global pipeline library, perform the steps below:</p> <ol> <li> <p>Navigate to Jenkins and go to Manage Jenkins -&gt; Configure System -&gt; Global Pipeline Libraries.</p> <p>Note</p> <p>It is possible to configure as many libraries as necessary. Since these libraries will be globally usable, any pipeline in the system can utilize the functionality implemented in these libraries.</p> </li> <li> <p>Specify the following values:</p> <p> Add custom library </p> <p>a. Library name: The name of a custom library.</p> <p>b. Default version: The version which can be branched, tagged or hashed of a commit.</p> <p>c. Load implicitly: If checked, scripts will automatically have access to this library without needing to request it via @Library. It means that there is no need to upload the library manually because it will be downloaded automatically during the build for each job.</p> <p>d. Allow default version to be overridden: If checked, scripts may select a custom version of the library by appending @someversion in the @Library annotation. Otherwise, they are restricted to using the version selected here.</p> <p>e. Include @Library changes in job recent changes: If checked, any changes in the library will be included in the changesets of a build, and changing the library would cause new builds to run for Pipelines that include this library. This can be overridden in the jenkinsfile: @Library(value=\"name@version\", changelog=true|false).</p> <p>f. Cache fetched versions on controller for quick retrieval: If checked, versions fetched using this library will be cached on the controller. If a new library version is not downloaded during the build for some reason, remove the previous library version from cache in the Jenkins workspace.</p> <p>Note</p> <p>If the Default version check box is not defined, the pipeline must specify a version, for example, <code>@Library('my-shared-library@master')</code>. If the Allow default version to be overridden check box is enabled in the Shared Library\u2019s configuration, a @Library annotation may also override the default version defined for the library.</p> <p> Source code management </p> <p>g. Project repository: The URL of the repository</p> <p>h. Credentials: The credentials for the repository.</p> </li> <li> <p>Use the Custom Global Pipeline Libraries on the pipeline, for example:</p> </li> </ol> <p>Pipeline</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines', 'edp-custom-shared-library-name'])_\n\nBuild()\n</code></pre> <p>Note</p> <p><code>edp-custom-shared-library-name</code> is the name of the Custom Global Pipeline Library that should be added to the Jenkins Global Settings.</p>"},{"location":"user-guide/add-custom-global-pipeline-lib/#related-articles","title":"Related Articles","text":"<ul> <li>Jenkins Official Documentation: Extending with Shared Libraries</li> </ul>"},{"location":"user-guide/add-git-server/","title":"Add Git Server","text":"<p>Important</p> <p>This article describes how to add a Git Server when deploying EDP with Jenkins. When deploying EDP with Tekton, Git Server is created automatically.</p> <p>Add Git servers to use the Import strategy for Jenkins and Tekton when creating an application, autotest or library in EDP Portal (Codebase Info step of the Create Application/Autotest/Library dialog). Enabling the Import strategy is a prerequisite to integrate EDP with Gitlab or GitHub.</p> <p>Note</p> <p><code>GitServer</code> Custom Resource can be also created manually. See step 3 for Jenkins import strategy in the Integrate GitHub/GitLab in Jenkins article.</p> <p>To add a Git server, navigate to the Git servers section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create Git server dialog will appear. You can create a Git server in YAML or via the three-step menu in the dialog.</p>"},{"location":"user-guide/add-git-server/#create-git-server-in-yaml","title":"Create Git Server in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Git server dialog to open the YAML editor and create a Git server.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Git server dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-git-server/#create-git-server-in-the-dialog","title":"Create Git Server in the Dialog","text":"<p>Fill in the following fields:</p> <p> Create Git server </p> <ul> <li>Git provider - select Gerrit, GitLab or GitHub.</li> <li>Host - enter a Git server endpoint.</li> <li>User - enter a user for Git integration.</li> <li>SSH port - enter a Git SSH port.</li> <li>HTTPS port - enter a Git HTTPS port.</li> <li>Private SSH key - enter a private SSH key for Git integration. To generate this key, follow the instructions of the step 1 for Jenkins in the Integrate GitHub/GitLab in Jenkins article.</li> <li>Access token - enter an access token for Git integration. To generate this token, go to GitLab/GitHub account -&gt; Settings -&gt; SSH and GPG keys -&gt; select New SSH key and add SSH key.</li> </ul> <p>Click the Apply button to add the Git server to the Git servers list. As a result, the Git Server object and the corresponding secret for further integration will be created.</p>"},{"location":"user-guide/add-git-server/#related-articles","title":"Related Articles","text":"<ul> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>GitHub Webhook Configuration</li> <li>GitLab Webhook Configuration</li> </ul>"},{"location":"user-guide/add-infrastructure/","title":"Add Infrastructure","text":"<p>EDP Portal allows to create, clone and import an infrastructure. Its functionality is to create resources in cloud provider.</p> <p>To add an application, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Application and choose one of the strategies which will be described later in this page. You can create an Application in YAML or via the two-step menu in the dialog.</p>"},{"location":"user-guide/add-infrastructure/#create-infrastructure-in-yaml","title":"Create Infrastructure in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Infrastructure dialog to open the YAML editor and create the Infrastructure.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Infrastructure dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-infrastructure/#create-infrastructure-via-ui","title":"Create Infrastructure via UI","text":"<p>The Create Infrastructure dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-infrastructure/#codebase-info-menu","title":"Codebase Info Menu","text":"<p>Follow the instructions below to fill in the fields of the Codebase Info menu:</p> <ol> <li> <p>In the Create new component menu, select Infrastructure:</p> <p> Infrastructure info </p> </li> <li> <p>Select the necessary configuration strategy:</p> </li> </ol> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with an infrastructure language, a build tool, and a framework.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> </li> </ul> <ul> <li> <p>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well:</p> <p>In our example, we will use the Create from template strategy:</p> <p> Create infrastructure </p> <ol> <li> <p>Select the Git server from the drop-down list and define the Git repo relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code>.</p> </li> <li> <p>Type the name of the infrastructure in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</p> </li> <li> <p>Write the description in the Description field.</p> </li> <li> <p>To create an application with an empty repository in Gerrit, select the Empty project check box.</p> </li> <li> <p>Select any of the supported application languages with their providers in the Infrastructure Code Language field. So far, only HCL is supported.</p> <p>Note</p> <p>The Create from template strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select necessary Language version/framework depending on the Infrastructure code language field. So far, only AWS is supported.</p> </li> <li> <p>Choose the necessary build tool in the Build Tool field. So far, only Terraform is supported.\\</p> <p>Note</p> <p>The Select Build Tool field disposes of the default tools and can be changed in accordance with the selected code language.</p> </li> </ol> </li> </ul> <p>The Advanced Settings menu should look similar to the picture below:</p> <p> Advanced settings </p> <p>Follow the instructions below to fill in the fields of the Advanced Setting menu:</p> <p>a. Specify the name of the Default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted. For the Clone project and Import project strategies: if you want to use the existing branch, enter its name into this field.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default - using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li> <p>edp - using the edp versioning type, a developer indicates the version number that will be used for all the artifacts stored in artifactory: binaries, pom.xml, metadata, etc. The version stored in repository (e.g. pom.xml) will not be affected or used. Using this versioning overrides any version stored in the repository files without changing actual file.</p> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> Edp versioning </p> </li> </ul> <p>Type the version number from which you want the artifacts to be versioned.</p> <p>Note</p> <p>The Start Version From field should be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code>.</p> <p> JIRA integration </p> <p>d. Select the Integrate with Jira Server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and setup the Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. In the Jira Server field, select the Jira server.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira. Combine several variables to obtain the desired value.</p> <p>Note</p> <p>The GitLab CI tool is available only with the Import strategy and makes the Jira integration feature unavailable.</p> <p> Mapping fields </p> <p>g. In the Mapping field name section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket from the Mapping field name drop-down menu. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field, select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field, select the EDP_GITTAG variable that defines a tag assigned to the commit in GitHub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the application to the Applications list.</p> <p>Note</p> <p>After the complete adding of the application, inspect the Application Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-infrastructure/#advanced-settings-menu","title":"Advanced Settings Menu","text":""},{"location":"user-guide/add-infrastructure/#related-articles","title":"Related Articles","text":"<ul> <li>Application Overview</li> <li>Add CD Pipelines</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Enable VCS Import Strategy</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-library/","title":"Add Library","text":"<p>Portal helps to create, clone and import a library and add it to the environment. It can also be deployed in Gerrit (if the Clone or Create strategy is used) with the Code Review and Build pipelines built in Jenkins/Tekton.</p> <p>To add a library, navigate to the Components section on the navigation bar and click Create (the plus sign icon in the lower-right corner of the screen). Once clicked, the Create new component dialog will appear, then select Library and choose one of the strategies which will be described later in this page. You can create a library in YAML or via the two-step menu in the dialog.</p> <p> Create new component menu </p>"},{"location":"user-guide/add-library/#create-library-in-yaml","title":"Create Library in YAML","text":"<p>Click Edit YAML in the upper-right corner of the Create Library dialog to open the YAML editor and create the Library.</p> <p> Edit YAML </p> <p>To edit YAML in the minimal editor, turn on the Use minimal editor toggle in the upper-right corner of the Create Application dialog.</p> <p>To save the changes, select the Save &amp; Apply button.</p>"},{"location":"user-guide/add-library/#create-library-via-ui","title":"Create Library via UI","text":"<p>The Create Library dialog contains the two steps:</p> <ul> <li>The Codebase Info Menu</li> <li>The Advanced Settings Menu</li> </ul>"},{"location":"user-guide/add-library/#the-codebase-info-menu","title":"The Codebase Info Menu","text":"<ol> <li> <p>The Create new component menu should look like the following:</p> <p> Create new component menu </p> </li> <li> <p>In the Create new component menu, select the necessary configuration strategy. The choice will define the parameters you will need to specify:</p> <ul> <li>Create from template \u2013 creates a project on the pattern in accordance with a library language, a build tool, and a framework.</li> </ul> <ul> <li> <p>Import project - allows configuring a replication from the Git server. While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as /epmd-edp/examples/basic/edp-auto-tests-simple-example.</p> <p>Note</p> <p>In order to use the Import project strategy, make sure to adjust it with the Integrate GitLab/GitHub With Jenkins or Integrate GitLab/GitHub With Tekton page.</p> </li> </ul> <ul> <li> <p>Clone project \u2013 clones the indicated repository into EPAM Delivery Platform. While cloning the existing repository, it is required to fill in the Repository URL field as well:</p> <p> Clone library </p> <p>In our example, we will use the Create from template strategy:</p> <p> Create library </p> <ol> <li>While importing the existing repository, select the Git server from the drop-down list and define the relative path to the repository, such as <code>/epmd-edp/examples/basic/edp-auto-tests-simple-example</code></li> <li>Type the name of the library in the Component name field by entering at least two characters and by using the lower-case letters, numbers and inner dashes.</li> <li>Type the library description.</li> <li>To create a library with an empty repository in Gerrit, select the Empty project check box. The empty repository option is available only for the Create from template strategy.</li> <li> <p>Select any of the supported code languages with its framework in the Library code language field:</p> <ul> <li>Java \u2013 selecting specific Java version available.</li> <li>JavaScript - selecting JavaScript allows using the NPM tool.</li> <li>Python - selecting Python allows using the Python v.3.8, FastAPI, Flask.</li> <li>Groovy-pipeline - selecting Groovy-pipeline allows having the ability to customize a stages logic. For details,   please refer to the Customize CD Pipeline page.</li> <li>Terraform - selecting Terraform allows using the Terraform different versions via the Terraform version manager (tfenv).   EDP supports all actions available in Terraform, thus providing the ability to modify the virtual infrastructure and launch some checks with the help of linters.   For details, please refer to the Use Terraform Library in EDP page.</li> <li>Rego - this option allows using Rego code language with an Open Policy Agent (OPA) Library. For details, please   refer to the Use Open Policy Agent page.</li> <li>Container - this option allows using the Kaniko tool for building the container images from a Dockerfile. For details, please refer to the CI Pipeline for Container page.</li> <li>Helm - this option allows using the chart testing lint (Pipeline) for Helm charts or using Helm chart as a set of other Helm charts organized according to the example.</li> <li>C# - selecting C# allows using .Net v.3.1 and .Net v.6.0.</li> <li>Other - selecting Other allows extending the default code languages when creating a codebase with the Clone/Import strategy. To add another code language, inspect the Add Other Code Language page.</li> </ul> <p>Note</p> <p>The Create strategy does not allow to customize the default code language set.</p> </li> <li> <p>Select necessary Language version/framework depending on the Library code language field.</p> </li> <li> <p>The Select Build Tool field disposes of the default tools and can be changed in accordance with the selected code language.</p> </li> </ol> </li> </ul> </li> <li> <p>Click the Proceed button to switch to the next menu.</p> </li> </ol>"},{"location":"user-guide/add-library/#the-advanced-settings-menu","title":"The Advanced Settings Menu","text":"<p>The Advanced Settings menu should look like the picture below:</p> <p> Advanced settings </p> <p>a. Specify the name of the default branch where you want the development to be performed.</p> <p>Note</p> <p>The default branch cannot be deleted.</p> <p>b. Select the necessary codebase versioning type:</p> <ul> <li>default: Using the default versioning type, in order to specify the version of the current artifacts, images, and tags in the Version Control System, a developer should navigate to the corresponding file and change the version manually.</li> </ul> <ul> <li>edp: Using the edp versioning type, a developer indicates the version number from which all the artifacts will be versioned and, as a result, automatically registered in the corresponding file (e.g. pom.xml).</li> </ul> <p>When selecting the edp versioning type, the extra field will appear:</p> <p> EDP versioning </p> <p>Type the version number from which you want the artifacts to be versioned.</p> <p>Note</p> <p>The Start Version From field should be filled out in compliance with the semantic versioning rules, e.g. 1.2.3 or 10.10.10. Please refer to the Semantic Versioning page for details.</p> <p>c. Specify the pattern to validate a commit message. Use regular expression to indicate the pattern that is followed on the project to validate a commit message in the code review pipeline. An example of the pattern: <code>^[PROJECT_NAME-d{4}]:.*$</code></p> <p> Integrate with Jira server </p> <p>d. Select the Integrate with Jira server check box in case it is required to connect Jira tickets with the commits and have a respective label in the Fix Version field.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration page, and Adjust VCS Integration With Jira. Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>e. As soon as the Jira server is set, select it in the Jira Server field.</p> <p>f. Specify the pattern to find a Jira ticket number in a commit message. Based on this pattern, the value from EDP will be displayed in Jira.</p> <p> Mapping fields </p> <p>g. In the Advanced Mapping section, specify the names of the Jira fields that should be filled in with attributes from EDP:</p> <ol> <li> <p>Select the name of the field in a Jira ticket. The available fields are the following: Fix Version/s, Component/s and Labels.</p> </li> <li> <p>Click the Add button to add the mapping field name.</p> </li> <li> <p>Enter Jira pattern for the field name:</p> <ul> <li>For the Fix Version/s field, select the EDP_VERSION variable that represents an EDP upgrade version, as in 2.7.0-SNAPSHOT. Combine variables to make the value more informative. For example, the pattern EDP_VERSION-EDP_COMPONENT will be displayed as 2.7.0-SNAPSHOT-nexus-operator in Jira.</li> <li>For the Component/s field select the EDP_COMPONENT variable that defines the name of the existing repository. For example, nexus-operator.</li> <li>For the Labels field select the EDP_GITTAGvariable that defines a tag assigned to the commit in Git Hub. For example, build/2.7.0-SNAPSHOT.59.</li> </ul> </li> <li> <p>Click the bin icon to remove the Jira field name.</p> </li> </ol> <p>h. Click the Apply button to add the library to the Libraries list.</p> <p>Note</p> <p>After the complete adding of the library, inspect the Library Overview part.</p> <p>Note</p> <p>Since EDP v3.3.0, the CI tool field has been hidden. Now EDP Portal automatically defines the CI tool depending on which one is deployed with EDP. If both Jenkins and Tekton are deployed, EDP Portal chooses Tekton by default. To define the CI tool manually, operate with the spec.ciTool parameters.</p>"},{"location":"user-guide/add-library/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Libraries</li> <li>Add CD Pipeline</li> <li>Add Other Code Language</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Integrate GitHub/GitLab in Jenkins</li> <li>Integrate GitHub/GitLab in Tekton</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Manage Jenkins Agent</li> <li>Perf Server Integration</li> </ul>"},{"location":"user-guide/add-marketplace/","title":"Add Component via Marketplace","text":"<p>With the built-in Marketplace, users can easily create a new application by clicking several buttons. This page contains detailed guidelines on how to create a new component with the help of the Marketplace feature.</p>"},{"location":"user-guide/add-marketplace/#add-component","title":"Add Component","text":"<p>To create a component from template, follow the instructions below:</p> <ol> <li> <p>Navigate to the Marketplace section on the navigation bar to see the Marketplace overview page.</p> </li> <li> <p>Click the component name to open its details window and click Create from template:</p> <p> Create from template </p> </li> <li> <p>Fill in the required fields and click Apply:</p> <p> Creating from template window </p> </li> <li> <p>As a result, new component will appear in the Components section:</p> <p> Creating from template window </p> </li> </ol>"},{"location":"user-guide/add-marketplace/#related-articles","title":"Related Articles","text":"<ul> <li>Marketplace Overview</li> <li>Add Application</li> <li>Add Library</li> <li>Add Infrastructure</li> </ul>"},{"location":"user-guide/add-quality-gate/","title":"Add Quality Gate","text":"<p>This section describes how to use quality gate in EDP and how to customize the quality gate for the CD pipeline with the selected build version of the promoted application between stages.</p>"},{"location":"user-guide/add-quality-gate/#apply-new-quality-gate-to-pipelines","title":"Apply New Quality Gate to Pipelines","text":"<p>Quality gate pipeline is a usual Tekton pipeline but with a specific label: <code>app.edp.epam.com/pipelinetype: deploy</code>. To add and apply the quality gate to your pipelines, follow the steps below:</p> <p>1. To use the Tekton pipeline as a quality gate pipeline, add this label to the pipelines:     <pre><code>metadata:\n  labels:\n    app.edp.epam.com/pipelinetype: deploy\n</code></pre>   2. Insert the  value that is the quality gate name displayed in the quality gate drop-down list of the CD pipeline menu:     <pre><code>metadata:\n  name: &lt;name-of-quality-gate&gt;\n</code></pre>   3. Ensure the task <code>promote-images</code> contains steps and logic to apply to the project. Also ensure that the last task is <code>promote-images</code> which parameters are mandatory.     <pre><code>spec:\n  params:\n    - default: ''\n      description: Codebases with a tag separated with a space.\n      name: CODEBASE_TAG\n      type: string\n    - default: ''\n      name: CDPIPELINE_CR\n      type: string\n    - default: ''\n      name: CDPIPELINE_STAGE\n      type: string\n  tasks:\n    - name: promote-images\n      params:\n        - name: CODEBASE_TAG\n          value: $(params.CODEBASE_TAG)\n        - name: CDPIPELINE_STAGE\n          value: $(params.CDPIPELINE_STAGE)\n        - name: CDPIPELINE_CR\n          value: $(params.CDPIPELINE_CR)\n      runAfter:\n        - &lt;last-task-name&gt;\n      taskRef:\n        kind: Task\n        name: promote-images\n</code></pre>   4. Create a new pipeline with a unique name or modify your created pipeline with the command below. Please be aware that the \u2039edp-project\u203a value is the name of the EDP tenant:       <pre><code>kubectl apply -f &lt;file&gt;.yaml -namespace \u2039edp-project\u203a\n</code></pre> Example: file.yaml <pre><code> apiVersion: tekton.dev/v1beta1\n kind: Pipeline\n metadata:\n   labels:\n     app.edp.epam.com/pipelinetype: deploy\n   name: &lt;name-of-quality-gate&gt;\n   namespace: edp\n spec:\n   params:\n     - default: &gt;-\n         https://&lt;CI-pipeline-provisioner&gt;-edp.&lt;cluster-name&gt;.aws.main.edp.projects.epam.com/#/namespaces/$(context.pipelineRun.namespace)/pipelineruns/$(context.pipelineRun.name)\n       name: pipelineUrl\n       type: string\n     - default: ''\n       description: Codebases with a tag separated with a space.\n       name: CODEBASE_TAG\n       type: string\n     - default: ''\n       name: CDPIPELINE_CR\n       type: string\n     - default: ''\n       name: CDPIPELINE_STAGE\n       type: string\n   tasks:\n     - name: autotests\n       params:\n         - name: BASE_IMAGE\n           value: bitnami/kubectl:1.25.4\n         - name: EXTRA_COMMANDS\n           value: echo \"Hello World\"\n       taskRef:\n         kind: Task\n         name: run-quality-gate\n     - name: promote-images\n       params:\n         - name: CODEBASE_TAG\n           value: $(params.CODEBASE_TAG)\n         - name: CDPIPELINE_STAGE\n           value: $(params.CDPIPELINE_STAGE)\n         - name: CDPIPELINE_CR\n           value: $(params.CDPIPELINE_CR)\n       runAfter:\n         - autotests\n       taskRef:\n         kind: Task\n         name: promote-images\n</code></pre>"},{"location":"user-guide/add-quality-gate/#run-quality-gate","title":"Run Quality Gate","text":"<p>Before running the quality gate, first of all, ensure that the environment has deployed the created CD pipeline and then ensure that the application is successfully deployed and ready to run the quality gate. To run quality gate, please follow the steps below:</p> <ol> <li> <p>Check the CD pipeline status. To do this, open the created CD pipeline, select <code>Image stream version</code>, click <code>DEPLOY</code> button and wait until <code>Applications</code>, <code>Health</code> and <code>Sync</code> statuses become <code>green</code>. This implies that the application is successfully deployed and ready to run the quality gate.</p> <p> CD pipeline stage overview </p> </li> <li> <p>Select the <code>&lt;name-of-quality-gate&gt;</code> of <code>Quality gates</code> from the drop-down list and click the <code>RUN</code> button.The execution process should be started in the <code>Pipelines</code> menu:</p> <p> Quality gate pipeline status </p> </li> </ol>"},{"location":"user-guide/add-quality-gate/#add-stage-for-quality-gate","title":"Add Stage for Quality Gate","text":"<p>For a better understanding of this section, please read the documentation about how to add a new stage for quality gate. The scheme below illustrates two approaches of adding quality gates:</p> <p> Types of adding quality gate </p> <ul> <li>The first type of adding a quality gate is about adding the specific quality gate to the specific pipeline stage.</li> </ul> <ul> <li>The second type is rather optional and implies activating the <code>Promote in pipelines</code> option while creating a CD Pipeline to pass the quality gate in a certain sequence.</li> </ul> <p>As a result, after the quality gate is successfully passed, the projected image is promoted to the next stage.</p>"},{"location":"user-guide/add-quality-gate/#related-articles","title":"Related Articles","text":"<ul> <li>Add CD Pipeline</li> </ul>"},{"location":"user-guide/application/","title":"Manage Applications","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing applications.</p>"},{"location":"user-guide/application/#check-and-remove-application","title":"Check and Remove Application","text":"<p>As soon as the application is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this application. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>The added application will be listed in the Applications list allowing you to do the following:</p> <p> Applications menu </p> <ul> <li>Application status - displays the Git Server status. Can be red or green depending on if the EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> <li>Application name (clickable) - displays the Git Server name set during the Git Server creation.</li> <li>Open documentation - opens the documentation that leads to this page.</li> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> <li>Create new application - displays the Create new component menu.</li> <li>Edit application - edit the application by selecting the options icon next to its name in the applications list, and then selecting Edit. For details see the Edit Existing Application section.</li> <li> <p>Delete application - remove application by selecting the options icon next to its name in the applications list, and then selecting Delete.</p> <p>Note</p> <p>The application that is used in a CD pipeline cannot be removed.</p> </li> </ul> <p>There are also options to sort the applications:</p> <ul> <li>Sort the existing applications in a table by clicking the sorting icons in the table header. Sort the applications alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the applications by their status: Created, Failed, or In progress.</li> </ul> <ul> <li> <p>Select a number of applications displayed per page (15, 25 or 50 rows) and navigate between pages if the number of applications exceeds the capacity of a single page:</p> <p> Applications pages </p> </li> </ul>"},{"location":"user-guide/application/#edit-existing-application","title":"Edit Existing Application","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for applications.</p> <ol> <li> <p>To edit an application directly from the Applications overview page or when viewing the application data:</p> <ul> <li>Select Edit in the options icon menu:</li> </ul> <p> Edit application on the Applications overview page </p> <p> Edit application when viewing the application data </p> <ul> <li>The Edit Application dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, in the Edit Application dialog do the following:</p> <p> Edit application </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h of the Add Application page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. (Optional) Enable commit validation mechanism by navigating to Jenkins/Tekton and adding the commit-validate stage in the Code Review pipeline to have your commits reviewed.</p> </li> <li> <p>To disable Jira integration, in the Edit Application dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. (Optional) Disable commit validation mechanism by navigating to Jenkins/Tekton and removing the commit-validate stage in the Code Review pipeline to have your commits reviewed.</p> </li> <li> <p>To create, edit and delete application branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/application/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/autotest/","title":"Manage Autotests","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing autotests.</p>"},{"location":"user-guide/autotest/#check-and-remove-autotest","title":"Check and Remove Autotest","text":"<p>As soon as the autotest is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this autotest. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>Info</p> <p>To navigate quickly to OpenShift, Jenkins/Tekton, Gerrit, SonarQube, Nexus, and other resources, click the Overview section on the navigation bar and hit the necessary link.</p> <p>The added autotest will be listed in the Autotests list allowing you to do the following:</p> <p> Autotests page </p> <ul> <li>Autotest status - displays the Git Server status. Can be red or green depending on EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> </ul> <ul> <li>Autotest name (clickable) - displays the Git Server name set during the Git Server creation.</li> </ul> <ul> <li>Open documentation - opens the documentation that leads to this page.</li> </ul> <ul> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> </ul> <ul> <li>Create new autotest - displays the Create new component menu.</li> </ul> <ul> <li>Edit autotest - edit the autotest by selecting the options icon next to its name in the autotests list, and then selecting Edit. For details see the Edit Existing Autotest section.</li> </ul> <ul> <li> <p>Delete autotest - remove autotest with the corresponding database and Jenkins/Tekton pipelines by selecting the options icon next to its name in the Autotests list, and then selecting Delete:</p> <p>Note</p> <p>The autotest that is used in a CD pipeline cannot be removed.</p> </li> </ul> <p>There are also options to sort the applications:</p> <ul> <li>Sort the existing autotests in a table by clicking the sorting icons in the table header. Sort the autotests alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the autotests by their status: Created, Failed, or In progress.</li> </ul> <ul> <li>Select a number of autotests displayed per page (15, 25 or 50 rows)  and navigate between pages if the number of autotests exceeds the capacity of a single page.</li> </ul>"},{"location":"user-guide/autotest/#edit-existing-autotest","title":"Edit Existing Autotest","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for autotests.</p> <ol> <li> <p>To edit an autotest directly from the Autotests overview page or when viewing the autotest data:</p> <ul> <li> <p>Select Edit in the options icon menu:</p> <p> Edit autotest on the autotests overview page </p> <p> Edit autotest when viewing the autotest data </p> </li> </ul> <ul> <li>The Edit Autotest dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, on the Edit Autotest page do the following:</p> <p> Edit library </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h on the Add Autotests page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and add the create-jira-issue-metadata stage in the Build pipeline. Also add the commit-validate stage in the Code Review pipeline.</p> <p>Note</p> <p>Pay attention that the Jira integration feature is not available when using the GitLab CI tool.</p> <p>Note</p> <p>To adjust the Jira integration functionality, first apply the necessary changes described on the Adjust Jira Integration and Adjust VCS Integration With Jira pages.</p> </li> <li> <p>To disable Jira integration, in the Edit Autotest dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and remove the create-jira-issue-metadata stage in the Build pipeline. Also remove the commit-validate stage in the Code Review pipeline.</p> <p>As a result, the necessary changes will be applied.</p> </li> <li> <p>To create, edit and delete application branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/autotest/#add-autotest-as-a-quality-gate","title":"Add Autotest as a Quality Gate","text":"<p>In order to add an autotest as a quality gate to a newly added CD pipeline, do the following:</p> <ol> <li> <p>Create a CD pipeline with the necessary parameters. Please refer to the Add CD Pipeline section for the details.</p> </li> <li> <p>In the Stages menu, select the Autotest quality gate type. It means the promoting process should be confirmed by the successful passing of the autotests.</p> </li> <li> <p>In the additional fields, select the previously created autotest name and specify its branch.</p> </li> <li> <p>After filling in all the necessary fields, click the Create button to start the provisioning of the pipeline. After the CD pipeline is added, the new namespace containing the stage name will be created in Kubernetes (in OpenShift, a new project will be created) with the following name pattern: [cluster name]-[cd pipeline name]-[stage name].</p> </li> </ol>"},{"location":"user-guide/autotest/#configure-autotest-launch-at-specific-stage","title":"Configure Autotest Launch at Specific Stage","text":"<p>In order to configure the added autotest launch at the specific stage with necessary parameters, do the following:</p> <ol> <li> <p>Add the necessary stage to the CD pipeline. Please refer to the Add CD Pipeline documentation for the details.</p> </li> <li> <p>Navigate to the run.json file and add the stage name and the specific parameters.</p> </li> </ol>"},{"location":"user-guide/autotest/#launch-autotest-locally","title":"Launch Autotest Locally","text":"<p>There is an ability to run the autotests locally using the IDEA (Integrated Development Environment Application, such as IntelliJ, NetBeans etc.). To launch the autotest project for the local verification, perform the following steps:</p> <ol> <li> <p>Clone the project to the local machine.</p> </li> <li> <p>Open the project in IDEA and find the run.json file to copy out the necessary command value.</p> </li> <li> <p>Paste the copied command value into the Command line field and run it with the necessary values and namespace.</p> </li> <li> <p>As a result, all the launched tests will be executed.</p> </li> </ol>"},{"location":"user-guide/autotest/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotests</li> <li>Add CD Pipeline</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/build-pipeline/","title":"Build Pipeline","text":"<p>This section provides details on the Build pipeline of the EDP CI/CD pipeline framework. Explore below the pipeline purpose, stages and possible actions to perform.</p>"},{"location":"user-guide/build-pipeline/#build-pipeline-purpose","title":"Build Pipeline Purpose","text":"<p>The purpose of the Build pipeline contains the following points:</p> <ul> <li>Check out, test, tag and build an image from the mainstream branch after a patch set is submitted in order to inspect whether the integrated with the mainstream code fits all quality gates, can be built and tested;</li> <li>Be triggered if any new patch set is submitted;</li> <li>Tag a specific commit in Gerrit in case the build is successful;</li> <li>Build a Docker image with an application that can be afterward deployed using the Jenkins Deploy pipeline.</li> </ul> <p>Find below the functional diagram of the Build pipeline with the default stages:</p> <pre><code>---\ntitle: gitlab-gradle-java17-app-build-edp\n---\nflowchart TD\n   build --&gt; get-nexus-repository-url\n   compile --&gt; test\n   start([fa:fa-circle]) --&gt; fetch-repository\n   fetch-repository --&gt; init-values\n   get-nexus-repository-url --&gt; push\n   get-version --&gt; update-build-number\n   git-tag --&gt; update-cbis\n   init-values --&gt; get-version\n   kaniko-build --&gt; git-tag\n   push --&gt; kaniko-build\n   sast --&gt; compile\n   sonar --&gt; build\n   test --&gt; sonar\n   update-build-number --&gt; sast\n   update-cbis --&gt; stop([fa:fa-circle])</code></pre>"},{"location":"user-guide/build-pipeline/#build-pipeline-for-application-and-library","title":"Build Pipeline for Application and Library","text":"<p>The Build pipeline is triggered automatically after the Code Review pipeline is completed and the changes are submitted.</p> <p>To review the Build pipeline, take the following steps:</p> <ol> <li> <p>Open Jenkins via the created link in Gerrit or via the Admin Console Overview page.</p> </li> <li> <p>Click the Build pipeline link to open its stages for the application and library codebases:</p> <ul> <li>Init - initialization of the Code Review pipeline inputs;</li> </ul> <ul> <li>Checkout - checkout of the application code;</li> </ul> <ul> <li>Get-version - get the version from the pom.XML file and add the build number;</li> </ul> <ul> <li>Compile - code compilation;</li> </ul> <ul> <li>Tests - tests execution;</li> </ul> <ul> <li>Sonar - Sonar launch that checks the whole code;</li> </ul> <ul> <li>Build - artifact building and adding to Nexus;</li> </ul> <ul> <li>Build-image - docker image building and adding to Docker Registry. The Build pipeline for the library has the same stages as the application except the Build-image stage, i.e. the Docker image is not building.</li> </ul> <ul> <li>Push - artifact docker image pushing to Nexus and Docker Registry;</li> </ul> <ul> <li>Ecr-to-docker - the docker image, after being built, is copied from the ECR project registry to DockerHub via the Crane tool. The stage is not the default and can be set for the application codebase type.   To set this stage, please refer to the EcrToDocker.groovy file and to the Promote Docker Images From ECR to Docker Hub page.</li> </ul> <ul> <li>Git-tag - adding of the corresponding Git tag of the current commit to relate with the image, artifact, and build version.</li> </ul> </li> </ol> <p>Note</p> <p>For more details on stages, please refer to the Pipeline Stages documentation.</p> <p>After the Build pipeline runs all the stages successfully, the corresponding tag numbers will be created in Kubernetes/OpenShift and Nexus.</p>"},{"location":"user-guide/build-pipeline/#check-the-tag-in-kubernetesopenshift-and-nexus","title":"Check the Tag in Kubernetes/OpenShift and Nexus","text":"<ol> <li> <p>After the Build pipeline is completed, check the tag name and the same with the commit revision. Simply navigate to Gerrit \u2192 Projects \u2192 List \u2192 select the project \u2192 Tags.</p> <p>Note</p> <p>For the Import strategy, navigate to the repository from which a codebase is imported \u2192 Tags. It is actual both for GitHub and GitLab.</p> </li> <li> <p>Open the Kubernetes/OpenShift Overview page and click the link to Nexus and check the build of a new version.</p> </li> <li> <p>Switch to Kubernetes \u2192 CodebaseImageStream (or OpenShift \u2192 Builds \u2192 Images) \u2192 click the image stream that will be used for deployment.</p> </li> <li> <p>Check the corresponding tag.</p> </li> </ol>"},{"location":"user-guide/build-pipeline/#configure-and-start-pipeline-manually","title":"Configure and Start Pipeline Manually","text":"<p>The Build pipeline can be started manually. To set the necessary stages and trigger the pipeline manually, take the following steps:</p> <ol> <li> <p>Open the Build pipeline for the created library.</p> </li> <li> <p>Click the Build with parameters option from the left-side menu. Modify the stages by removing the whole objects massive:{\"name\". \"tests\"} where name is a key and tests is a stage name that should be executed.</p> </li> <li> <p>Open Jenkins and check the successful execution of all stages.</p> </li> </ol>"},{"location":"user-guide/build-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Autotest as Quality Gate</li> <li>Pipeline Stages</li> </ul>"},{"location":"user-guide/cd-pipeline-details/","title":"CD Pipeline Details","text":"<p>CD Pipeline (Continuous Delivery Pipeline) - an EDP business entity that describes the whole delivery process of the selected application set via the respective stages. The main idea of the CD pipeline is to promote the application build version between the stages by applying the sequential verification (i.e. the second stage will be available if the verification on the first stage is successfully completed). The CD pipeline can include the essential set of applications with its specific stages as well.</p> <p>In other words, the CD pipeline allows the selected image stream (Docker container in Kubernetes terms) to pass a set of stages for the verification process (SIT - system integration testing with the automatic type of a quality gate, QA - quality assurance, UAT - user acceptance testing with the manual testing).</p> <p>Note</p> <p>It is possible to change the image stream for the application in the CD pipeline. Please refer to the Edit CD Pipeline section for the details.</p> <p>A CI/CD pipeline helps to automate steps in a software delivery process, such as the code build initialization, automated tests running, and deploying to a staging or production environment. Automated pipelines remove manual errors, provide standardized development feedback cycle, and enable the fast product iterations. To get more information on the CI pipeline, please refer to the CI Pipeline Details chapter.</p> <p>The codebase stream is used as a holder for the output of the stage, i.e. after the Docker container (or an image stream in OpenShift terms) passes the stage verification, it will be placed to the new codebase stream. Every codebase has a branch that has its own codebase stream - a Docker container that is an output of the build for the corresponding branch.</p> <p>Note</p> <p>For more information on the main terms used in EPAM Delivery Platform, please refer to the EDP Glossary</p> <p> EDP CD pipeline </p> <p>Explore the details of the CD pipeline below.</p>"},{"location":"user-guide/cd-pipeline-details/#deploy-pipeline","title":"Deploy Pipeline","text":"<p>The Deploy pipeline is used by default on any stage of the Continuous Delivery pipeline. It addresses the following concerns:</p> <ul> <li>Deploying the application(s) to the main STAGE (SIT, QA, UAT) environment in order to run autotests and to promote image build versions to the next environments afterwards.</li> <li>Deploying the application(s) to a custom STAGE environment in order to run autotests and check manually that everything is ok with the application.</li> <li>Deploying the latest or a stable and some particular numeric version of an image build that exists in Docker registry.</li> <li>Promoting the image build versions from the main STAGE (SIT, QA, UAT) environment.</li> <li>Auto deploying the application(s) version from the passed payload (using the CODEBASE_VERSION job parameter).</li> </ul> <p>Find below the functional diagram of the Deploy pipeline with the default stages:</p> <p>Note</p> <p>The input for a CD pipeline depends on the Trigger Type for a deploy stage and can be either Manual or Auto.</p> <p> Deploy pipeline stages </p>"},{"location":"user-guide/cd-pipeline-details/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add CD Pipeline</li> <li>Add Library</li> <li>CI Pipeline Details</li> <li>CI/CD Overview</li> <li>EDP Glossary</li> <li>EDP Pipeline Framework</li> <li>EDP Pipeline Stages</li> <li>Prepare for Release</li> </ul>"},{"location":"user-guide/ci-pipeline-details/","title":"CI Pipeline Details","text":"<p>CI Pipeline (Continuous Integration Pipeline) - an EDP business entity that describes the integration of changes made to a codebase into a single project. The main idea of the CI pipeline is to review the changes in the code submitted through a Version Control System (VCS) and build a new codebase version so that it can be transmitted to the Continuous Delivery Pipeline for the rest of the delivery process.</p> <p>There are three codebase types in EPAM Delivery Platform:</p> <ol> <li>Applications - a codebase that is developed in the Version Control System, has the full lifecycle starting from the Code Review stage to its deployment to the environment;</li> <li>Libraries - this codebase is similar to the Application type, but it is not deployed and stored in the Artifactory. The library can be connected to other applications/libraries;</li> <li>Autotests - a codebase that inspects the code and can be used as a quality gate for the CD pipeline stage. The autotest only has the Code Review pipeline and is launched for the stage verification.</li> </ol> <p>Note</p> <p>For more information on the above mentioned codebase types, please refer to the Add Application, Add Library, Add Autotests and Autotest as Quality Gate pages.</p> <p> EDP CI pipeline </p>"},{"location":"user-guide/ci-pipeline-details/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Autotest as Quality Gate</li> <li>Build Pipeline</li> <li>Code Review Pipeline</li> <li>Pipeline Stages</li> </ul>"},{"location":"user-guide/cicd-overview/","title":"EDP CI/CD Overview","text":"<p>This chapter provides information on CI/CD basic definitions and flow, as well as its components and process.</p>"},{"location":"user-guide/cicd-overview/#cicd-basic-definitions","title":"CI/CD Basic Definitions","text":"<p>The Continuous Integration part means the following:</p> <ul> <li>all components of the application development are in the same place and perform the same processes for running;</li> <li>the results are published in one place and replicated into EPAM GitLab or VCS (version control system);</li> <li>the repository also includes a storage tool (e.g. Nexus) for all binary artifacts that are produced by the Jenkins CI server after submitting changes from Code Review tool into VCS;</li> </ul> <p>The <code>Code Review</code> and <code>Build</code> pipelines are used before the code is delivered. An important part of both of them is the integration tests that are launched during the testing stage.</p> <p>Many applications (SonarQube, Gerrit, etc,) used by the project need databases for their performance.</p> <p>The Continuous Delivery comprises an approach allowing to produce an application in short cycles so that it can be reliably released at any time point. This part is tightly bound with the usage of the <code>Code Review</code>, <code>Build</code>, and <code>Deploy</code> pipelines.</p> <p>The <code>Deploy</code> pipelines deploy the applications configuration and their specific versions, launch automated tests and control quality gates for the specified environment. As a result of the successfully completed process, the specific versions of images are promoted to the next environment. All environments are sequential and promote the build versions of applications one-by-one. The logic of each stage is described as a code of Jenkins pipelines and stored in the VCS.</p> <p>During the CI/CD, there are several continuous processes that run in the repository, find below the list of possible actions:</p> <ul> <li>Review the code with the help of Gerrit tool;</li> <li>Run the static analysis using SonarQube to control the quality of the source code and keep the historical data which helps to understand the trend and effectivity of particular teams and members;</li> <li>Analyze application source code using SAST, byte code, and binaries for coding/design conditions that are indicative of security vulnerabilities;</li> <li>Build the code with Jenkins and run automated tests that are written to make sure the applied changes will not break any functionality.</li> </ul> <p>Note</p> <p>For the details on autotests, please refer to the Autotest, Add Autotest, and Autotest as Quality Gate pages.</p> <p>The release process is divided into cycles and provides regular delivery of completed pieces of functionality while continuing the development and integration of new functionality into the product mainline.</p> <p>Explore the main flow that is displayed on the diagram below:</p> <p> EDP CI/CD pipeline </p>"},{"location":"user-guide/cicd-overview/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add CD Pipeline</li> <li>CI Pipeline Details</li> <li>CD Pipeline Details</li> <li>Customize CI Pipeline</li> <li>EDP Pipeline Framework</li> <li>Customize CD Pipeline</li> <li>EDP Stages</li> <li>Glossary</li> <li>Use Terraform Library in EDP</li> </ul>"},{"location":"user-guide/cluster/","title":"Manage Clusters","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing clusters.</p> <p>In a nutshell, cluster in EDP Portal is a Kubernetes secret that stores credentials and endpoint to connect to the another cluster. Adding new clusters allows users to deploy applications in several clusters, thus improving flexibility of your infrastructure.</p> <p>The added cluster will be listed in the clusters list allowing you to do the following:</p> <p> Clusters list </p>"},{"location":"user-guide/cluster/#view-authentication-data","title":"View Authentication Data","text":"<p>To view authentication data that is used to log in to the cluster, run the <code>kubectl describe</code> command:</p> <pre><code>kubectl describe secret cluster_name -n edp\n</code></pre>"},{"location":"user-guide/cluster/#delete-cluster","title":"Delete Cluster","text":"<p>To delete cluster, use the <code>kubectl delete</code> command as follows:</p> <pre><code>kubectl delete secret cluster_name -n edp\n</code></pre>"},{"location":"user-guide/cluster/#related-articles","title":"Related Articles","text":"<ul> <li>Add Cluster</li> <li>Add Application</li> </ul>"},{"location":"user-guide/code-review-pipeline/","title":"Code Review Pipeline","text":"<p>This section provides details on the Code Review pipeline of the EDP CI/CD framework. Explore below the pipeline purpose, stages and possible actions to perform.</p>"},{"location":"user-guide/code-review-pipeline/#code-review-pipeline-purpose","title":"Code Review Pipeline Purpose","text":"<p>The purpose of the Code Review pipeline contains the following points:</p> <ul> <li>Check out and test a particular developer's change (Patch Set) in order to inspect whether the code fits all the quality gates and can be built and tested;</li> <li>Be triggered if any new Patch Set appears in Gerrit;</li> <li>Send feedback about the build process in Jenkins to review the card in Gerrit;</li> <li>Send feedback about Sonar violations that have been found during the Sonar stage.</li> </ul> <p>Find below the functional diagram of the Code Review pipeline with the default stages:</p> <pre><code>---\ntitle: gitlab-gradle-java17-app-review\n---\nflowchart TD\n   build --&gt; dockerbuild-verify\n   compile --&gt; test\n   dockerbuild-verify --&gt; stop([fa:fa-circle])\n   dockerfile-lint --&gt; dockerbuild-verify\n   fetch-repository --&gt; init-values\n   fetch-repository --&gt; helm-docs\n   fetch-repository --&gt; dockerfile-lint\n   fetch-repository --&gt; helm-lint\n   helm-docs --&gt; stop([fa:fa-circle])\n   helm-lint --&gt; stop([fa:fa-circle])\n   init-values --&gt; compile\n   start([fa:fa-circle]) --&gt; report-pipeline-start-to-gitlab\n   report-pipeline-start-to-gitlab --&gt; fetch-repository\n   sonar --&gt; build\n   test --&gt; sonar</code></pre>"},{"location":"user-guide/code-review-pipeline/#code-review-pipeline-for-applications-and-libraries","title":"Code Review Pipeline for Applications and Libraries","text":"<p>Note</p> <p>Make sure the necessary applications or libraries are added to the Admin Console. For the details on how to add a codebase, please refer to the Add Application or Add Library pages accordingly.</p> <p>To discover the Code Review pipeline, apply changes that will trigger the Code Review pipeline automatically and take the following steps:</p> <ol> <li> <p>Navigate to Jenkins. In Admin Console, go to the Overview section on the left-side navigation bar and click the link to Jenkins.</p> <p> Link to Jenkins </p> <p>or</p> <p>In Gerrit, go to the Patch Set page and click the CI Jenkins link in the Change Log section</p> <p> Link from Gerrit </p> <p>Note</p> <p>The Code Review pipeline starts automatically for every codebase type (Application, Autotests, Library).</p> </li> <li> <p>Check the Code Review pipeline for the application of for the library. Click the application name in Jenkins and switch to the additional release-01 branch that is created with the respective Code Review and Build pipelines.</p> </li> <li> <p>Click the Code Review pipeline link to open the Code Review pipeline stages for the application:</p> <ul> <li>Init - initialization of the codebase information and loading of the common libraries</li> <li>gerrit-checkout / checkout - the checkout of patch sets from Gerrit. The stage is called gerrit-checkout for the Create and Clone strategies of adding a codebase and checkout for the Import strategy.</li> <li>compile - the source code compilation</li> <li>tests - the launch of the tests</li> <li>sonar - the launch of the static code analyzer that checks the whole code</li> <li>helm-lint - the launch of the linting tests for deployment charts</li> <li>dockerfile-lint - the launch of the linting tests for Dockerfile</li> <li>commit-validate - the stage is optional and appears under enabled integration with Jira. Please refer to the Adjust Jira Integration and Adjust VCS Integration With Jira sections for the details.</li> </ul> </li> </ol> <p>Note</p> <p>For more details on EDP pipeline stages, please refer to the Pipeline Stages section.</p>"},{"location":"user-guide/code-review-pipeline/#code-review-pipeline-for-autotests","title":"Code Review Pipeline for Autotests","text":"<p>To discover the Code Review pipeline for autotests, first, apply changes to a codebase that will trigger the Code Review pipeline automatically. The flow for the autotest is similar for that for applications and libraries, however, there are some differences. Explore them below.</p> <ol> <li> <p>Open the run.json file for the created autotest.</p> <p>Note</p> <p>Please refer to the Add Autotest page for the details on how to create an autotest.</p> <p>The run.json file keeps a command that is executed on this stage.</p> </li> <li> <p>Open the Code Review pipeline in Jenkins (via the link in Gerrit or via the Admin Console Overview page) and click the Configure option from the left side. There are only four stages available: Initialization - Gerrit-checkout - tests - sonar (the launch of the static code analyzer that checks the whole code).</p> </li> <li> <p>Open the Code Review pipeline in Jenkins with the successfully passed stages.</p> </li> </ol>"},{"location":"user-guide/code-review-pipeline/#retrigger-code-review-pipeline","title":"Retrigger Code Review Pipeline","text":"<p>The Code Review pipeline can be retriggered manually, especially if the pipeline failed before. To retrigger it, take the following steps:</p> <ol> <li> <p>In Jenkins, click the Retrigger option from the drop-down menu for the specific Code Review pipeline version number. Alternatively, click the Jenkins main page and select the Query and Trigger Gerrit Patches option.</p> </li> <li> <p>Click Search and select the check box of the necessary change and patch set and then click Trigger Selected.</p> </li> </ol> <p>As a result, the Code Review pipeline will be retriggered.</p>"},{"location":"user-guide/code-review-pipeline/#configure-code-review-pipeline","title":"Configure Code Review Pipeline","text":"<p>The Configure option allows adding/removing the stage from the Code Review pipeline if needed. To configure the Code Review pipeline, take the following steps:</p> <ol> <li> <p>Being in Jenkins, click the Configure option from the left-side menu.</p> </li> <li> <p>Define the stages set that will be executed for the current pipeline.</p> <ul> <li>To remove a stage, select and remove the whole objects massive: {\"name\".\"tests\"}, where name is a key and tests is a stage name that should be executed.</li> <li>To add a stage, define the objects massive: {\"name\".\"tests\"}, where name is a key and tests is a stage name that should be added.</li> </ul> <p>Note</p> <p>All stages are launched from the shared library on GitHub. The list of libraries is located in the edp-library-stages repository.</p> </li> <li> <p>To apply the new stage process, retrigger the Code Review pipeline. For details, please refer to the Retrigger Code Review Pipeline section.</p> </li> <li> <p>Open Jenkins and check that there is no removed stage in the Code Review pipeline.</p> </li> </ol>"},{"location":"user-guide/code-review-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Autotest</li> <li>Add Library</li> <li>Adjust Jira Integration</li> <li>Adjust VCS Integration With Jira</li> <li>Autotest as Quality Gate</li> <li>Pipeline Stages</li> </ul>"},{"location":"user-guide/container-stages/","title":"CI Pipeline for Container","text":"<p>EPAM Delivery Platform ensures the implemented Container support allowing to work with Dockerfile that is processed by means of stages in the Code-Review and Build pipelines. These pipelines are expected to be created after the Container Library is added.</p>"},{"location":"user-guide/container-stages/#code-review-pipeline-stages","title":"Code Review Pipeline Stages","text":"<p>In the Code Review pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage is a standard step during which all files are checked out from a selected branch of the Git repository.</p> </li> <li> <p>dockerfile-lint stage uses the hadolint tool to perform linting tests for the Dockerfile.</p> </li> <li> <p>dockerbuild-verify stage collects artifacts and builds an image from the Dockerfile without pushing to registry. This stage is intended to check if the image is built.</p> </li> </ol>"},{"location":"user-guide/container-stages/#build-pipeline-stages","title":"Build Pipeline Stages","text":"<p>In the Build pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage is a standard step during which all files are checked out from a master branch of the Git repository.</p> </li> <li> <p>get-version stage where the library version is determined either via:</p> <p>2.1. EDP versioning functionality.</p> <p>2.2. Default versioning functionality.</p> </li> <li> <p>dockerfile-lint stage uses the hadolint tool to perform linting tests for Dockerfile.</p> </li> <li> <p>build-image-kaniko stage builds Dockerfile using the Kaniko tool.</p> </li> <li> <p>git-tag stage that is intended for tagging a repository in Git.</p> </li> </ol>"},{"location":"user-guide/container-stages/#tools-for-container-images-building","title":"Tools for Container Images Building","text":"<p>EPAM Delivery Platform ensures the implemented Kaniko tool and <code>BuildConfig</code> object support. Using Kaniko tool allows building the container images from a Dockerfile both on the Kubernetes and OpenShift platforms. The <code>BuildConfig</code> object enables the building of the container images only on the OpenShift platform.</p> <p>EDP uses the <code>BuildConfig</code> object and the Kaniko tool for creating containers from a Dockerfile and pushing them to the internal container image registry. For Kaniko, it is also possible to change the Docker config file and push the containers to different container image registries.</p>"},{"location":"user-guide/container-stages/#supported-container-image-build-tools","title":"Supported Container Image Build Tools","text":"Platform Build Tools Kubernetes Kaniko OpenShift Kaniko, BuildConfig"},{"location":"user-guide/container-stages/#change-build-tool-in-the-build-pipeline","title":"Change Build Tool in the Build Pipeline","text":"<p>By default, EPAM Delivery Platform uses the <code>build-image-kaniko</code> stage for building container images on the Kubernetes platform and the <code>build-image-from-dockerfile</code> stage for building container images on the OpenShift platform.</p> <p>In order to change a build tool for the OpenShift Platform from the default <code>buildConfig</code> object to the Kaniko tool, perform the following steps:</p> <ol> <li>Modify or update a job provisioner logic, follow the instructions on the Manage Jenkins CI Pipeline Job Provisioner page.</li> <li>Update the required parameters for a new provisioner.    For example, if it is necessary to change the build tool for Container build pipeline, update the list of stages:<pre><code>stages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-from-dockerfile\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n</code></pre> <pre><code>stages['Build-library-kaniko'] = '[{\"name\": \"checkout\"},{\"name\": \"get-version\"}' +\n',{\"name\": \"dockerfile-lint\"},{\"name\": \"build-image-kaniko\"}' + \"${createJIMStage}\" + ',{\"name\": \"git-tag\"}]'\n</code></pre> </li> </ol>"},{"location":"user-guide/container-stages/#related-articles","title":"Related Articles","text":"<ul> <li>Use Dockerfile Linters for Code Review Pipeline</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/copy-shared-secrets/","title":"Copy Shared Secrets","text":"<p>The Copy Shared Secrets stage provides the ability to copy secrets from the current Kubernetes namespace into a namespace created during CD pipeline.</p> <p> Shared secrets </p> <p>Please follow the steps described below to copy the secrets:</p> <ol> <li> <p>Create a secret in the current Kubernetes namespace that should be used in the deployment. The secret label must be <code>app.edp.epam.com/use: cicd</code>, since the pipeline script will attempt to copy the secret by its label. For example:</p> <pre><code>kind: Secret\nmetadata:\nlabels:\napp.edp.epam.com/use: cicd\n</code></pre> </li> <li> <p>Add the following step to the CD pipeline <code>{\"name\":\"copy-secrets\",\"step_name\":\"copy-secrets\"}</code>. Alternatively, it is possible to create a custom job provisioner with this step.</p> </li> <li> <p>Run the job. The pipeline script will create a secret with the same data in the namespace generated by the cd pipeline.</p> <p>Note</p> <p>Service account tokens are not supported.</p> </li> </ol>"},{"location":"user-guide/copy-shared-secrets/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CD Pipeline</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/customize-cd-pipeline/","title":"Customize CD Pipeline","text":"<p>Apart from running CD pipeline stages with the default logic, there is the ability to perform the following:</p> <ul> <li>Create your own logic for stages;</li> <li>Redefine the default EDP stages of a CD pipeline.</li> </ul> <p>In order to have the ability to customize a stage logic, create a CD pipeline stage source as a Library:</p> <ol> <li> <p>Navigate to the Libraries section of the Admin Console and create a library with the Groovy-pipeline code language:</p> <p>Note</p> <p>If you clone the library, make sure that the correct source branch is selected.</p> <p> Create library </p> <p>Select the required fields to build your library:</p> <p> Advanced settings </p> </li> <li> <p>Go to the Continuous Delivery section of the Admin Console and create a CD pipeline with the library stage source and its branch:</p> <p> Library source </p> </li> </ol>"},{"location":"user-guide/customize-cd-pipeline/#add-new-stage","title":"Add New Stage","text":"<p>Follow the steps below to add a new stage:</p> <ul> <li>Clone the repository with the added library;</li> <li>Create a \"stages\" directory in the root;</li> <li>Create a Jenkinsfile with default content:<pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nDeploy()\n</code></pre> </li> </ul> <ul> <li>Create a groovy file with a meaningful name, e.g. NotificationStage.groovy;</li> <li>Put the required construction and your own logic into the file:<pre><code>import com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"notify\")\nclass Notify {\n    Script script\n    void run(context) {\n    --------------- Put your own logic here ------------------\n            script.println(\"Send notification logic\")\n    --------------- Put your own logic here ------------------\n    }\n}\nreturn Notify\n</code></pre> </li> </ul> <ul> <li> <p>Add a new stage to the STAGES parameter of the Jenkins job of your CD pipeline:</p> <p> Stages parameter </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> </li> </ul> <ul> <li>Run the job to check that your new stage has been run during the execution.</li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#redefine-existing-stage","title":"Redefine Existing Stage","text":"<p>By default, the following stages are implemented in EDP pipeline framework:</p> <ul> <li>deploy,</li> <li>deploy-helm,</li> <li>autotests,</li> <li>manual (Manual approve),</li> <li>promote-images.</li> </ul> <p>Using one of these names for annotation in your own class will lead to redefining the default logic with your own.</p> <p>Find below a sample of the possible flow of the redefining deploy stage:</p> <ul> <li>Clone the repository with the added library;</li> <li>Create a \"stages\" directory in the root;</li> <li>Create a Jenkinsfile with default content:<pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nDeploy()\n</code></pre> </li> </ul> <ul> <li>Create a groovy file with a meaningful name, e.g. CustomDeployStage.groovy;</li> <li>Put the required construction and your own logic into the file:<pre><code>import com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"deploy\")\nclass CustomDeployStage {\n    Script script\n\n    void run(context) {\n    --------------- Put your own logic here ------------------\n            script.println(\"Custom deploy stage logic\")\n    --------------- Put your own logic here ------------------\n    }\n}\nreturn CustomDeployStage\n</code></pre> </li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#add-a-new-stage-using-shared-library-via-custom-global-pipeline-libraries","title":"Add a New Stage Using Shared Library via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ul> <li> <p>Navigate to the Libraries section of the Admin Console and create a library with the Groovy-pipeline code language:</p> <p> Create library </p> <p>Select the required fields to build your library:</p> <p> Advanced settings </p> </li> </ul> <ul> <li>Clone the repository with the added library;</li> <li>Create a directory with the name <code>src/com/epam/edp/customStages/impl/cd/impl/</code> in the library repository, for instance: <code>src/com/epam/edp/customStages/impl/cd/impl/EmailNotify.groovy</code>;</li> <li>Add a Groovy file with another name to the same stages catalog, for instance \u2013 <code>EmailNotify.groovy</code>:<pre><code>package com.epam.edp.customStages.impl.cd.impl\n\nimport com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"notify\")\nclass Notify {\n    Script script\n    void run(context) {\n    --------------- Put your own logic here ------------------\n    script.println(\"Send notification logic\")\n    --------------- Put your own logic here ------------------\n   }\n}\n</code></pre> </li> </ul> <ul> <li> <p>Create a Jenkinsfile with default content and the added custom library to Jenkins:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines', 'edp-custom-shared-library-name']) _\n\nDeploy()\n</code></pre> <p>Note</p> <p><code>edp-custom-shared-library-name</code> is the name of your Custom Global Pipeline Library that should be added to the Jenkins Global Settings.</p> </li> </ul> <ul> <li> <p>Add a new stage to the STAGES parameter of the Jenkins job of your CD pipeline:</p> <p> Stages parameter </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> </li> </ul> <ul> <li>Run the job to check that the new stage has been running during the execution.</li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#redefine-a-default-stage-logic-via-custom-global-pipeline-libraries","title":"Redefine a Default Stage Logic via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>By default, the following stages are implemented in EDP pipeline framework:</p> <ul> <li>deploy,</li> <li>deploy-helm,</li> <li>autotests,</li> <li>manual (Manual approve),</li> <li>promote-images.</li> </ul> <p>Using one of these names for annotation in your own class will lead to redefining the default logic with your own.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ul> <li> <p>Navigate to the Libraries section of the Admin Console and create a library with the Groovy-pipeline code language:</p> <p> Create library </p> <p>Select the required fields to build your library:</p> <p> Advanced settings </p> </li> </ul> <ul> <li>Clone the repository with the added library;</li> <li>Create a directory with the name <code>src/com/epam/edp/customStages/impl/cd/impl/</code> in the library repository, for instance: <code>src/com/epam/edp/customStages/impl/cd/impl/CustomDeployStage.groovy;</code>;</li> <li>Add a Groovy file with another name to the same stages catalog, for instance \u2013 <code>CustomDeployStage.groovy</code>:<pre><code>package com.epam.edp.customStages.impl.cd.impl\n\nimport com.epam.edp.stages.impl.cd.Stage\n\n@Stage(name = \"deploy\")\nclass CustomDeployStage {\n    Script script\n\n    void run(context) {\n    --------------- Put your own logic here ------------------\n            script.println(\"Custom deploy stage logic\")\n    --------------- Put your own logic here ------------------\n    }\n}\n</code></pre> </li> </ul> <ul> <li> <p>Create a Jenkinsfile with default content and the added custom library to Jenkins:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines', 'edp-custom-shared-library-name']) _\n\nDeploy()\n</code></pre> <p>Note</p> <p><code>edp-custom-shared-library-name</code> is the name of your Custom Global Pipeline Library that should be added to the Jenkins Global Settings.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> </li> </ul>"},{"location":"user-guide/customize-cd-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add a New Custom Global Pipeline Library</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/customize-ci-pipeline/","title":"Customize CI Pipeline","text":"<p>This chapter describes the main steps that should be followed when customizing a CI pipeline.</p>"},{"location":"user-guide/customize-ci-pipeline/#redefine-a-default-stage-logic-for-a-particular-application","title":"Redefine a Default Stage Logic for a Particular Application","text":"<p>To redefine any stage and add custom logic, perform the steps below:</p> <ol> <li> <p>Open the GitHub repository:</p> <ul> <li>Create a directory with the name \u201cstages\u201d in the application repository;</li> <li>Create a Groovy file with a meaningful name for a custom stage description, for instance: CustomSonar.groovy.</li> </ul> </li> <li> <p>Paste the copied skeleton from the reference stage and insert the necessary logic.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> <p>The stage logic structure is the following:</p> <p>CustomSonar.groovy</p> <pre><code>import com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY])\nclass CustomSonar {\n    Script script\n    void run(context) {\n        script.sh \"echo 'Your custom logic of the stage'\"\n    }\n}\nreturn CustomSonar\n</code></pre> <p>Info</p> <p>There is the ability to redefine the predefined EDP stage as well as to create it from scratch, it depends on the name that is used in the @Stage annotation. For example, using name = \"sonar\" will redefine an existing sonar stage with the same name, but using name=\"new-sonar\" will create a new stage.</p> <p>By default, the following stages are implemented in EDP:</p> <ul> <li>build</li> <li>build-image-from-dockerfile</li> <li>build-image</li> <li>build-image-kaniko</li> <li>checkout</li> <li>compile</li> <li>create-branch</li> <li>gerrit-checkout</li> <li>get-version</li> <li>git-tag</li> <li>push</li> <li>sonar</li> <li>sonar-cleanup</li> <li>tests</li> <li>trigger-job</li> </ul> <p>Mandatory points:</p> <ul> <li>Importing classes com.epam.edp.stages.impl.ci.ProjectType and com.epam.edp.stages.impl.ci.Stage;</li> <li>Annotating \"Stage\" for class - @Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]);</li> <li>Property with the type \"Script\";</li> <li>Void the \"run\" method with the \"context input parameter\" value;</li> <li>Bring the custom class back to the end of the file: return CustomSonar.</li> </ul> </li> <li> <p>Open Jenkins and make sure that all the changes are correct after the completion of the customized pipeline.</p> </li> </ol>"},{"location":"user-guide/customize-ci-pipeline/#add-a-new-stage-for-a-particular-application","title":"Add a New Stage for a Particular Application","text":"<p>To add a new stage for a particular application, perform the steps below:</p> <ol> <li>In the GitHub repository, add a Groovy file with another name to the same stages catalog.</li> <li> <p>Copy the part of a pipeline framework logic that cannot be predefined;</p> <p>The stage logic structure is the following:</p> <p>EmailNotify.groovy</p> <pre><code>import com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"email-notify\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass EmailNotify {\n    Script script\n    void run(context) {\n        -------------------'Your custom logic here'\n    }\n}\nreturn EmailNotify\n</code></pre> </li> <li> <p>Open the default set of stages and add a new one into the Default Value field by saving the respective type {\"name\": \"email-notify\"}, save the changes:   Add stage </p> </li> <li> <p>Open Jenkins to check the pipeline; as soon as the checkout stage is passed, the new stage will appear in the pipeline:   Check stage </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> </li> </ol>"},{"location":"user-guide/customize-ci-pipeline/#redefine-a-default-stage-logic-via-custom-global-pipeline-libraries","title":"Redefine a Default Stage Logic via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ol> <li> <p>Open the GitHub repository:</p> <ul> <li>Create a directory with the name <code>/src/com/epam/edp/customStages/impl/ci/impl/stageName/</code> in the library repository, for instance: <code>/src/com/epam/edp/customStages/impl/ci/impl/sonar/</code>;</li> <li>Create a Groovy file with a meaningful name for a custom stage description, for instance \u2013 <code>CustomSonar.groovy</code>.</li> </ul> </li> <li> <p>Paste the copied skeleton from the reference stage and insert the necessary logic.</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> <p>The stage logic structure is the following:</p> <p>CustomSonar.groovy</p> <pre><code>package com.epam.edp.customStages.impl.ci.impl.sonar\n\nimport com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY])\nclass CustomSonar {\n    Script script\n    void run(context) {\n        script.sh \"echo 'Your custom logic of the stage'\"\n    }\n}\n</code></pre> <p>Info</p> <p>There is the ability to redefine the predefined EDP stage as well as to create it from scratch, it depends on the name that is used in the @Stage annotation. For example, using name = \"sonar\" will redefine an existing sonar stage with the same name, but using name=\"new-sonar\" will create a new stage.</p> <p>By default, the following stages are implemented in EDP:</p> <ul> <li>build</li> <li>build-image-from-dockerfile</li> <li>build-image</li> <li>build-image-kaniko</li> <li>checkout</li> <li>compile</li> <li>create-branch</li> <li>gerrit-checkout</li> <li>get-version</li> <li>git-tag</li> <li>push</li> <li>sonar</li> <li>sonar-cleanup</li> <li>tests</li> <li>trigger-job</li> </ul> <p>Mandatory points:</p> <ul> <li>Defining a package com.epam.edp.customStages.impl.ci.impl.stageName;</li> <li>Importing classes com.epam.edp.stages.impl.ci.ProjectType and com.epam.edp.stages.impl.ci.Stage;</li> <li>Annotating \"Stage\" for class - @Stage(name = \"sonar\", buildTool = [\"maven\"], type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]);</li> <li>Property with the type \"Script\";</li> <li>Void the \"run\" method with the \"context input parameter\" value.</li> </ul> </li> </ol> <p>3.Open Jenkins and make sure that all the changes are correct after the completion of the customized pipeline.</p>"},{"location":"user-guide/customize-ci-pipeline/#add-a-new-stage-using-shared-library-via-custom-global-pipeline-libraries","title":"Add a New Stage Using Shared Library via Custom Global Pipeline Libraries","text":"<p>Note</p> <p>To add a new Custom Global Pipeline Library, please refer to the Add a New Custom Global Pipeline Library page.</p> <p>To redefine any stage and add custom logic using global pipeline libraries, perform the steps below:</p> <ol> <li> <p>Open the GitHub repository:</p> <ul> <li>Create a directory with the name <code>/src/com/epam/edp/customStages/impl/ci/impl/stageName/</code> in the library repository, for instance: <code>/src/com/epam/edp/customStages/impl/ci/impl/emailNotify/</code>;</li> <li>Add a Groovy file with another name to the same stages catalog, for instance \u2013 <code>EmailNotify.groovy</code>.</li> </ul> </li> <li> <p>Copy the part of a pipeline framework logic that cannot be predefined;</p> <p>Note</p> <p>Pay attention to the appropriate annotation (EDP versions of all stages can be found on GitHub).</p> <p>The stage logic structure is the following:</p> <p>EmailNotify.groovy</p> <pre><code>package com.epam.edp.customStages.impl.ci.impl.emailNotify\n\nimport com.epam.edp.stages.impl.ci.ProjectType\nimport com.epam.edp.stages.impl.ci.Stage\n\n@Stage(name = \"email-notify\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass EmailNotify {\n    Script script\n    void run(context) {\n        -------------------'Your custom logic here'\n    }\n}\n</code></pre> </li> <li> <p>Open the default set of stages and add a new one into the Default Value field by saving the respective type {\"name\": \"email-notify\"}, save the changes:   Add stage </p> </li> <li> <p>Open Jenkins to check the pipeline; as soon as the checkout stage is passed, the new stage will appear in the pipeline:   Check stage </p> <p>Warning</p> <p>To make this stage permanently present, please modify the job provisioner.</p> </li> </ol>"},{"location":"user-guide/customize-ci-pipeline/#related-articles","title":"Related Articles","text":"<ul> <li>Add a New Custom Global Pipeline Library</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> <li>Add Security Scanner</li> </ul>"},{"location":"user-guide/dockerfile-stages/","title":"Use Dockerfile Linters for Code Review Pipeline","text":"<p>This section contains the description of dockerbuild-verify, dockerfile-lint stages which one can use in Code Review pipeline.</p> <p>These stages help to obtain a quick response on the validity of the code in the Code Review pipeline in Kubernetes for all types of applications supported by EDP out of the box.</p> <p> Add stages </p> <p>Inspect the functions performed by the following stages:</p> <ol> <li> <p>dockerbuild-verify stage collects artifacts and builds an image from the Dockerfile without push to registry. This stage is intended to check if the image is built.</p> </li> <li> <p>dockerfile-lint stage launches the hadolint command in order to check the Dockerfile.</p> </li> </ol>"},{"location":"user-guide/dockerfile-stages/#related-articles","title":"Related Articles","text":"<ul> <li>Use Terraform Library in EDP</li> <li>EDP Pipeline Framework</li> <li>Promote Docker Images From ECR to Docker Hub</li> <li>CI Pipeline for Container</li> </ul>"},{"location":"user-guide/ecr-to-docker-stages/","title":"Promote Docker Images From ECR to Docker Hub","text":"<p>This section contains the description of the ecr-to-docker stage, available in the Build pipeline.</p> <p>The ecr-to-docker stage is intended to perform the push of Docker images collected from the Amazon ECR cluster storage to Docker Hub repositories, where the image becomes accessible to everyone who wants to use it. This stage is optional and is designed for working with various EDP components.</p> <p>Note</p> <p>When pushing the image from ECR to Docker Hub using crane, the SHA-256 value remains unchanged.</p> <p>To run the ecr-to-docker stage just for once, navigate to the Build with Parameters option, add this stage to the stages list, and click Build.  To add the ecr-to-docker stage to the pipeline, modify the job provisioner.</p> <p>Note</p> <p>To push properly the Docker image from the ECR storage, the ecr-to-docker stage should follow the build-image-kaniko stage. Add custom lib2 </p> <p>The ecr-to-docker stage contains a specific script that launches the following actions:</p> <ol> <li>Performs authorization in AWS ECR in the EDP private storage via awsv2.</li> <li>Performs authorization in the Docker Hub.</li> <li> <p>Checks whether a similar image exists in the Docker Hub in order to avoid its overwriting.</p> <ul> <li>If a similar image exists in the Docker Hub, the script will return the message about it and stop the execution. The ecr-to-docker stage in the Build pipeline will be marked in red.</li> <li>If there is no similar image, the script will proceed to promote the image using crane.</li> </ul> </li> </ol>"},{"location":"user-guide/ecr-to-docker-stages/#create-secret-for-ecr-to-docker-stage","title":"Create Secret for ECR-to-Docker Stage","text":"<p>The ecr-to-docker stage expects the authorization credentials to be added as Kubernetes secret into EDP-installed namespace. To create the dockerhub-credentials secret, run the following command:</p> <pre><code>  kubectl -n edp create secret generic dockerhub-credentials \\\n  --from-literal=accesstoken=&lt;dockerhub_access_token&gt; \\\n  --from-literal=account=&lt;dockerhub_account_name&gt; \\\n  --from-literal=username=&lt;dockerhub_user_name&gt;\n</code></pre> <p>Note</p> <ul> <li>The \u2039dockerhub_access_token\u203a should be created beforehand and in accordance with the official Docker Hub instruction.</li> <li>The \u2039dockerhub_account_name\u203a and \u2039dockerhub_user_name\u203a for the organization account repository will differ and be identical for the personal account repository.</li> <li>Pay attention that the Docker Hub repository for images uploading should be created beforehand and named by the following pattern: \u2039dockerhub_account_name\u203a/\u2039Application Name\u203a, where the \u2039Application Name\u203a should match the application name in the EDP Admin Console.</li> </ul>"},{"location":"user-guide/ecr-to-docker-stages/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Pipeline Framework</li> <li>Manage Access Token</li> <li>Manage Jenkins CI Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/git-server-overview/","title":"Manage Git Servers","text":"<p>Git Server is responsible for integration with Version Control System, whether it is GitHub, Gitlab or Gerrit.</p> <p></p> <p>The Git Server is set via the global.gitProvider parameter of the values.yaml file.</p> <p>To view the current Git Server, you can open <code>EDP</code> -&gt; <code>Configuration</code> -&gt; <code>Git Servers</code> and inspect the following properties:</p> <p> Git Server menu </p> <ul> <li>Git Server status and name - displays the Git Server status, which depends on the Git Server integration status (Success/Failed).</li> </ul> <ul> <li>Git Server properties - displays the Git Server type, its host address, username, SSH/HTTPS port, and name of the secret that contains SSH key.</li> </ul> <ul> <li>Open documentation - opens the \"Manage Git Servers\" documentation page.</li> </ul>"},{"location":"user-guide/git-server-overview/#view-authentication-data","title":"View Authentication Data","text":"<p>To view authentication data that is used to connect to the Git server, use <code>kubectl describe</code> command as follows:</p> <pre><code>kubectl describe GitServer git_server_name -n edp\n</code></pre>"},{"location":"user-guide/git-server-overview/#delete-git-server","title":"Delete Git Server","text":"<p>To remove a Git Server from the Git Servers list, utilize the <code>kubectl delete</code> command as follows:</p> <pre><code>kubectl delete GitServer git_server_name -n edp\n</code></pre>"},{"location":"user-guide/git-server-overview/#related-articles","title":"Related Articles","text":"<ul> <li>Add Git Server</li> <li>Integrate GitHub/GitLab in Tekton</li> </ul>"},{"location":"user-guide/gitops/","title":"Manage GitOps","text":"<p>This page is dedicated to the GitOps section of the Configuration tab, the process of establishing the GitOps repository, outline benefits it extends to users within the platform capabilities. GitOps, short for \"Git Operations\", is a modern approach to managing and automating infrastructure and application deployments. In GitOps, the desired state of your environment is declared and stored in a Git repository. With GitOps, you can ensure that your infrastructure and applications are always in sync with your intended configurations and readily adapt to changing requirements.</p>"},{"location":"user-guide/gitops/#overview","title":"Overview","text":"<p>The purpose of the GitOps section is to provide users with the ability to customize the state of their environments with the help of GitOps approach that enables you to store your entire deployment configuration in a Git repository, providing version control for changes, consistent collaboration, and automated deployments. Enforcing GitOps allows you to declaratively define and automate your configurations, ensuring consistency, version control, and collaboration within your team.</p> <p>To open the GitOps subsection, navigate to <code>EDP Portal</code> -&gt; <code>EDP</code> -&gt; <code>Components</code> -&gt; <code>GitOps</code>:</p> <p> GitOps section </p>"},{"location":"user-guide/gitops/#add-gitops-repository","title":"Add GitOps Repository","text":"<p>To add a GitOps repository, follow the steps below:</p> <ol> <li> <p>Navigate to <code>EDP</code> -&gt; <code>Components</code> -&gt; <code>GitOps</code>. Click the + Add GitOps Repository button:</p> <p> Add GitOps repository </p> </li> <li> <p>Fill in the required fields (in case VCS supports nesting) and click Save:</p> <p> Required fields </p> </li> <li> <p>Check the GitOps repository connected to the platform:</p> <p> System Codebase </p> </li> </ol> <p>In addition to it, the system Codebase is called the same as the GitOps repository will be added to the Codebase list of the Components section:</p> <p> GitOps Codebase </p> <p>Note</p> <p>The platform allows only one GitOps repository at a time.</p>"},{"location":"user-guide/gitops/#gitops-usage","title":"GitOps Usage","text":"<p>Once the GitOps repository is added to the platform, you can set custom parameters for the deployed Helm Chart. To redefine the parameters, follow the steps below:</p> <ol> <li> <p>In the GitOps repository, create the values.yaml file according to the <code>&lt;pipeline-name&gt;/&lt;stage-name&gt;/&lt;application-name&gt;-values.yaml</code> pattern.</p> </li> <li> <p>In the created values.yaml file, enter the parameters with their custom values.</p> </li> <li> <p>Navigate to the Environments section. Open the created environment, open its stage and deploy it with the Values override checkbox selected as it is shown below:</p> <p> GitOps Codebase </p> </li> </ol>"},{"location":"user-guide/gitops/#delete-gitops-repository","title":"Delete GitOps Repository","text":"<p>In case you need to delete the GitOps repository, do the following:</p> <ol> <li> <p>Delete the GitOps repository in the Git provider.</p> </li> <li> <p>Delete the Codebase custom resource using the <code>kubectl delete</code> command:</p> <pre><code>kubectl delete Codebase edp-gitops -n edp\n</code></pre> </li> </ol>"},{"location":"user-guide/gitops/#related-articles","title":"Related Articles","text":"<ul> <li>Add CD Pipeline</li> <li>Cluster Add-Ons Overview</li> <li>Manage Clusters</li> </ul>"},{"location":"user-guide/helm-release-deletion/","title":"Helm Release Deletion","text":"<p>The Helm release deletion stage provides the ability to remove Helm releases from the namespace.</p> <p>Note</p> <p>Pay attention that this stages will remove all Helm releases from the namespace. To avoid loss of important data, before using this stage, make the necessary backups.</p> <p>To remove Helm releases, follow the steps below:</p> <ol> <li> <p>Add the following step to the CD pipeline <code>{\"name\":\"helm-uninstall\",\"step_name\":\"helm-uninstall\"}</code>. Alternatively, with this step, it is possible to create a custom job provisioner.</p> </li> <li> <p>Run the job. The pipeline script will remove Helm releases from the namespace.</p> </li> </ol>"},{"location":"user-guide/helm-release-deletion/#related-articles","title":"Related Articles","text":"<ul> <li>Customize CD Pipeline</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/helm-stages/","title":"Helm Chart Testing and Documentation Tools","text":"<p>This section contains the description of the helm-lint and helm-docs stages that can be used in the Code Review pipeline.</p> <p>The stages help to obtain a quick response on the validity of the helm chart code and documentation in the Code Review pipeline.</p> <p>Inspect the functions performed by the following stages:</p> <ol> <li> <p>helm-lint stage launches the ct lint --charts-deploy-templates/ command in order to validate the chart.</p> <p> Helm lint </p> <ul> <li>chart_schema.yaml - this file contains some rules by which the chart validity is checked. These rules are necessary for the YAML scheme validation.</li> </ul> <p>See the current scheme:</p> View: chart_schema.yaml <pre><code>name: str()\nhome: str()\nversion: str()\ntype: str()\napiVersion: str()\nappVersion: any(str(), num())\ndescription: str()\nkeywords: list(str(), required=False)\nsources: list(str(), required=True)\nmaintainers: list(include('maintainer'), required=True)\ndependencies: list(include('dependency'), required=False)\nicon: str(required=False)\nengine: str(required=False)\ncondition: str(required=False)\ntags: str(required=False)\ndeprecated: bool(required=False)\nkubeVersion: str(required=False)\nannotations: map(str(), str(), required=False)\n---\nmaintainer:\nname: str(required=True)\nemail: str(required=False)\nurl: str(required=False)\n---\ndependency:\nname: str()\nversion: str()\nrepository: str()\ncondition: str(required=False)\ntags: list(str(), required=False)\nenabled: bool(required=False)\nimport-values: any(list(str()), list(include('import-value')), required=False)\nalias: str(required=False)\n</code></pre> <ul> <li>ct.yaml - this file contains rules that will skip the validation of certain rules.</li> </ul> <p>To get more information about the chart testing lint, please refer to the ct_lint documentation.</p> </li> <li> <p>helm-docs stage helps to validate the generated documentation for the Helm deployment templates in the Code Review pipeline for all types of applications supported by EDP. This stage launches the helm-docs command in order to validate the chart documentation file existence and verify its relevance.</p> <p>Requirements: helm-docs v1.10.0</p> <p>Note</p> <p>The helm-docs stage is optional. To extend the pipeline with an additional stage, please refer to the Configure Code Review Pipeline page.</p> <p> Helm docs </p> <p>Note</p> <p>The example of the generated documentation.</p> </li> </ol>"},{"location":"user-guide/helm-stages/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Pipeline Framework</li> </ul>"},{"location":"user-guide/infrastructure/","title":"Manage Infrastructures","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing infrastructures.</p>"},{"location":"user-guide/infrastructure/#check-and-remove-application","title":"Check and Remove Application","text":"<p>As soon as the infrastructure is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this application. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>The added application will be listed in the Applications list allowing you to do the following:</p> <p> Applications menu </p> <ul> <li>Infrastructure status - displays the Git Server status. Can be red or green depending on if the EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> <li>Infrastructure name (clickable) - displays the infrastructure name set during the Git Server creation.</li> <li>Open documentation - opens the documentation that leads to this page.</li> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> <li>Create new infrastructure - displays the Create new component menu.</li> <li>Edit infrastructure - edit the infrastructure by selecting the options icon next to its name in the infrastructures list, and then selecting Edit. For details see the Edit Existing Application section.</li> <li>Delete infrastructure - remove infrastructure by selecting the options icon next to its name in the infrastructures list, and then selecting Delete.</li> </ul> <p>There are also options to sort the infrastructures:</p> <ul> <li>Sort the existing infrastructures in a table by clicking the sorting icons in the table header. Sort the infrastructures alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the infrastructures by their status: Created, Failed, or In progress.</li> </ul> <ul> <li>Select a number of infrastructures displayed per page (15, 25 or 50 rows)  and navigate between pages if the number of applications exceeds the capacity of a single page.</li> </ul>"},{"location":"user-guide/infrastructure/#edit-existing-infrastructure","title":"Edit Existing Infrastructure","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for infrastructures.</p> <ol> <li> <p>To edit an infrastructure directly from the infrastructures overview page or when viewing the infrastructure data:</p> <ul> <li>Select Edit in the options icon menu:</li> </ul> <p> Edit infrastructure on the Infrastructures overview page </p> <p> Edit infrastructure when viewing the infrastructure data </p> <ul> <li>The Edit Infrastructure dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, in the Edit Infrastructure dialog do the following:</p> <p> Edit infrastructure </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h on the Add Infrastructure page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and add the create-jira-issue-metadata stage in the Build pipeline. Also add the commit-validate stage in the Code Review pipeline.</p> </li> <li> <p>To disable Jira integration, in the Edit Infrastructure dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and remove the create-jira-issue-metadata stage in the Build pipeline. Also remove the commit-validate stage in the Code Review pipeline.</p> </li> <li> <p>To create, edit and delete infrastructure branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/infrastructure/#related-articles","title":"Related Articles","text":"<ul> <li>Add Infrastructure</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/library/","title":"Manage Libraries","text":"<p>This section describes the subsequent possible actions that can be performed with the newly added or existing libraries.</p>"},{"location":"user-guide/library/#check-and-remove-library","title":"Check and Remove Library","text":"<p>As soon as the library is successfully provisioned, the following will be created:</p> <ul> <li>Code Review and Build pipelines in Jenkins/Tekton for this library. The Build pipeline will be triggered automatically if at least one environment is already added.</li> <li>A new project in Gerrit or another VCS.</li> <li>SonarQube integration will be available after the Build pipeline in Jenkins/Tekton is passed.</li> <li>Nexus Repository Manager will be available after the Build pipeline in Jenkins/Tekton is passed as well.</li> </ul> <p>Info</p> <p>To navigate quickly to OpenShift, Jenkins/Tekton, Gerrit, SonarQube, Nexus, and other resources, click the Overview section on the navigation bar and hit the necessary link.</p> <p>The added library will be listed in the Libraries list allowing to do the following:</p> <p> Library menu </p> <ol> <li> <p>Create another library by clicking the plus sign icon in the lower-right corner of the screen and performing the same steps as described on the Add Library page.</p> </li> <li> <p>Open library data by clicking its link name. Once clicked, the following blocks will be displayed:</p> </li> </ol> <ul> <li>Library status - displays the Git Server status. Can be red or green depending on if the EDP Portal managed to connect to the Git Server with the specified credentials or not.</li> <li>Library name (clickable) - displays the Git Server name set during the Git Server creation.</li> <li>Open documentation - opens the documentation that leads to this page.</li> <li>Enable filtering - enables filtering by Git Server name and namespace where this custom resource is located in.</li> <li>Create new library - displays the Create new component menu.</li> <li>Edit library - edit the library by selecting the options icon next to its name in the libraries list, and then selecting Edit. For details see the Edit Existing Library section.</li> <li> <p>Delete Library - remove library with the corresponding database and Jenkins/Tekton pipelines by selecting the options icon next to its name in the libraries list, and then selecting Delete.</p> <p>Note</p> <p>The library that is used in a CD pipeline cannot be removed.</p> </li> </ul> <p>There are also options to sort the libraries:</p> <ul> <li>Sort the existing libraries in a table by clicking the sorting icons in the table header. Sort the libraries alphabetically by their name, language, build tool, framework, and CI tool. You can also sort the libraries by their status: Created, Failed, or In progress.</li> <li>Select a number of libraries displayed per page (15, 25 or 50 rows) and navigate between pages if the number of libraries exceeds the capacity of a single page.</li> </ul>"},{"location":"user-guide/library/#edit-existing-library","title":"Edit Existing Library","text":"<p>EDP Portal provides the ability to enable, disable or edit the Jira Integration functionality for libraries.</p> <ol> <li> <p>To edit a library directly from the Libraries overview page or when viewing the library data:</p> <ul> <li> <p>Select Edit in the options icon menu:</p> <p> Edit library on the libraries overview page </p> <p> Edit library when viewing the library data </p> </li> </ul> <ul> <li>The Edit Library dialog opens.</li> </ul> </li> <li> <p>To enable Jira integration, in the Edit Library dialog do the following:</p> <p> Edit library </p> <p>a. Mark the Integrate with Jira server check box and fill in the necessary fields. Please see steps d-h on the Add Library page.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and add the create-jira-issue-metadata stage in the Build pipeline. Also add the commit-validate stage in the Code Review pipeline.</p> </li> <li> <p>To disable Jira integration, in the Edit Library dialog do the following:</p> <p>a. Uncheck the Integrate with Jira server check box.</p> <p>b. Select the Apply button to apply the changes.</p> <p>c. Navigate to Jenkins/Tekton and remove the create-jira-issue-metadata stage in the Build pipeline. Also remove the commit-validate stage in the Code Review pipeline.</p> <p>As a result, the necessary changes will be applied.</p> </li> <li> <p>To create, edit and delete library branches, please refer to the Manage Branches page.</p> </li> </ol>"},{"location":"user-guide/library/#related-articles","title":"Related Articles","text":"<ul> <li>Add Library</li> <li>Manage Branches</li> </ul>"},{"location":"user-guide/manage-branches/","title":"Manage Branches","text":"<p>This page describes how to manage branches in the created component, whether it is an application, library, autotest or infrastructure.</p>"},{"location":"user-guide/manage-branches/#add-new-branch","title":"Add New Branch","text":"<p>Note</p> <p>When working with libraries, pay attention when specifying the branch name: the branch name is involved in the formation of the library version, so it must comply with the versioning semantic rules for the library.</p> <p>When adding a component, the default branch is a master branch. In order to add a new branch, follow the steps below:</p> <ol> <li> <p>Navigate to the Branches block by clicking the component name link in the Components list.</p> </li> <li> <p>Select the options icon related to the necessary branch and then select Create:</p> <p> Add branch </p> </li> <li> <p>Click Edit YAML in the upper-right corner of the dialog to open the YAML editor and add a branch. Otherwise, fill in the required fields in the dialog:</p> <p> New branch </p> <p>a. Release Branch - select the Release Branch check box if you need to create a release branch.</p> <p>b. Branch name - type the branch name. Pay attention that this field remains static if you create a release branch. For the Clone and Import strategies: if you want to use the existing branch, enter its name into this field.</p> <p>c. From Commit Hash - paste the commit hash from which the branch will be created. For the Clone and Import strategies: Note that if the From Commit Hash field is empty, the latest commit from the branch name will be used.</p> <p>d. Branch version - enter the necessary branch version for the artifact. The Release Candidate (RC) postfix is concatenated to the branch version number.</p> <p>e. Default branch version - type the branch version that will be used in a master branch after the release creation. The Snapshot postfix is concatenated to the master branch version number.</p> <p>f. Click the Apply button and wait until the new branch will be added to the list.</p> <p>Info</p> <p>Adding of a new branch is indicated in the context of the edp versioning type.</p> </li> </ol> <p>The default component repository is cloned and changed to the new indicated version before the build, i.e. the new indicated version will not be committed to the repository; thus, the existing repository will keep the default version.</p>"},{"location":"user-guide/manage-branches/#build-branch","title":"Build Branch","text":"<p>In order to build branch from the latest commit, do the following:</p> <ol> <li>Navigate to the Branches block by clicking the library name link in the Libraries list.</li> <li> <p>Select the options icon related to the necessary branch and then select Build:</p> <p> Build branch </p> </li> </ol> <p>The pipeline run status is displayed near the branch name in the Branches block:</p> <p> Pipeline run status in EDP Portal </p> <p>The corresponding item appears on the Tekton Dashboard in the PipelineRuns section:</p> <p> Pipeline run status in Tekton </p>"},{"location":"user-guide/manage-branches/#delete-branch","title":"Delete Branch","text":"<p>Note</p> <p>The default master branch cannot be removed.</p> <p>In order to delete the added branch with the corresponding record in the EDP Portal database, do the following:</p> <ol> <li>Navigate to the Branches block by clicking the component name link in the components list.</li> <li> <p>Select the options icon related to the necessary branch and then select Delete:</p> <p> Delete branch </p> </li> </ol>"},{"location":"user-guide/manage-branches/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add Autotest</li> </ul>"},{"location":"user-guide/marketplace/","title":"Marketplace Overview","text":"<p>The EDP Marketplace offers a range of Templates, predefined tools and settings for creating software. These Templates speed up development, minimize errors, and ensure consistency. A key EDP Marketplace feature is customization. Organizations can create and share their own Templates, finely tuned to their needs. Each Template serves as a tailored blueprint of tools and settings.</p> <p>These tailored Templates include preset CI/CD pipelines, automating your development workflows. From initial integration to final deployment, these processes are efficiently managed. Whether for new applications or existing ones, these templates enhance processes, save time, and ensure consistency.</p> <p>To see the Marketplace section, navigate to the Main menu -&gt; EDP -&gt; Marketplace. General look of the Marketplace section is described below:</p> <p> Marketplace section (listed view) </p> <ul> <li>Marketplace templates - all the components marketplace can offer;</li> <li>Template properties - the item summary that shows the type, category, language, framework, build tool and maturity;</li> <li>Enable/disable filters - enables users to enable/disable searching by the item name or namespace it is available in;</li> <li>Change view - allows switching from the listed view to the tiled one and vice versa. See the screenshot below for details.</li> </ul> <p>There is also a possibility to switch into the tiled view instead of the listed one:</p> <p> Marketplace section (tiled view) </p> <p>To view the details of a marketplace item, simply click on its name:</p> <p> Item details </p> <p>The details window shows supplemental information, such as item's author, keywords, release version and the link to the repository it is located in. The window also contains the Create from template button that allows users to create the component by the chosen template. The procedure of creating new components is described in the Add Component via Marketplace page.</p>"},{"location":"user-guide/marketplace/#related-articles","title":"Related Articles","text":"<ul> <li>Add Component via Marketplace</li> <li>Add Application</li> <li>Add Library</li> <li>Add Infrastructure</li> </ul>"},{"location":"user-guide/opa-stages/","title":"Use Open Policy Agent","text":"<p>Open Policy Agent (OPA) is a policy engine that provides:</p> <ul> <li>High-level declarative policy language Rego;</li> <li>API and tooling for policy execution.</li> </ul> <p>EPAM Delivery Platform ensures the implemented Open Policy Agent support allowing to work with Open Policy Agent bundles that is processed by means of stages in the Code Review and Build pipelines. These pipelines are expected to be created after the Rego OPA Library is added.</p>"},{"location":"user-guide/opa-stages/#code-review-pipeline-stages","title":"Code Review Pipeline Stages","text":"<p>In the Code Review pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage, a standard step during which all files are checked out from a selected branch of the Git repository.</p> </li> <li> <p>tests stage containing a script that performs the following actions:</p> <p>2.1. Runs policy tests.</p> <p>2.2. Converts OPA test results into JUnit format.</p> <p>2.3. Publishes JUnit-formatted results to Jenkins.</p> </li> </ol>"},{"location":"user-guide/opa-stages/#build-pipeline-stages","title":"Build Pipeline Stages","text":"<p>In the Build pipeline, the following stages are available:</p> <ol> <li> <p>checkout stage, a standard step during which all files are checked out from a selected branch of the Git repository.</p> </li> <li> <p>get-version optional stage, a step where library version is determined either via:</p> <p>2.1. Standard EDP versioning functionality.</p> <p>2.2. Manually specified version. In this case .manifest file in a root directory MUST be provided. File must contain a JSON document with revision field. Minimal example: <code>{ \"revision\": \"1.0.0\" }\"</code>.</p> </li> <li> <p>tests stage containing a script that performs the following actions:   3.1. Runs policy tests.   3.2. Converts OPA test results into JUnit format.   3.3. Publishes JUnit-formatted results to Jenkins.</p> </li> <li> <p>git-tag stage, a standard step where git branch is tagged with a version.</p> </li> </ol>"},{"location":"user-guide/opa-stages/#related-articles","title":"Related Articles","text":"<ul> <li>EDP Pipeline Framework</li> </ul>"},{"location":"user-guide/pipeline-framework/","title":"EDP Pipeline Framework","text":"<p>This chapter provides detailed information about the EDP pipeline framework concepts and parts, as well as the accurate data about the <code>Code Review</code>, <code>Build</code> and <code>Deploy</code> pipelines with the respective stages.</p>"},{"location":"user-guide/pipeline-framework/#edp-pipeline-framework-overview","title":"EDP Pipeline Framework Overview","text":"<p>Note</p> <p>The whole logic is applied to Jenkins as it is the main tool for the CI/CD processes organization.</p> <p> EDP pipeline framework basic </p> <p>The general EDP Pipeline Framework consists of several parts:</p> <ul> <li>Jenkinsfile - a text file that keeps the definition of a Jenkins Pipeline and is checked into source control. Every Job has its Jenkinsfile stored in the specific application repository and in Jenkins as the plain text. The behavior logic of the pipelines can be customized easily by modifying a source code which is always copied to the EDP repository after the EDP installation.</li> </ul> <p> Jenkinsfile example </p> <ul> <li>Loading Shared Libraries - a part where every job loads libraries with the help of the shared libraries mechanism for Jenkins that allows to create reproducible pipelines, write them uniformly, and manage the update process. There are two main libraries: EDP Pipelines with the common logic described for the main pipelines Code Review, Build, Deploy pipelines and EDP Stages library that keeps the description of the stages for every pipeline.</li> </ul> <ul> <li>Run Stages - a part where the predefined default stages are launched.</li> </ul> <p> Pipeline script </p>"},{"location":"user-guide/pipeline-framework/#cicd-jobs-comparison","title":"CI/CD Jobs Comparison","text":"<p>Explore the CI and CD job comparison. Please note that the dynamic stages order can be changed, meanwhile, the predefined stages order in the reference pipeline cannot be changed, i.e. only the predefined stages set can be run.</p> <p> CI/CD jobs comparison </p>"},{"location":"user-guide/pipeline-framework/#context","title":"Context","text":"<p>Context - a variable that stores and transfers all necessary parameters between stages that are used by pipeline during performing.</p> <ol> <li>The context type is \"Map\".</li> <li>Each stage has input and output context.</li> <li>Each stage has a mandatory input context.</li> </ol> <p>Note</p> <p>If the input context isn't transferred, the stage will be failed.</p>"},{"location":"user-guide/pipeline-framework/#annotations-for-cicd-stages","title":"Annotations for CI/CD Stages","text":"<p>Annotation for CI Stages:</p> <ul> <li>The annotation type is \"Map\";</li> <li>The annotation consists of the name, buildTool, and codebaseType.</li> </ul> <p>Annotation for CD Stages:</p> <ul> <li>The annotation type is \"Map\";</li> <li>The annotation consists of a name.</li> </ul>"},{"location":"user-guide/pipeline-framework/#code-review-pipeline","title":"Code Review Pipeline","text":"<p>CodeReview() \u2013 a function that allows using the EDP implementation for the Code Review pipeline.</p> <p>Note</p> <p>All values of different parameters that are used during the pipeline execution are stored in the \"Map\" context.</p> <p>The Code Review pipeline consists of several steps:</p> <p>On the master:</p> <ul> <li>Initialization of all objects (Platform, Job, Gerrit, Nexus, Sonar, Application, StageFactory) and loading of the default implementations of EDP stages.</li> </ul> <p>On a particular Jenkins agent that depends on the build tool:</p> <ul> <li>Creating workdir for application sources;</li> <li>Loading build tool implementation for a particular application;</li> <li>Run in a loop all stages (From) and run them either in parallel or one by one.</li> </ul>"},{"location":"user-guide/pipeline-framework/#code-review-pipeline-overview","title":"Code Review Pipeline Overview","text":"<p>Using in pipelines - @Library(['edp-library-pipelines@version'])</p> <p>The corresponding enums, interfaces, classes, and their methods can be used separately from the EDP Pipelines library function (please refer to Table 1 and Table 2).</p> <p>Table 1.  Enums and Interfaces with the respective properties, methods, and examples.</p> <p> Enums Interfaces PlatformType:  - OPENSHIFT  - KUBERNETES  JobType:  - CODEREVIEW  - BUILD  - DEPLOY BuildToolType:  - MAVEN  - GRADLE  - NPM  - DOTNET Platform() - contains methods for working with platform CLI. At the moment only OpenShift is supported. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".  Methods: getJsonPathValue(String k8s_kind, String k8s_kind_name, String jsonPath): return String value of specific parameter of particular object using jsonPath utility. Example: <code>context.platform.getJsonPathValue(''cm'',</code><code>''project-settings'', ''.data.username'')</code>. BuildTool() - contains methods for working with different buildTool from ENUM BuildToolType. Should be invoked on Jenkins build agents. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Nexus object - Object of class Nexus. Methods: init: return parameters of buildTool that are needed for running stages. Example:  <code>context.buildTool = new BuildToolFactory().</code><code>getBuildToolImpl</code><code>(context.application.config.build_tool, this,</code><code>context.nexus) context.buildTool.init()</code>. <p></p> <p>Table 2.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) PlatformFactory() - Class that contains methods getting an implementation of CLI of the platform. At the moment OpenShift and Kubernetes are supported. Methods: <code>getPlatformImpl(PlatformType platform, Script script): return Class Platform</code>. Example:  <code>context.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)</code>. Application(String name, Platform platform, Script script) - Class that describes the application object. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform(). String name - Name for the application for creating an object. Map config - Map of configuration settings for the particular application that is loaded from config map project-settings. String version - Application version, initially empty. Is set on the get-version step. String deployableModule - The name of the deployable module for multi-module applications, initially empty. String buildVersion - Version of the built artifact, contains build number of Job initially empty. String deployableModuleDir - The name of deployable module directory for multi-module applications, initially empty. Array imageBuildArgs - List of arguments for building an application Docker image. Methods: setConfig(String gerrit_autouser, String gerrit_host, String gerrit_sshPort, String gerrit_project): set the config property with values from config map. Example: <code>context.application = new Application(context.job, context.gerrit.project, context.platform, this) context.application.setConfig(context.gerrit.autouser, context.gerrit.host, context.gerrit.sshPort, context.gerrit.project)</code> Job(type: JobType.value, platform: Platform, script: Script) - Class that describes the Gerrit tool. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform(). JobType.value type. String deployTemplatesDirectory - The name of the directory in application repository where deploy templates are located. It can be set for a particular Job through DEPLOY_TEMPLATES_DIRECTORY parameter. String edpName - The name of the EDP Project. Map stages - Contains all stages in JSON format that is retrieved from Jenkins job env variable. String envToPromote - The name of the environment for promoting images. Boolean promoteImages - Defines whether images should be promoted or not. Methods: getParameterValue(String parameter, String defaultValue = null): return parameter of ENV variable of Jenkins job. init(): set all the properties of the Job object. setDisplayName(String displayName): set display name of the Jenkins job. setDescription(String description, Boolean addDescription = false): set new or add to the existing description of the Jenkins job. printDebugInfo(Map context): print context info to the log of Jenkins' job. runStage(String stage_name, Map context): run the particular stage according to its name. Example: <code>context.job = new Job(JobType.CODEREVIEW.value,</code> <code>context.platform, this)</code> <code>context.job.init()</code> <code>context.job.printDebugInfo(context)</code> <code>context.job.setDisplayName(\"test\")</code> <code>context.job.setDescription(\"Name: ${context.application.config.name}\")</code> Gerrit(Job job, Platform platform, Script script) - Class that describes the Gerrit tool. Properties: Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String credentialsId - Credential Id in Jenkins for Gerrit.String autouser - Username of an auto user in Gerrit for integration with Jenkins.String host - Gerrit host.String project - the project name of the built application.String branch - branch to build the application from.String changeNumber - change number of Gerrit commit.String changeName - change name of Gerrit commit.String refspecName - refspecName of Gerrit commit.String sshPort - Gerrit ssh port number.String patchsetNumber - patchsetNumber of Gerrit commit.Methods: init(): set all the properties of Gerrit object. Example: <code>context.gerrit = new Gerrit(context.job, context.platform, this)</code> <code>context.gerrit.init()</code> Nexus(Job job, Platform platform, Script script) - Class that describes the Nexus tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String autouser - Username of an auto user in Nexus for integration with Jenkins.String credentialsId - Credential Id in Jenkins for Nexus.String host - Nexus host.String port - Nexus http(s) port.String repositoriesUrl - Base URL of repositories in Nexus.String restUrl - URL of Rest API.Methods:init(): set all the properties of Nexus objectExample: <code>context.nexus = new Nexus(context.job, context.platform, this)</code> <code>context.nexus.init()</code> Sonar(Job job, Platform platform, Script script) - Class that describes the Sonar tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String route - External route of the sonar application.Methods:init(): set all the properties of Sonar objectExample: <code>context.sonar = new Sonar(context.job, context.platform, this)</code> <code>context.sonar.init()</code>"},{"location":"user-guide/pipeline-framework/#code-review-pipeline-stages","title":"Code Review Pipeline Stages","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass the \"Map\" context with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>The Code Review pipeline includes the following default stages: Checkout \u2192 Gerrit Checkout \u2192 Compile \u2192 Tests \u2192 Sonar.</p> <p>Info</p> <p>To get the full description of every stage, please refer to the EDP Stages Framework section.</p>"},{"location":"user-guide/pipeline-framework/#how-to-redefine-or-extend-the-edp-pipeline-stages-library","title":"How to Redefine or Extend the EDP Pipeline Stages Library","text":"<p>Inspect the points below to redefine or extend the EDP Pipeline Stages Library:</p> <ul> <li>Create \u201cstage\u201d folder in your App repository.</li> <li>Create a Groovy file with a meaningful name for the custom stage description. For instance \u2013 CustomBuildMavenApplication.groovy.</li> <li>Describe the stage logic.</li> </ul> <p>Redefinition:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"compile\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass CustomBuildMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn CustomBuildMavenApplication\n</code></pre> <p>Extension:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"new-stage\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass NewStageMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn NewStageMavenApplication\n</code></pre>"},{"location":"user-guide/pipeline-framework/#using-edp-stages-library-in-the-pipeline","title":"Using EDP Stages Library in the Pipeline","text":"<p>In order to use the EDP stages, the created pipeline should fit some requirements, that`s why a developer has to do the following:</p> <ul> <li>import library - @Library(['edp-library-stages'])</li> <li>import StageFactory class - import com.epam.edp.stages.StageFactory</li> <li>define context Map \u2013 context = [:]</li> <li>define stagesFactory instance and load EDP stages:</li> </ul> <pre><code>  context.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n</code></pre> <p>After that, there is the ability to run any EDP stage beforehand by defining a necessary context: <code>context.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)</code></p> <p>For instance, the pipeline can look like:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\nnode('maven') {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n\n\n\nstage(\"checkout\") {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n\n\nstage(\"compile\") {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n</code></pre> <p>Or in a declarative way:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\npipeline {\nagent { label 'maven' }\nstages {\nstage('Init'){\nsteps {\nscript {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n}\n}\n}\n\nstage(\"Checkout\") {\nsteps {\nscript {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n}\n}\n\nstage('Compile') {\nsteps {\nscript {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n}\n}\n}\n</code></pre>"},{"location":"user-guide/pipeline-framework/#build-pipeline","title":"Build Pipeline","text":"<p>Build() \u2013 a function that allows using the EDP implementation for the Build pipeline. All values of different parameters that are used during the pipeline execution are stored in the \"Map\" context.</p> <p>The Build pipeline consists of several steps:</p> <p>On the master:</p> <ul> <li>Initialization of all objects (Platform, Job, Gerrit, Nexus, Sonar, Application, StageFactory) and loading default implementations of EDP stages.</li> </ul> <p>On a particular Jenkins agent that depends on the build tool:</p> <ul> <li>Creating workdir for application sources;</li> <li>Loading build tool implementation for a particular application;</li> <li>Run in a loop all stages (From) and run them either in parallel or one by one.</li> </ul>"},{"location":"user-guide/pipeline-framework/#build-pipeline-overview","title":"Build Pipeline Overview","text":"<p>Using in pipelines - @Library(['edp-library-pipelines@version'])</p> <p>The corresponding enums, interfaces, classes, and their methods can be used separately from the EDP Pipelines library function (please refer to Table 3 and Table 4).</p> <p>Table 3.  Enums and Interfaces with the respective properties, methods, and examples.  Enums Interfaces PlatformType:- OPENSHIFT- KUBERNETESJobType:- CODEREVIEW- BUILD- DEPLOYBuildToolType:- MAVEN- GRADLE- NPM- DOTNET Platform() -  contains methods for working with platform CLI. At the moment only OpenShift is supported.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Methods:getJsonPathValue(String k8s_kind, String k8s_kind_name, String jsonPath): return String value of specific parameter of particular object using jsonPath utility.Example:<code>context.platform.getJsonPathValue(\"cm\",\"project-settings\",</code><code>\".data.username\")</code>BuildTool() - contains methods for working with different buildTool from ENUM BuildToolType. Should be invoked on Jenkins build agents.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Nexus object - Object of class Nexus. See description below:Methods:init: return parameters of buildTool that are needed for running stages.Example:<code>context.buildTool = new BuildToolFactory().getBuildToolImpl</code><code>(context.application.config.build_tool, this,</code><code>context.nexus)context.buildTool.init()</code> <p> Table 4.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) PlatformFactory() - Class that contains methods getting an implementation of CLI of the platform. At the moment OpenShift and Kubernetes are supported. Methods:getPlatformImpl(PlatformType platform, Script script): return Class PlatformExample:<code>context.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)</code> Application(String name, Platform platform, Script script) - Class that describes the application object. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().String name - Name for the application for creating an object.Map config - Map of configuration settings for the particular application that is loaded from config map project-settings.String version - Application version, initially empty. Is set on the get-version step.String deployableModule - The name of the deployable module for multi-module applications, initially empty.String buildVersion - Version of the built artifact, contains build number of Job initially empty.String deployableModuleDir - The name of deployable module directory for multi-module applications, initially empty.Array imageBuildArgs - List of arguments for building the application Docker image.Methods:setConfig(String gerrit_autouser, String gerrit_host, String gerrit_sshPort, String gerrit_project): set the config property with values from config map.Example:<code>context.application = new Application(context.job, context.gerrit.project, context.platform, this) context.application.setConfig(context.gerrit.autouser, context.gerrit.host, context.gerrit.sshPort, context.gerrit.project)</code> Job(type: JobType.value, platform: Platform, script: Script) - Class that describes the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().JobType.value type.String deployTemplatesDirectory - The name of the directory in application repository, where deploy templates are located. It can be set for a particular Job through DEPLOY_TEMPLATES_DIRECTORY parameter.String edpName - The name of the EDP Project.Map stages - Contains all stages in JSON format that is retrieved from Jenkins job env variable.String envToPromote - The name of the environment for promoting images.Boolean promoteImages - Defines whether images should be promoted or not.Methods:getParameterValue(String parameter, String defaultValue = null): return parameter of ENV variable of Jenkins job.init(): set all the properties of the Job object.setDisplayName(String displayName): set display name of the Jenkins job.setDescription(String description, Boolean addDescription = false): set new or add to the existing description of the Jenkins job.printDebugInfo(Map context): print context info to the log of Jenkins' job.runStage(String stage_name, Map context): run the particular stage according to its name.Example:<code>context.job = new Job(JobType.CODEREVIEW.value, context.platform, this) context.job.init() context.job.printDebugInfo(context) context.job.setDisplayName(\"test\") context.job.setDescription(\"Name: ${context.application.config.name}\")</code> Gerrit(Job job, Platform platform, Script script) - Class that describes the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String credentialsId - Credentials Id in Jenkins for Gerrit.String autouser - Username of an auto user in Gerrit for integration with Jenkins.String host - Gerrit host.String project - the project name of the built application.String branch - branch to build an application from.String changeNumber - change number of Gerrit commit.String changeName - change name of Gerrit commit.String refspecName - refspecName of Gerrit commit.String sshPort - Gerrit ssh port number.String patchsetNumber - patchsetNumber of Gerrit commit.Methods:init(): set all the properties of Gerrit objectExample: <code>context.gerrit = new Gerrit(context.job, context.platform, this) context.gerrit.init()</code> Nexus(Job job, Platform platform, Script script) - Class that describes the Nexus tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String autouser - Username of an auto user in Nexus for integration with Jenkins.String credentialsId - Credentials Id in Jenkins for Nexus.String host - Nexus host.String port - Nexus http(s) port.String repositoriesUrl - Base URL of repositories in Nexus.String restUrl - URL of Rest API.Methods:init(): set all the properties of the Nexus object.Example:<code>context.nexus = new Nexus(context.job, context.platform, this) context.nexus.init()</code> Sonar(Job job, Platform platform, Script script) - Class that describes the Sonar tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform().Job job - Object of a class Job().String route - External route of the sonar application.Methods:init(): set all the properties of Sonar object.Example:<code>context.sonar = new Sonar(context.job, context.platform, this) context.sonar.init()</code>"},{"location":"user-guide/pipeline-framework/#build-pipeline-stages","title":"Build Pipeline Stages","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass a context map with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>The Build pipeline includes the following default stages: Checkout \u2192 Gerrit Checkout \u2192 Compile \u2192 Get version \u2192 Tests \u2192 Sonar \u2192 Build \u2192 Build Docker Image \u2192 Push \u2192 Git tag.</p> <p>Info</p> <p>To get the full description of every stage, please refer to the EDP Stages Framework section.</p>"},{"location":"user-guide/pipeline-framework/#how-to-redefine-or-extend-edp-pipeline-stages-library","title":"How to Redefine or Extend EDP Pipeline Stages Library","text":"<p>Inspect the points below to redefine or extend the EDP Pipeline Stages Library:</p> <ul> <li>Create a \u201cstage\u201d folder in the App repository.</li> <li>Create a Groovy file with a meaningful name for the custom stage description. For instance \u2013 CustomBuildMavenApplication.groovy</li> <li>Describe stage logic.</li> </ul> <p>Redefinition:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"compile\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass CustomBuildMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn CustomBuildMavenApplication\n</code></pre> <p>Extension:</p> <pre><code>import com.epam.edp.stages.ProjectType\nimport com.epam.edp.stages.Stage\n@Stage(name = \"new-stage\", buildTool = \"maven\", type = ProjectType.APPLICATION)\nclass NewStageMavenApplication {\nScript script\nvoid run(context) {\nscript.sh \"echo 'Your custom logic of the stage'\"\n}\n}\nreturn NewStageMavenApplication\n</code></pre>"},{"location":"user-guide/pipeline-framework/#using-edp-stages-library-in-the-pipeline_1","title":"Using EDP Stages Library in the Pipeline","text":"<p>In order to use the EDP stages, the created pipeline should fit some requirements, that`s why a developer has to do the following:</p> <ul> <li>import library - @Library(['edp-library-stages'])</li> <li>import StageFactory class - import com.epam.edp.stages.StageFactory</li> <li>define context Map \u2013 context = [:]</li> <li>define stagesFactory instance and load EDP stages:</li> </ul> <pre><code>context.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n</code></pre> <p>After that, there is the ability to run any EDP stage beforehand by defining a requirement context <code>context.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)</code></p> <p>For instance, the pipeline can look like:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\nnode('maven') {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n\n\n\nstage(\"checkout\") {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n\n\nstage(\"compile\") {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n</code></pre> <p>Or in a declarative way:</p> <pre><code>@Library(['edp-library-stages']) _\n\nimport com.epam.edp.stages.StageFactory\nimport org.apache.commons.lang.RandomStringUtils\n\ncontext = [:]\n\npipeline {\nagent { label 'maven' }\nstages {\nstage('Init'){\nsteps {\nscript {\ncontext.workDir = new File(\"/tmp/${RandomStringUtils.random(10, true, true)}\")\ncontext.workDir.deleteDir()\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.gerrit = [:]\ncontext.application = [:]\ncontext.application.config = [:]\ncontext.buildTool = [:]\ncontext.nexus = [:]\n}\n}\n}\n\nstage(\"Checkout\") {\nsteps {\nscript {\ncontext.gerrit.branch = \"master\"\ncontext.gerrit.credentialsId = \"jenkins\"\ncontext.application.config.cloneUrl = \"ssh://jenkins@gerrit:32092/sit-718-cloned-java-maven-project\"\ncontext.factory.getStage(\"checkout\",\"maven\",\"application\").run(context)\n}\n}\n}\n\nstage('Compile') {\nsteps {\nscript {\ncontext.buildTool.command = \"mvn\"\ncontext.nexus.credentialsId = \"nexus\"\ncontext.factory.getStage(\"compile\",\"maven\",\"application\").run(context)\n}\n}\n}\n}\n}\n</code></pre>"},{"location":"user-guide/pipeline-framework/#edp-library-stages-description","title":"EDP Library Stages Description","text":"<p>Using in pipelines - @Library(['edp-library-stages@version'])</p> <p>The corresponding enums, classes, interfaces and their methods can be used separately from the EDP Stages library function (please refer to Table 5).</p> <p>Table 5.  Enums and Classes with the respective properties, methods, and examples.</p> Enums Classes ProjectType: - APPLICATION  - AUTOTESTS  - LIBRARY StageFactory() - Class that contains methods getting an implementation of the particular stage either EDP from shared library or custom from application repository.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Map stages - Map of stages implementations.Methods:loadEdpStages(): return a list of Classes that describes EDP stages implementations.loadCustomStages(String directory): return a list of Classes that describes EDP custom stages from application repository from \"directory\". The \"directory\" should have an absolute path to files with classes of custom stages implementations. Should be run from a Jenkins agent.add(Class clazz): register class for some particular stage in stages map of StageFactory class.getStage(String name, String buildTool, String type): return an object of the class for a particular stage from stages property based on stage name and buildTool, type of application.Example:<code>context.factory = new StageFactory(script: this)</code><code>context.factory.loadEdpStages().each() { context.factory.add(it) }</code><code>context.factory.loadCustomStages(\"${context.workDir}/stages\").each() { context.factory.add(it) }</code><code>context.factory.getStage(stageName.toLowerCase(),context.application.config.build_tool.toLowerCase(),</code><code>context.application.config.type).run(context)</code>"},{"location":"user-guide/pipeline-framework/#edp-stages-framework","title":"EDP Stages Framework","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass a context map with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>Inspect the Table 6 and Table 7 that contain the full description of every stage that can be included in Code Review and Build pipelines: Checkout \u2192 Gerrit Checkout \u2192 Compile \u2192 Get version \u2192 Tests \u2192 Sonar \u2192 Build \u2192 Build Docker Image \u2192 Push \u2192 Git tag.</p> <p>Table 6.  The Checkout, Gerrit Checkout, Compile, Get version, and Tests stages description.</p> Checkout Gerrit Checkout Compile Get version Tests name = \"checkout\",buildTool = [\"maven\", \"npm\", \"dotnet\",\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- StageFactory context.factory- String context.gerrit.branch- String context.gerrit.credentialsId- String context.application.config.cloneUrl name = \"gerrit-checkout\",buildTool = [\"maven\", \"npm\", \"dotnet\",\"gradle\"]type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]context required:- String context.workDir- StageFactory context.factory- String context.gerrit.changeName- String context.gerrit.refspecName- String context.gerrit.credentialsId- String context.application.config.cloneUrl name = \"compile\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.sln_filenameoutput:- String context.buildTool.sln_filenamebuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.groupRepository name = \"get-version\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- Map(empty) context.application- String context.gerrit.branch- Job context.joboutput:-String context.application.deplyableModule- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersionbuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.command- Job context.job- String context.gerrit.branchoutput:- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersionbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.command- Job context.job- String context.gerrit.branchoutput:- String context.application.deplyableModule- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersionbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- Job context.job- String context.gerrit.branchoutput:- String context.application.deplyableModuleDir- String context.application.version- String context.application.buildVersion name = \"tests\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDirbuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.commandbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.commandtype = [ProjectType.AUTOTESTS]context required:- String context.workDir- String context.buildTool.command- String context.application.config.report_frameworkbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir <p>Table 7.  The Sonar, Build, Build Docker Image, Push, and Git tag stages description.</p> Sonar Build Build Docker Image Push Git tag name = \"sonar\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.job.type- String context.application.name- String context.buildTool.sln_filename- String context.sonar.route- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline)buildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.job.type- String context.nexus.credentialsId- String context.buildTool.command- String context.application.name- String context.sonarRoute- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline)buildTool = [\"maven\"]type = [ProjectType.APPLICATION, ProjectType.AUTOTESTS, ProjectType.LIBRARY]context required:- String context.workDir- String context.job.type- String context.nexus.credentialsId- String context.application.name- String context.buildTool.command- String context.sonar.route- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline)buildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.job.type- String context.sonar.route- String context.application.name- String context.gerrit.changeName(Only for codereview pipeline)- String context.gerrit.branch(Only for build pipeline) name = \"build\"buildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.buildTool.command- String context.nexus.credentialsIdbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.groupRepository name = \"build-image\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromotebuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromotebuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromotebuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.application.deployableModule- String context.application.deployableModuleDir- String context.application.name- String context.application.config.language- String context.application.buildVersion- Boolean context.job.promoteImages- String context.job.envToPromote name = \"push\"buildTool = [\"dotnet\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.gerrit.project- String context.buildTool.sln_filename- String context.buildTool.snugetApiKey- String context.buildTool.hostedRepositorybuildTool = [\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.application.version- String context.buildTool.hostedRepository- String context. buildTool.settingsbuildTool = [\"maven\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.application.version- String context.buildTool.hostedRepository- String context.buildTool.commandbuildTool = [\"npm\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.nexus.credentialsId- String context.buildTool.hostedRepository- String context.gerrit.autouser name = \"git-tag\"buildTool = [\"maven\", \"npm\", \"dotnet\",\"gradle\"]type = [ProjectType.APPLICATION]context required:- String context.workDir- String context.gerrit.credentialsId- String context.gerrit.sshPort- String context.gerrit.host- String context.gerrit.autouser- String context.application.buildVersion"},{"location":"user-guide/pipeline-framework/#deploy-pipeline","title":"Deploy Pipeline","text":"<p>Deploy() \u2013 a function that allows using the EDP implementation for the deploy pipeline. All values of different parameters that are used during the pipeline execution are stored in the \"Map\" context.</p> <p>The deploy pipeline consists of several steps:</p> <p>On the master:</p> <ul> <li>Initialization of all objects (Platform, Job, Gerrit, Nexus, StageFactory) and loading the default implementations of EDP stages;</li> <li>Creating an environment if it doesn`t exist;</li> <li>Deploying the last versions of the applications;</li> <li>Run predefined manual gates.</li> </ul> <p>On a particular autotest Jenkins agent that depends on the build tool:</p> <ul> <li>Creating workdir for autotest sources;</li> <li>Run predefined autotests.</li> </ul>"},{"location":"user-guide/pipeline-framework/#edp-library-pipelines-description","title":"EDP Library Pipelines Description","text":"<p>_Using in pipelines - @Library(['edp-library-pipelines@version']) _</p> <p>The corresponding enums and interfaces with their methods can be used separately from the EDP Pipelines library function (please refer to Table 8 and Table 9).</p> <p>Table 8.  Enums and Interfaces with the respective properties, methods, and examples.</p> <p> Enums Interfaces PlatformType:- OPENSHIFT- KUBERNETESJobType:- CODEREVIEW- BUILD- DEPLOYBuildToolType:- MAVEN- GRADLE- NPM- DOTNET Platform() - contains methods for working with platform CLI. At the moment only OpenShift is supported.Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Methods:getJsonPathValue(String k8s_kind, String k8s_kind_name, String jsonPath): return String value of specific parameter of particular object using jsonPath utility. Example: <code>context.platform.getJsonPathValue(\"cm\",\"project-settings\",</code><code>\".data.username\")</code> BuildTool() - contains methods for working with different buildTool from ENUM BuildToolType. (Should be invoked on Jenkins build agents)Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Nexus object - Object of class Nexus.Methods:init: return parameters of buildTool that are needed for running stages. Example:<code>context.buildTool = new BuildToolFactory().getBuildToolImpl</code><code>(context.application.config.build_tool, this, context.nexus)</code><code>context.buildTool.init()</code> <p> Table 9.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) PlatformFactory() - Class that contains methods getting implementation of CLI of platform. At the moment OpenShift and Kubernetes are supported. Methods:getPlatformImpl(PlatformType platform, Script script): return Class PlatformExample: <code>context.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)</code> Application(String name, Platform platform, Script script) - Class that describe the application object. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform()String name - Name for the application for creating objectMap config - Map of configuration settings for particular application that is loaded from config map project-settingsString version - Application version, initially empty. Is set on get-version step.String deployableModule - The name of deployable module for multi module applications, initially empty.String buildVersion - Version of built artifact, contains build number of Job initially emptyString deployableModuleDir - The name of deployable module directory for multi module applications, initially empty.Array imageBuildArgs - List of arguments for building application Docker imageMethods: setConfig(String gerrit_autouser, String gerrit_host, String gerrit_sshPort, String gerrit_project): set the config property with values from config mapExample: <code>context.application = new Application(context.job, context.gerrit.project, context.platform, this)</code> <code>context.application.setConfig(context.gerrit.autouser, context.gerrit.host, context.gerrit.sshPort, context.gerrit.project)</code> Job(type: JobType.value, platform: Platform, script: Script) - Class that describe the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\"Platform platform - Object of a class Platform().JobType.value type.String deployTemplatesDirectory - The name of the directory in application repository, where deploy templates are located. Can be set for particular Job through DEPLOY_TEMPLATES_DIRECTORY parameter.String edpName - The name of the EDP Project.Map stages - Contains all stages in JSON format that is retrieved from Jenkins job env variable.String envToPromote - The name of the environment for promoting images.Boolean promoteImages - Defines whether images should be promoted or not. Methods:getParameterValue(String parameter, String defaultValue = null): return parameter of ENV variable of Jenkins job. init(): set all the properties of Job object. setDisplayName(String displayName): set display name of the Jenkins job. setDescription(String description, Boolean addDescription = false): set new or add to existing description of the Jenkins job. printDebugInfo(Map context): print context info to log of Jenkins job. runStage(String stage_name, Map context): run the particular stage according to its name. Example: <code>context.job = new Job(JobType.DEPLOY.value, context.platform, this)</code> <code>context.job.init()</code> <code>context.job.printDebugInfo(context)</code> <code>context.job.setDisplayName(\"test\")</code> <code>context.job.setDescription(\"Name: ${context.application.config.name}\")</code> Gerrit(Job job, Platform platform, Script script) - Class that describe the Gerrit tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\".Platform platform - Object of a class Platform(). Job job - Object of a class Job().String credentialsId - Credential Id in Jenkins for Gerrit. String autouser - Username of autouser in Gerrit for integration with Jenkins. String host - Gerrit host. String project - project name of built application. String branch - branch to build application from. String changeNumber - change number of Gerrit commit. String changeName - change name of Gerrit commit. String refspecName - refspecName of Gerrit commit. String sshPort - gerrit ssh port number. String patchsetNumber - patchsetNumber of Gerrit commit.Methods:init(): set all the properties of Gerrit object. Example:<code>context.gerrit = new Gerrit(context.job, context.platform, this)</code><code>context.gerrit.init()</code>. Nexus(Job job, Platform platform, Script script) - Class that describe the Nexus tool. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\". Platform platform - Object of a class Platform(). Job job - Object of a class Job(). String autouser - Username of autouser in Nexus for integration with Jenkins. String credentialsId - Credential Id in Jenkins for Nexus. String host - Nexus host. String port - Nexus http(s) port. String repositoriesUrl - Base URL of repositories in Nexus. String restUrl - URL of Rest API. Methods:init(): set all the properties of Nexus object. Example: <code>context.nexus = new Nexus(context.job, context.platform, this)</code> <code>context.nexus.init()</code>."},{"location":"user-guide/pipeline-framework/#edp-library-stages-description_1","title":"EDP Library Stages Description","text":"<p>Using in pipelines - @Library(['edp-library-stages@version']) _</p> <p>The corresponding classes with methods can be used separately from the EDP Pipelines library function (please refer to Table 10).</p> <p>Table 10.  Classes with the respective properties, methods, and examples.</p> Classes Description (properties, methods, and examples) StageFactory() - Class that contains methods getting implementation of particular stage either EDP from shared library or custom from application repository. Properties:Script script - Object with type script, in most cases if class created from Jenkins pipelines it is \"this\"Map stages - Map of stages implementationsMethods:loadEdpStages(): return list of Classes that describes EDP stages implementationsloadCustomStages(String directory): return list of Classes that describes EDP custom stages from application repository from \"directory\". The \"directory\" should be absolute path to files with classes of custom stages implementations. Should be run from Jenkins agent.add(Class clazz): register class for some particular stage in stages map of StageFactory classgetStage(String name, String buildTool, String type): return object of the class for particular stage from stages property based on stage name and buildTool, type of applicationExample:<code>context.factory = new StageFactory(script: this)</code><code>context.factory.loadEdpStages().each() { context.factory.add(it) }</code><code>context.factory.loadCustomStages(\"${context.workDir}/stages\").each() { context.factory.add(it) }</code><code>context.factory.getStage(stageName.toLowerCase(),context.application.config.build_tool.toLowerCase(),</code><code>context.application.config.type).run(context)</code>."},{"location":"user-guide/pipeline-framework/#deploy-pipeline-stages","title":"Deploy Pipeline Stages","text":"<p>Each EDP stage implementation has run method that is as input parameter required to pass a context map with different keys. Some stages can implement the logic for several build tools and application types, some of them are specific.</p> <p>The stages for the deploy pipeline are independent of the build tool and application type. Find below (see Table 11 ) the full description of every stage: Deploy \u2192 Automated tests \u2192 Promote Images.</p> <p>Table 11.  The Deploy, Automated tests, and Promote Images stages description.</p> Deploy Automated tests Promote Images name = \"deploy\"buildTool = nulltype = nullcontext required:\u2022   String context.workDir\u2022   StageFactory context.factory\u2022 String context.gerrit.autouser\u2022   String context.gerrit.host\u2022   String context.application.config.cloneUrl\u2022   String context.jenkins.token\u2022 String context.job.edpName\u2022   String context.job.buildUrl\u2022  String context.job.jenkinsUrl\u2022    String context.job.metaProject\u2022   List context.job.applicationsList [['name':'application1_name','version':'application1_version],...]\u2022 String context.job.deployTemplatesDirectoryoutput:\u2022   List context.job.updatedApplicaions [['name':'application1_name','version':'application1_version],...]   name = \"automation-tests\", buildTool = null, type = nullcontext required:- String context.workDir- StageFactory context.factory- String context.gerrit.credentialsId- String context.autotest.config.cloneUrl- String context.autotest.name- String context.job.stageWithoutPrefixName- String context.buildTool.settings- String context.autotest.config.report_framework name = \"promote-images\"buildTool = nulltype = nullcontext required:- String context.workDir- String context.buildTool.sln_filename- List context.job.updatedApplicaions [['name':'application1_name','version':'application1_version],...]"},{"location":"user-guide/pipeline-framework/#how-to-redefine-or-extend-edp-pipeline-stages-library_1","title":"How to Redefine or Extend EDP Pipeline Stages Library","text":"<p>Info</p> <p>Currently, the redefinition of Deploy pipeline stages is prohibited.</p>"},{"location":"user-guide/pipeline-framework/#using-edp-library-stages-in-the-pipeline","title":"Using EDP Library Stages in the Pipeline","text":"<p>In order to use the EDP stages, the created pipeline should fit some requirements, that`s why a developer has to do the following:</p> <ul> <li>import libraries - @Library(['edp-library-stages', 'edp-library-pipelines']) _</li> <li>import reference EDP classes(See example below)</li> <li>define context Map \u2013 context = [:]</li> <li>define reference \"init\" stage</li> </ul> <p>After that, there is the ability to run any EDP stage beforehand by defining requirement context <code>context.job.runStage(\"Deploy\", context)</code>.</p> <p>For instance, the pipeline can look like:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nimport com.epam.edp.stages.StageFactory\nimport com.epam.edp.platform.PlatformFactory\nimport com.epam.edp.platform.PlatformType\nimport com.epam.edp.JobType\n\ncontext = [:]\n\nnode('master') {\nstage(\"Init\") {\ncontext.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)\ncontext.job = new com.epam.edp.Job(JobType.DEPLOY.value, context.platform, this)\ncontext.job.init()\ncontext.job.initDeployJob()\nprintln(\"[JENKINS][DEBUG] Created object job with type - ${context.job.type}\")\n\ncontext.nexus = new com.epam.edp.Nexus(context.job, context.platform, this)\ncontext.nexus.init()\n\ncontext.jenkins = new com.epam.edp.Jenkins(context.job, context.platform, this)\ncontext.jenkins.init()\n\ncontext.gerrit = new com.epam.edp.Gerrit(context.job, context.platform, this)\ncontext.gerrit.init()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.environment = new com.epam.edp.Environment(context.job.deployProject, context.platform, this)\ncontext.job.printDebugInfo(context)\ncontext.job.setDisplayName(\"${currentBuild.displayName}-${context.job.deployProject}\")\n\ncontext.job.generateInputDataForDeployJob()\n}\n\nstage(\"Pre Deploy Custom stage\") {\nprintln(\"Some custom pre deploy logic\")\n}\n\ncontext.job.runStage(\"Deploy\", context)\n\nstage(\"Post Deploy Custom stage\") {\nprintln(\"Some custom post deploy logic\")\n}\n}\n</code></pre> <p>Or in a declarative way:</p> <pre><code>@Library(['edp-library-stages', 'edp-library-pipelines']) _\n\nimport com.epam.edp.stages.StageFactory\nimport com.epam.edp.platform.PlatformFactory\nimport com.epam.edp.platform.PlatformType\nimport com.epam.edp.JobType\n\ncontext = [:]\n\npipeline {\nagent { label 'master'}\nstages {\nstage('Init') {\nsteps {\nscript {\ncontext.platform = new PlatformFactory().getPlatformImpl(PlatformType.OPENSHIFT, this)\ncontext.job = new com.epam.edp.Job(JobType.DEPLOY.value, context.platform, this)\ncontext.job.init()\ncontext.job.initDeployJob()\nprintln(\"[JENKINS][DEBUG] Created object job with type - ${context.job.type}\")\n\ncontext.nexus = new com.epam.edp.Nexus(context.job, context.platform, this)\ncontext.nexus.init()\n\ncontext.jenkins = new com.epam.edp.Jenkins(context.job, context.platform, this)\ncontext.jenkins.init()\n\ncontext.gerrit = new com.epam.edp.Gerrit(context.job, context.platform, this)\ncontext.gerrit.init()\n\ncontext.factory = new StageFactory(script: this)\ncontext.factory.loadEdpStages().each() { context.factory.add(it) }\n\ncontext.environment = new com.epam.edp.Environment(context.job.deployProject, context.platform, this)\ncontext.job.printDebugInfo(context)\ncontext.job.setDisplayName(\"${currentBuild.displayName}-${context.job.deployProject}\")\n\ncontext.job.generateInputDataForDeployJob()\n}\n}\n}\nstage('Deploy') {\nsteps {\nscript {\ncontext.factory.getStage(\"deploy\").run(context)\n}\n}\n}\n\nstage('Custom stage') {\nsteps {\nprintln(\"Some custom logic\")\n}\n}\n}\n}\n</code></pre>"},{"location":"user-guide/pipeline-framework/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add Library</li> <li>Add CD Pipeline</li> <li>CI Pipeline Details</li> <li>CD Pipeline Details</li> <li>Customize CI Pipeline</li> <li>Customize CD Pipeline</li> <li>EDP Stages</li> <li>Glossary</li> <li>Use Terraform Library in EDP</li> </ul>"},{"location":"user-guide/pipeline-stages/","title":"Pipeline Stages","text":"<p>Get acquainted with EDP CI/CD workflow and stages description.</p>"},{"location":"user-guide/pipeline-stages/#edp-cicd-workflow","title":"EDP CI/CD Workflow","text":"<p>Within EDP, the pipeline framework comprises the following pipelines:</p> <ul> <li>Code Review;</li> <li>Build;</li> <li>Deploy.</li> </ul> <p>Note</p> <p>Please refer to the EDP Pipeline Framework page for details.</p> <p>The diagram below shows the delivery path through these pipelines and the respective stages. Please be aware that stages may differ for different codebase types.</p> <p> stages </p>"},{"location":"user-guide/pipeline-stages/#stages-description","title":"Stages Description","text":"<p>The table below provides the details on all the stages in the EDP pipeline framework:</p> Name Dependency Description Pipeline Application Library Autotest Source code Documentation init Initiates information gathering Create Release, Code Review, Build + + Build.groovy checkout Performs for all files the checkout from a selected branch of the Git repository. For the main branch - from HEAD, for code review - from the commit Create Release, Build + + Checkout.groovy sast Launches vulnerability testing via Semgrep scanner. Pushes a vulnerability report to the DefectDojo. Build + Security compile Compiles the code, includes individual groovy files for each type of app or lib (NPM, DotNet, Python, Maven, Gradle) Code Review, Build + + Compile tests Launches testing procedure, includes individual groovy files for each type of app or lib Code Review, Build + + + Tests sonar Launches testing via SonarQube scanner and includes individual groovy files for each type of app or lib Code Review, Build + + Sonar build Builds the application, includes individual groovy files for each type of app or lib (Go, Maven, Gradle, NPM) Code Review, Build + Build create-branch EDP create-release process Creates default branch in Gerrit during create and clone strategies Create Release + + + CreateBranch.groovy trigger-job EDP create-release process Triggers \"build\" job Create Release + + + TriggerJob.groovy gerrit-checkout Performs checkout to the current project branch in Gerrit Code Review + + + GerritCheckout.groovy commit-validate Optional in EDP Admin Console Takes Jira parameters, when \"Jira Integration\" is enabled for the project in the Admin Console. Code Review + + CommitValidate.groovy dockerfile-lint Launches linting tests for Dockerfile Code Review + LintDockerApplicationLibrary.groovy Use Dockerfile Linters for Code Review dockerbuild-verify \"Build\" stage (if there are no \"COPY\" layers in Dockerfile) Launches build procedure for Dockerfile without pushing an image to the repository Code Review + BuildDockerfileApplicationLibrary.groovy Use Dockerfile Linters for Code Review helm-lint Launches linting tests for deployment charts Code Review + LintHelmApplicationLibrary.groovy Use helm-lint for Code Review helm-docs Checks generated documentation for deployment charts Code Review + HelmDocsApplication.groovy Use helm-docs for Code Review helm-uninstall Helm release deletion step to clear Helm releases Deploy + HelmUninstall.groovy Helm release deletion semi-auto-deploy-input Provides auto deploy with timeout and manual deploy flow Deploy + SemiAutoDeployInput.groovy Semi Auto Deploy get-version Defines the versioning of the project depending on the versioning schema selected in Admin Console Build + + GetVersion terraform-plan AWS credentials added to Jenkins Checks Terraform version, and installs default version if necessary, and launches terraform init, returns AWS username which used for action, and terraform plan command is called with an output of results to .tfplan file Build + TerraformPlan.groovy Use Terraform library in EDP terraform-apply AWS credentials added to Jenkins, the \"Terraform-plan\" stage Checks Terraform version, and installs default version if necessary, and launches terraform init, launches terraform plan from saves before .tfplan file, asks to approve, and run terraform apply from .tfplan file Build + TerraformApply.groovy Use Terraform library in EDP build-image-from-dockerfile Platform: OpenShift Builds Dockerfile Build + + .groovy files for building Dockerfile image build-image-kaniko Platform: k8s Builds Dockerfile using the Kaniko tool Build + BuildImageKaniko.groovy push Pushes an artifact to the Nexus repository Build + + Push create-Jira-issue-metadata \"get-version\" stage Creates a temporary CR in the namespace and after that pushes Jira Integration data to Jira ticket, and delete CR Build + + JiraIssueMetadata.groovy ecr-to-docker DockerHub credentials added to Jenkins Copies the docker image from the ECR project registry to DockerHub via the Crane tool after it is built Build + EcrToDocker.groovy Promote Docker Images From ECR to Docker Hub git-tag \"Get-version\" stage Creates a tag in SCM for the current build Build + + GitTagApplicationLibrary.groovy deploy Deploys the application Deploy + Deploy.groovy manual Works with the manual approve to proceed Deploy + ManualApprove.groovy promote-images Promotes docker images to the registry Deploy + PromoteImage.groovy <p>Note</p> <p>The Create Release pipeline is an internal EDP mechanism for adding, importing or cloning a codebase. It is not a part of the pipeline framework.</p>"},{"location":"user-guide/pipeline-stages/#related-articles","title":"Related Articles","text":"<ul> <li>Manage Jenkins CI Job Provisioner</li> <li>GitLab Webhook Configuration</li> <li>GitHub Webhook Configuration</li> </ul>"},{"location":"user-guide/prepare-for-release/","title":"Prepare for Release","text":"<p>After the necessary applications are added to EDP, they can be managed via the Admin Console. To prepare for the release, create a new branch from a selected commit with a set of CI pipelines (Code Review and Build pipelines), launch the Build pipeline, and add a new CD pipeline as well.</p> <p>Note</p> <p>Please refer to the Add Application and Add CD Pipeline for the details on how to add an application or a CD pipeline.</p> <p>Become familiar with the following preparation steps for release and a CD pipeline structure:</p> <ul> <li>Create a new branch</li> <li>Launch the Build pipeline</li> <li>Add a new CD pipeline</li> <li>Check CD pipeline structure</li> </ul>"},{"location":"user-guide/prepare-for-release/#create-a-new-branch","title":"Create a New Branch","text":"<ol> <li> <p>Open Gerrit via the Admin Console Overview page to have this tab available in a web browser.</p> </li> <li> <p>Being in Admin Console, open the Applications section and click an application from the list to create a new branch.</p> </li> <li> <p>Once clicked the application name, scroll down to the Branches menu and click the Create button to open the Create New Branch dialog box, fill in the Branch Name field by typing a branch name.</p> <ul> <li>Open the Gerrit tab in the web browser, navigate to Projects \u2192 List \u2192 select the application \u2192 Branches \u2192 gitweb for a necessary branch.</li> </ul> <ul> <li>Select the commit that will be the last included to a new branch commit.</li> </ul> <ul> <li>Copy to clipboard the commit hash.</li> </ul> </li> <li> <p>Paste the copied hash to the From Commit Hash field and click Proceed.</p> </li> </ol> <p>Note</p> <p>If the commit hash is not added to the From Commit Hash field, the new branch will be created from the head of the master branch.</p>"},{"location":"user-guide/prepare-for-release/#launch-the-build-pipeline","title":"Launch the Build Pipeline","text":"<ol> <li> <p>After the new branches are added, open the details page of every application and click the CI link that refers to Jenkins.</p> <p>Note</p> <p>The adding of a new branch may take some time. As soon as the new branch is created, it will be displayed in the list of the Branches menu.</p> </li> <li> <p>To build a new version of a corresponding Docker container (an image stream in OpenShift terms) for the new branch, start the Build pipeline. Being in Jenkins, select the new branch tab and click the link to the Build pipeline.</p> </li> <li> <p>Navigate to the Build with Parameters option and click the Build button to launch the Build pipeline.</p> <p>Warning</p> <p>The predefined default parameters should not be changed when triggering the Build pipeline, otherwise, it will lead to the pipeline failure.</p> </li> </ol>"},{"location":"user-guide/prepare-for-release/#add-a-new-cd-pipeline","title":"Add a New CD Pipeline","text":"<ol> <li> <p>Add a new CD pipeline and indicate the new release branch using the Admin console tool. Pay attention to the Applications menu, the necessary application(s) should be selected there, as well as the necessary branch(es) from the drop-down list.</p> <p>Note</p> <p>For the details on how to add a CD pipeline, please refer to the Add CD Pipeline page.</p> </li> <li> <p>As soon as the Build pipelines are successfully passed in Jenkins, the Docker Registry, which is used in EDP by default, will have the new image streams (Docker container in Kubernetes terms) version that corresponds to the current branch.</p> </li> <li> <p>Open the Kubernetes/OpenShift page of the project via the Admin Console Overview page \u2192 go to CodebaseImageStream (in OpenShift, go to Builds \u2192 Images) \u2192 check whether the image streams are created under the specific name (the combination of the application and branch names) and the specific tags are added. Click every image stream link.</p> </li> </ol>"},{"location":"user-guide/prepare-for-release/#check-cd-pipeline-structure","title":"Check CD Pipeline Structure","text":"<p>When the CD pipeline is added through the Admin Console, it becomes available in the CD pipelines list. Every pipeline has the details page with the additional information. To explore the CD pipeline structure, follow the steps below:</p> <ol> <li> <p>Open Admin Console and navigate to Continuous Delivery section, click the newly created CD pipeline name.</p> </li> <li> <p>Discover the CD pipeline components:</p> <ul> <li>Applications - the list of applications with the image streams and links to Jenkins for the respective branch;</li> </ul> <ul> <li>Stages - a set of stages with the defined characteristics and links to Kubernetes/OpenShift project;</li> </ul> <p>Note</p> <p>Initially, an environment is empty and does not have any deployment unit. When deploying the subsequent stages, the artifacts of the selected versions will be deployed to the current project and the environment will display the current stage status. The project has a standard pattern: \u2039edp-name\u203a-\u2039pipeline-name\u203a-\u2039stage-name\u203a.</p> <ul> <li>Deployed Versions - the deployment status of the specific application and the predefined stage.</li> </ul> </li> </ol>"},{"location":"user-guide/prepare-for-release/#launch-cd-pipeline-manually","title":"Launch CD Pipeline Manually","text":"<p>Follow the steps below to deploy the QA and UAT application stages:</p> <ol> <li> <p>As soon as the Build pipelines for both applications are successfully passed, the new version of the Docker container will appear, thus allowing to launch the CD pipeline. Simply navigate to Continuous Delivery and click the pipeline name to open it in Jenkins.</p> </li> <li> <p>Click the QA stage link.</p> </li> <li> <p>Deploy the QA stage by clicking the Build Now option.</p> </li> <li> <p>After the initialization step starts, in case another menu is opened, the Pause for Input option will appear. Select the application version in the drop-down list and click Proceed. The pipeline passes the following stages:</p> <ul> <li>Init - initialization of the Jenkins pipeline outputs with the stages that are the Groovy scripts that execute the current code;</li> <li>Deploy - the deployment of the selected versions of the docker container and third-party services. As soon as the Deployed pipeline stage is completed, the respective environment will be deployed.</li> <li>Approve - the verification stage that enables to Proceed or Abort this stage;</li> <li>Promote-images - the creation of the new image streams for the current versions with the pattern combination: [pipeline name]-[stage name]-[application name]-[verified];</li> </ul> <p>After all the stages are passed, the new image streams will be created in the Kubernetes/OpenShift with the new names.</p> </li> <li> <p>Deploy the UAT stage, which takes the versions that were verified during the QA stage, by clicking the Build Now option, and select the necessary application versions. The launch process is the same as for all the deploy pipelines.</p> </li> <li> <p>To get the status of the pipeline deployment, open the CD pipeline details page and check the Deployed versions state.</p> </li> </ol>"},{"location":"user-guide/prepare-for-release/#cd-pipeline-as-a-team-environment","title":"CD Pipeline as a Team Environment","text":"<p>Admin Console allows creating a CD pipeline with a part of the application set as a team environment. To do this, perform the following steps;</p> <ol> <li>Open the Continuous Delivery section \u2192 click the Create button \u2192 enter the pipeline name (e.g. team-a) \u2192 select ONE application and choose the master branch for it \u2192 add one DEV stage.</li> <li>As soon as the CD pipeline is added to the CD pipelines list, its details page will display the links to Jenkins and Kubernetes/OpenShift.</li> <li>Open Jenkins and deploy the DEV stage by clicking the Build Now option.</li> <li>Kubernetes/OpenShift keeps an independent environment that allows checking the new versions, thus speeding up the developing process when working with several microservices.</li> </ol> <p>As a result, the team will have the same abilities to verify the code changes when developing and during the release.</p>"},{"location":"user-guide/prepare-for-release/#related-articles","title":"Related Articles","text":"<ul> <li>Add Application</li> <li>Add CD Pipeline</li> <li>Autotest as Quality Gate</li> <li>Build Pipeline</li> <li>CD Pipeline Details</li> <li>Customize CD Pipeline</li> </ul>"},{"location":"user-guide/semi-auto-deploy/","title":"Semi Auto Deploy","text":"<p>The Semi Auto Deploy stage provides the ability to deploy applications with the custom logic that comprises the following behavior:</p> <ul> <li>When the build of an application selected for deploy in the CD pipeline is completed, the Deploy pipeline is automatically triggered;</li> <li>By default, the deploy stage waits for 5 minutes, and if the user does not interfere with the process (cancels or selects certain versions of the application to deploy), then the deploy stage will deploy the latest versions of all applications;</li> <li>The stage can be used in the manual mode.</li> </ul> <p>To enable the Semi Auto Deploy stage during the deploy process, follow the steps below:</p> <ol> <li>Create or update the CD pipeline: make sure the trigger type for the stage is set to auto.</li> <li>Replace the <code>{\"name\":\"auto-deploy-input\",\"step_name\":\"auto-deploy-input\"}</code> step to the <code>{\"name\":\"semi-auto-deploy-input\",\"step_name\":\"semi-auto-deploy-input\"}</code> step in the CD pipeline. Alternatively, it is possible to create a custom job provisioner with this step.</li> <li>Run the Build pipeline for any application selected in the CD pipeline.</li> </ol>"},{"location":"user-guide/semi-auto-deploy/#exceptional-cases","title":"Exceptional Cases","text":"<p>After the timeout starts and in case the pipeline has been interrupted not from the Input requested menu, the automatic deployment will be proceeding. To resolve the issue and stop the pipeline, click the Input requested menu -&gt; Abort or being on the pipeline UI, click the Abort button.</p>"},{"location":"user-guide/semi-auto-deploy/#related-articles","title":"Related Articles","text":"<ul> <li>Add CD Pipeline</li> <li>Customize CD Pipeline</li> <li>Manage Jenkins CD Pipeline Job Provisioner</li> </ul>"},{"location":"user-guide/terraform-stages/","title":"CI Pipelines for Terraform","text":"<p>EPAM Delivery Platform ensures the implemented Terraform support by adding a separate component type called Infrastructure. The Infrastructure codebase type allows to work with Terraform code that is processed by means of stages in the Code-Review and Build pipelines.</p>"},{"location":"user-guide/terraform-stages/#pipeline-stages-for-terraform","title":"Pipeline Stages for Terraform","text":"<p>Under the hood, Infrastructure codebase type, namely Terraform, looks quite similar to other codebase types. The distinguishing characterstic of the Infrastructure codebase type is that there is a stage called terraform-check in both of Code Review and Build pipelines. This stage runs the pre-commit activities which in their turn run the following commands and tools:</p> <ol> <li> <p>Terraform fmt - the first step of the stage is basically the <code>terraform fmt</code> command. The <code>terraform fmt</code> command automatically updates the formatting of Terraform configuration files to follow the standard conventions and make the code more readable and consistent.</p> </li> <li> <p>Lock provider versions - locks the versions of the Terraform providers used in the project. This ensures that the project uses specific versions of the providers and prevents unexpected changes from impacting the infrastructure due to newer provider versions.</p> </li> <li> <p>Terraform validate - checks the syntax and validity of the Terraform configuration files. It scans the configuration files for all possible issues.</p> </li> <li> <p>Terraform docs - generates human-readable documentation for the Terraform project.</p> </li> <li> <p>Tflint - additional validation step using the <code>tflint</code> linter to provide more in-depth checks in addition to what the <code>terraform validate</code> command does.</p> </li> <li> <p>Checkov - runs the <code>checkov</code> command against the Terraform codebase to identify any security misconfigurations or compliance issues.</p> </li> <li> <p>Tfsec - another security-focused validation step using the <code>tfsec</code> command. Tfsec is a security scanner for Terraform templates that detects potential security issues and insecure configurations in the Terraform code.</p> </li> </ol> <p>Note</p> <p>The commands and their attributes are displayed in the .pre-commit-config.yaml file.</p>"},{"location":"user-guide/terraform-stages/#related-articles","title":"Related Articles","text":"<ul> <li>User Guide Overview</li> <li>Add Infrastructure</li> <li>Manage Infrastructures</li> </ul>"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index c370822b3d02f32ce7cfa51a25164cc93dd963cb..b56c81f05535153aa8d12fe391e3c7c44cee46e3 100644
GIT binary patch
delta 15
WcmdnUy^)(uzMF$XdiF-P)vN#`HUw4x

delta 15
WcmdnUy^)(uzMF&NSocP@)vN#}=mhZq