Dissenyador

Dissenyador és l’entorn principal per a la creació, configuració i administració del cicle de vida dels microserveis dins d’una organització. Des d’aquesta interfície, els usuaris poden definir nous microserveis, editar els existents, arxivar-los temporalment o eliminar-los de forma definitiva, segons les necessitats operatives. La vista de llista mostra una taula amb els microserveis creats, juntament amb la informació següent:

• Nom. Nom del microservei.
• Categoria. Directori o grup de microserveis. Les categories s’han de predefinir a Organització.
• Biblioteca. Organització a la qual pertany el microservei.
• Arxivat. Indica si el microservei està Arxivat o Actiu. Els arxivats no estan disponibles per al seu ús, mentre que els actius sí.
• Accions. Desplega tres opcions:
  • Veure detalls. Mostra la informació ampliada del microservei.
  • Editar. Permet modificar la configuració del microservei.
  • Arxivar / Activar. Obre una finestra de confirmació, per arxivar o activar el microservei, segons el seu estat actual.

Finestra de confirmació per arxivar un microservei: Finestra de confirmació per activar un microservei:

​

Crear un microservei

El procés de creació d’un microservei es realitza mitjançant un assistent dividit en quatre fases, que guien l’usuari pas a pas fins a completar la configuració.

​

Fase 1 - Configuració inicial

1. Accedir a Microserveis → Dissenyador.
2. Fer clic a Nou.
3. S’obrirà l’assistent que demanarà introduir la informació següent:

• Nom. Nom del microservei.
• Color. Color de la icona representativa.
• Icona. Tipus d’icona associada.
• Descripció. Breu explicació de la seva funcionalitat.
• Llenguatge. Llenguatge de programació utilitzat.
• Versió. Número de versió.
• Àmbit. Àmbit d’execució. Es pot seleccionar Workspace (context Sistema o Sessió) o Plataforma.
• Sistema operatiu. Sistema operatiu per al qual està dissenyat.
• Categoria. Directori o grup de microserveis en el qual s’allotjarà. Les categories s’han de predefinir a Organització.
• Eficiència. Quantitat de minuts que l’usuari estalvia amb cada execució.

4. Fer clic a Següent.

​

Fase 2 - Llicència

1. Triar entre les opcions desplegables el tipus de llicència que tindrà el microservei.
2. Fer clic a Següent.

​

Fase 3 - README

1. Introduir la descripció detallada del microservei en format Markdown.
2. Fer clic a Següent.

Per posar un títol amb Markdown simplement s’ha d’iniciar la línia amb # Títol. A continuació, alguns exemples de la seva sintaxi:

​

Fase 4 - Codi

1. Introduir el codi del microservei.
2. Fer clic a Següent per finalitzar.

Un cop completades les fases, el microservei apareixerà a la taula principal de la secció.

​

Consideracions tècniques

Si bé els microserveis permeten l’execució de qualsevol comanda CMD o PowerShell en dispositius Windows, les comandes enviades seran executades des de l’administrador local o des de la sessió d’usuari, depenent de l’àmbit que se’ls assigni. Això pot significar que alguns cmdlets no tinguin l’output esperat en relació amb l’execució realitzada. Per aquest motiu, si s’està desenvolupant un codi en PowerShell s’han de tenir en compte una sèrie de consideracions:

• Es recomana que la versió de PowerShell instal·lada als dispositius sigui la mateixa que s’utilitzi per desenvolupar els microserveis.
• L’execució dels microserveis es pot realitzar sota la identitat de sessió d’usuari o des de l’administrador local.
  • Execució des de l’administrador local. A Àmbit es pot configurar Workspaces o Plataforma, cosa que facilita molt interactuar amb els processos, serveis i actuar amb permisos administratius al dispositiu, però pot complicar accedir a informació específica de l’usuari o la seva sessió.
  • Execució des de sessió d’usuari. A Àmbit es pot configurar Sessions, cosa que és molt útil per accedir a informació de l’usuari com el registre, informació continguda al perfil, etc. S’ha de tenir en compte que l’script s’executarà amb el nivell de permisos que tingui l’usuari, per la qual cosa si l’usuari no és administrador local tindrà certes limitacions quan vulgui actuar a nivell de sistema.
• Quan es vulgui mostrar algun missatge a l’output del microservei, es recomana utilitzar el cmdlet Write-Output en lloc de Write-Host.
• L’output de l’execució es pot consultar a Operacions.

​

Habilitar un microservei

Per habilitar un microservei:

1. Accedir a Microserveis → Dissenyador.
2. Buscar el microservei al llistat i fer clic sobre ell.
3. Fer clic al botó Habilitar (situat a la part superior dreta).
4. Un cop habilitat, el microservei es mostrarà amb un punt verd a la secció Marketplace.

​

Eliminar un microservei

Abans d’eliminar un microservei, cal tenir en compte les condicions següents:

• Només és possible eliminar microserveis que hagin estat arxivats prèviament.
• El microservei no ha d’estar actiu a cap inquilí.
• No pot existir cap flux que el tingui assignat.

Un cop complerts aquests requisits, es pot procedir amb l’eliminació definitiva del microservei mitjançant els passos següents:

1. Accedir a Microserveis → Dissenyador.
2. A la taula de microserveis, triar l’element desitjat i fer clic a Accions → Arxivar.
3. Confirmar l’acció a la finestra emergent per completar l’arxivat.
4. Tornar a la taula i fer clic sobre el nom del microservei que s’acaba d’arxivar.
5. Des de la pestanya Visió general, fer clic al botó Eliminar.

6. Confirmar l’eliminació a la finestra emergent corresponent.