Saltar al contingut principal
Versió: 25.4

Dissenyador

A través de la secció Dissenyador es pot accedir a tota la informació dels microserveis existents, com l'autor, l'script, dates d'execució, problema que soluciona o tipus de llicència; però, sobretot, permet crear microserveis nous.

Creació de microserveis

Els microserveis es creen en quatre fases:

Fase 1

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

ms_creation

  • Nom. Nom del microservei.
  • Color. Color de la icona del microservei.
  • Icona. Tipus d'icona del microservei.
  • Descripció. Breu text que explica què fa el microservei.
  • Llenguatge. Llenguatge de programació amb el qual està desenvolupat.
  • Versió. Nombre de versió del microservei.
  • À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 accessibles des de Workspaces en el qual s'allotjarà aquest microservei.
  • Eficiència. Quantitat de minuts que estalvia el microservei amb cada execució.
  1. Fer clic a Següent.
info

Si el microservei serà utilitzat com a microservei d'usuari final, el nom del microservei no hauria de contenir caràcters especials (com \ / : * ? " < > i altres caràcters específics d'idiomes per a certes distribucions de teclat).

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.

ms_license

Fase 3 - README

  1. Inserir una descripció del microservei en format Markdown
  2. Fer clic a Següent.
info

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:

ÍtemSintaxi MarkdownPrevisualització
Negreta**negreta**negreta
Cursiva*cursiva*cursiva
Llista- Element de llista- Element de llista
Enllaç[text](url)text
Imatge![alt](url)ev
Codi`codi`codi
:::

Fase 4 - Script

  1. Introdueix l'script.
  2. Fer clic a Següent.

El microservei creat apareixerà a la taula principal de la secció.

Codi

Tot i que els microserveis permeten l'execució de qualsevol comandament CMD o PowerShell en dispositius Windows, els comandaments enviats seran executats 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 el resultat esperat en relació amb l'execució realitzada. Per aquest motiu, si s'està realitzant un script a PowerShell s'ha de tenir en compte una sèrie de consideracions:

  • Es recomana que la versió de PowerShell instal·lada en els dispositius sigui la mateixa que s'utilitzi per desenvolupar els microserveis.

  • L'execució dels microserveis pot realitzar-se sota la identitat de sessió d'usuari o des de l'administrador local.

    • Execució des de l'administrador local: en Àmbit es pot configurar Workspaces o Plataforma, cosa que facilita molt interactuar amb els processos, serveis i actuar amb permisos administratius en el dispositiu, però pot complicar accedir a informació específica de l'usuari o la seva sessió.

    • Execució des de sessió d'usuari: en Àmbit es pot configurar Sessions, cosa que és molt útil per accedir a informació de l'usuari com el registre, informació continguda en el perfil, etc. Cal 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 en el resultat del microservei, es recomana utilitzar el cmdlet "Write-Output" en lloc de "Write-Host".

  • El resultat de l'execució es pot consultar en els detalls del treball generat en l'execució.