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
- Accedir a
Portal
->Microserveis
->Dissenyador
. - Fer clic a
Nou
. - S'obrirà l'assistent que demanarà introduir la següent informació:
- 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ó.
- Fer clic a
Següent
.
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
- Triar entre les opcions desplegables el tipus de llicència que tindrà el microservei.
- Fer clic a
Següent
.
Fase 3 - README
- Inserir una descripció del microservei en format Markdown
- 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:
Ítem | Sintaxi Markdown | Previsualització |
---|---|---|
Negreta | **negreta** | negreta |
Cursiva | *cursiva* | cursiva |
Llista | - Element de llista | - Element de llista |
Enllaç | [text](url) | text |
Imatge |  | ![]() |
Codi | `codi` | codi |
::: |
Fase 4 - Script
- Introdueix l'script.
- 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 configurarWorkspaces
oPlataforma
, 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 configurarSessions
, 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ó.