Diseñador
A través de la sección Diseñador se puede acceder a toda la información de los microservicios existentes, como el autor, el script, fechas de ejecución, problema que soluciona o tipo de licencia; pero, sobre todo, permite crear microservicios nuevos.
Creación de microservicios
Los microservicios se crean en cuatro fases:
Fase 1
- Acceder a
Portal
->Microservicios
->Diseñador
. - Hacer clic en
Nuevo
. - Se abrirá el asistente que pedirá introducir la siguiente información:
- Nombre. Nombre del microservicio.
- Color. Color del icono del microservicio.
- Icono. Tipo de icono del microservicio.
- Descripción. Breve texto que explica qué hace el microservicio.
- Lenguaje. Lenguaje de programación con el que está desarrollado.
- Versión. Número de versión del microservicio.
- Ámbito. Ámbito de ejecución. Se puede seleccionar Workspace (contexto Sistema o Sesión) o Plataforma.
- Sistema operativo. Sistema operativo para el que está diseñado.
- Categoría. Directorio o grupo de microservicios accesibles desde Workspaces en el que se alojará este microservicio.
- Eficiencia. Cantidad de minutos que ahorra el microservicio con cada ejecución.
- Hacer clic en
Siguiente
.
Si el microservicio será utilizado como microservicio de usuario final, el nombre del microservicio no debería contener caracteres especiales (como \ / : * ? " < > y otros caracteres específicos de idiomas para ciertas distribuciones de teclado).
Fase 2 - Licencia
- Elegir entre las opciones desplegables el tipo de licencia que tendrá el microservicio.
- Hacer clic en
Siguiente
.
Fase 3 - README
- Insertar una descripción del microservicio en formato Markdown
- Hacer clic en
Siguiente
.
Para poner un título con Markdown simplemente se debe iniciar la línea con # Título
. A continuación, algunos ejemplos de su sintaxis:
Elemento | Sintaxis Markdown | Previsualización |
---|---|---|
Negrita | **negrita** | negrita |
Cursiva | *cursiva* | cursiva |
Lista | - Elemento de lista | - Elemento de lista |
Enlace | [texto](url) | texto |
Imagen |  | ![]() |
Código | `código` | código |
Fase 4 - Script
- Introducir el script.
- Hacer clic en
Siguiente
.
El microservicio creado aparecerá en la tabla principal de la sección.
Código
Si bien los microservicios permiten la ejecución de cualquier comando CMD o PowerShell en dispositivos Windows, los comandos enviados serán ejecutados desde el administrador local o desde la sesión de usuario, dependiendo del ámbito que se les asigne. Esto puede significar que algunos cmdlets no tengan el output esperado con relación a la ejecución realizada. Por ese motivo, si se está realizando un script en PowerShell se debe tener en cuenta una serie de consideraciones:
-
Se recomienda que la versión de PowerShell instalada en los dispositivos sea la misma que la que se utilice para desarrollar los microservicios.
-
La ejecución de los microservicios puede realizarse bajo la identidad de sesión de usuario o desde el administrador local.
-
Ejecución desde el administrador local: en
Ámbito
se puede configurarWorkspaces
oPlataforma
, lo cual facilita mucho interactuar con los procesos, servicios y actuar con permisos administrativos en el dispositivo, pero puede complicar acceder a información específica del usuario o su sesión. -
Ejecución desde sesión de usuario: en
Ámbito
se puede configurarSesiones
, lo cual es muy útil para acceder a información del usuario como el registro, información contenida en el perfil, etc. Se debe tener en cuenta que el script se ejecutará con el nivel de permisos que tenga el usuario, por lo que si el usuario no es administrador local tendrá ciertas limitaciones cuando desee actuar a nivel de sistema.
-
-
Cuando se desee mostrar algún mensaje en el output del microservicio, se recomienda utilizar el cmdlet "Write-Output" en lugar de "Write-Host".
-
El output de la ejecución puede consultarse en los detalles del trabajo generado en la ejecución.