Exemple e2e Azure Logic Apps

Exemple de model de treball per a CI/CD d’un Azure Logic Apps

Com ja s’ha comentat anteriorment, el nou model de treball es basarà en :

• Gestió de branques amb un model Gitflow.
• Integracions de branques basades en Pull Request.
• Tagging d’artefactes i repositoris amb el model Semantic Version 2.0.

En el següent exemple es mostra l’execució e2e d’un flux de treball, des que el desenvolupador realitza la seva implementació en una branca Feature, fins al desplegament en Producció. La infraestructura ha estat desplegada prèviament. En el cas que l’ aplicació no disposi d’ entorn de desenvolupament, l’ estratègia seria la integració de feature en develop i d’ aquesta a rellegeixi sense desplegar en l’ entorn de development.

L’accés a GHEC es realitzarà des de la URL: https://ctti.ghe.com/enterprises/ctti/.

0. Prerequisits Es defineixen els següents prerequisits per al correcte funcionament del desplegament.

   • Estructura de carpetes i fitxers:

   connections.json
   parameters.json
   host.json
   workflows/
       folder_1/
           workflow.json
       folder_X/
           workflow.json
   

1. Integració en branca develop des de feature L’usuari ja ha realitzat el seu desenvolupament en la branca feature i es disposa a Integrar els seus canvis a develop.

   

   Objectiu : Integració de feature a develop i generació d’artefacte per a desplegament en Desenvolupament.

   Actors:

   • Usuari amb Rol Write que realitza el desenvolupament.
   • Usuari amb Rol Maintain que aprova la Pull Request(PR).

   Configuració dels workflow per a Logic Apps Aquest necessari definir:

   • Fitxer .github/workflows/static-cd.yaml

     • Nou input per al nom de logic apps: logicapps_app_name

     logicapps_app_name:
         type: choice
         description: "Logics App name"
         required: false
         options:
           - "<storage_name_dev>"
           - "<storage_name_pre>"
           - "<storage_name_pro>"
     

     • Definir en l’anomenada a reusable: technology com “raw” com “raw”, cloud com “azure”, engine com “logicapps” i usar el valor del nou input.

     technology: raw
     cloud: azure
     engine: logicapps
     logicapps_app_name: ${{ inputs.logicapps_app_name }}
     

   • Fitxer .github/workflows/static-ci-on-commit.yaml

     • Definir en l’anomenada a reusable: technology com “logicapps”

     technology: raw
     source_path: ""
     

   • Fitxer .github/workflows/static-ci-on-pr.yaml

     • Definir en l’anomenada a reusable: technology com “logicapps”

     technology: raw
     engine: logicapps
     

   Execució de Workflows : Automàtic

   • Static CI on PR en realitzar la PR. Genera l’artefacte, havent realitzat prèviament anàlisi de qualitat i seguretat.
   • Static CI on Commit to develop, en realitzar el Commit, empaquetant el codi en un zip i ho guarda en Jfrog

   Resultat de l’operació :

   • Branca feature integrada en develop.
   • Codi validat per un Reviewer i per eines de qualitat i seguretat.
   • Generació i pujada del zip a Jfrog Artifactory.
   • Tag del repositori a 202XXXXX.XXXXXX-SNAPSHOT i zip 202XXXXX.XXXXXX-SNAPSHOT.zip

2. Validació funcional d’artefacte en desenvolupament. L’usuari es disposa a realitzar el desplegament de l’artefacte generat en el pas 1 i desplegar-lo en l’entorn de desenvolupament per a la seva validació funcional.

   

   Objectiu : Desplegament en desenvolupament de l’artefacte generat anteriorment per a la seva validació.

   Actors:

   • Usuari amb Rol Write o Maintain.

   Execució de Workflows : Sota Demanda per part de l’usuari.

   • Static CD, comprova que existeixi el zip, que es pugui desplegar en l’entorn, i executa el desplegament.

     En aquest cas l’execució és manual i per a això l’usuari (independentment del seu rol, però s’aconsella que sigui el de maintain) tindrà que :

     1. Accedir als WorkFlows del repositori mitjançant l’opció “Actions”, indicada en l’apartat Configuració dels diferents WorkFlows de CI/CD

     2. Seleccionar el workflow a executar, en aquest cas Static CD, i prèmer “Run Workflow”, apareixent el formulari per introduir la informació necessària per l’execució:

     

     • Branca o branch on es troba el workflow actualitzat: develop.
     • Artifact Version : Versió de l’artefacte, en aquest cas 202XXXXX.XXXXXX-SNAPSHOT.
     • Environment : dev, per al desplegament a desenvolupament.
     • ITSM ID Change Coordinator: ID de l’usuari per crear la CRQ en ITSM amb l’objectiu d’informar sobre el desplegament.

   • Resultat de l’operació :

     • Codi desplegat a l’entorn de Desenvolupament per a la seva validació.
     • Creació de TAG de repositori «tag-repositori-actual»-development per a propòsits de rollback automàtic. Exemple “202XXXXX.XXXXXX-SNAPSHOT-development”.

3. Integració en branca release des de develop Un cop validat el codi en l’entorn de desenvolupament, el desenvolupador pot promocionar-lo a la branca Release i així poder desplegar-lo posteriorment al pas 4.

   

   Objectiu : Integrar el codi a Release per posteriorment desplegar en entorns Preproductius un artefacte Release Candidate.

   Actors:

   • Usuari amb Rol Write realitza el desenvolupament i sol·licita la Pull Request.
   • Usuari amb Rol Maintain aprova la Pull Request.

   Execució de Workflows: Automàtic.

   • Static CI on Commit en aprovar la Pull Request.

   Resultat de l’operació:

   • Branca develop integrada en release.
   • Generació i pujada del zip a Jfrog Artifactory.
   • Re-Tag del repositori a 202XXXXX.XXXXXX-RC i zip 202XXXXX.XXXXXX-RC.zip

4. Validació funcional d’artefacte en Preproducció Estant disponible el zip amb un tag vàlid, es realitza el desplegament per realitzar les validacions necessàries.

   

   Objectiu : Desplegament en Preproducció de l’artefacte per a la seva validació funcional.

   Actors:

   • Usuari amb Rol Write o Maintain.

   Execució de Workflows : Sota Demanda per part de l’usuari.

   • Static CD, comprova que existeixi el zip, que es pugui desplegar en l’entorn de Preproducció, i executa el desplegament informant en ITSM.

     En aquest cas l’execució és manual i l’usuari haurà d’omplir un formulari amb la informació del desplegament (revisar com executar workflow manualment descrit en l’apartat Validació funcional d’artefacte en desenvolupament):

     • Branca o branch on es troba el workflow actualitzat: release.
     • Artifact Version : Versió de l’artefacte, en aquest cas 202XXXXX.XXXXXX-RC.
     • Environment : pre, per al desplegament a Preproducció.
     • ITSM ID Change Coordinator: ID de l’usuari per crear la CRQ en ITSM amb l’objectiu d’informar sobre el desplegament.

     Resultat de l’operació :

     • Codi desplegat a l’entorn de Preproducció per a la seva validació. [Pendent] Es realitzaran validacions mitjançant la integració amb el Marc d’Automatització de Testing (MAT) i MAM (Marc d’Automatització de Monitoratge).
     • Creació de TAG de repositori «tag-repositori-actual»-preproduction per a propòsits de rollback automàtic. Exemple “202XXXXX.XXXXXX-RC-preproduction”.

5. Integració en branca master des de release Una vegada realitzara la validació funcional, l’usuari es disposa a integrar en master per a deixar un artefacte disponible per a desplegar en Producció.

   

   Objectiu: Integrar el codi a branca master i generar artefacte final per al desplegament en Producció.

   Actors:

   • Usuari amb Rol Write realitza el desenvolupament i sol·licita la Pull Request a màster.
   • Usuari amb Rol Maintain aprova la Pull Request.

   Execució de Workflows: Automàtic

   • Static CI on Commit en aprovar la Pull Request. L’artefacte ha estat creat a la fase anterior i només es realitza un “Re-Tag” amb el tag de master.

   Resultat de l’operació:

   • Branca release integrada en master.
   • Generació i pujada del zip a Jfrog Artifactory.
   • Re-Tag del repositori a 202XXXXX.XXXXXX i zip 202XXXXX.XXXXXX.zip

6. Desplegament d’aplicació a Producció Una vegada hi ha l’artefacte disponible a Jfrog Artifactory amb un tag que habilita la seva promoció a pro, i totes les validacions realitzades en entorns Preproductius, l’artefacte es pot desplegar en Producció

   

   Objectiu: Desplegament en Producció de l’aplicació.

   Actors:

   • Usuari amb Rol Write o Maintain.

   Execució de Workflows: Sota Demanda per part de l’usuari.

   • Static CD, comprova que existeixi el zip, que es pugui desplegar en l’entorn de Producció, i executa el desplegament informant en ITSM.

   En aquest cas l’execució és manual i l’usuari haurà d’omplir un formulari amb la informació del desplegament (revisar com executar workflow manualment descrit en l’apartat Validació funcional d’artefacte en desenvolupament):

   • Branca o branch on es troba el workflow actualitzat: master.
   • Artifact Version: Versió de l’artefacte, en aquest cas 202XXXXX.XXXXXX
   • Environment: pro, per al desplegament a Producció.
   • ITSM ID Change Coordinator: ID de l’usuari per crear la CRQ en ITSM amb l’objectiu d’informar sobre el desplegament.

   Resultat de l’operació :

   • Codi desplegat a l’entorn de Producció.
   • Creació de TAG de repositori «tag-repositori-actual»-production per a propòsits de rollback automàtic.