Tareas Servicios Windows para Azure DevOps

Resumen

Extensión diseñada para el uso en despliegues, ya que permitirá instalar uno o varios servicios windows en un servidor objetivo, permitiendo seleccionar diferentes opciones, como el tipo de inicio, si se instala o no con una cuenta personalizada, o hasta eliminar completamente los servicios.

Parámetros

A continuación se explican los diferentes parámetros que posee la tarea:

Parámetro	Descripción
Opción de instalación	Permite seleccionar si se instalará un servicio únicamente o una lista de servicios. Si se selecciona la opción Uno se deben ingresar los datos para ese servicio, como nombre, descripción, etc.; si se selecciona Varios se debe suministrar una lista en formato JSON con los servicios a instalar, explicada más adelante
Ambiente de instalación	Este es un parámetro no requerido y su función es identificar un nuevo servicio con respecto a los demás. Por ejemplo, se puede llegar a requerir que dos servicios iguales convivan en el mismo servidor, pero esto no es posible si llegaran a poseer el mismo nombre. Con este parámetro establecido, al servicio que se instale se le agregará lo que se coloque como identificador para poder instalarlo sin problemas. Si el servicio o servicios tienen como nombre ServiciosAlpha, con el este parámetro seteado, se concatenará quedando de la siguiente forma: ServicioAlpha_NombreAmbiente
Listado de servicios	Listado de servicios windows a instalar; la lista deberá ser suministrada en formato JSON, mismo que se detalla más adelante. Este parámetro solo es visible cuando se selecciona la opción Varios del parámetro Opción de instalación
Archivo ejecutable del servicio	Será el nombre exacto del archivo ejecutable con extensión .exe que se instalará como servicio. Debe contener la extensión .exe, de lo contrario, el despliegue fallará. Este parámetro solo será visible cuando se seleccione la opción Uno del parámetro Opción de instalación.
Nombre del servicio a instalar (Service Name)	Nombre del servicio windows a instalar. No debe llevar espacios en blanco ni caractéres especiales. Si al parámetro Ambiente de instalación se le asigna un valor, el proceso automáticamente concatenará su valor a este nombre. Este parámetro solo será visible cuando se seleccione la opción Uno del parámetro Opción de instalación.
Nombre del servicio para mostrar (Display Name)	Nombre del servicio para mostrar en la ventana de servicios windows en donde aparecen los demás instalados en el servidor. Este parámetro solo será visible cuando se seleccione la opción Uno del parámetro Opción de instalación.
Descripción del servicio	Descripción de la función que cumple el servicio windows. Este parámetro solo será visible cuando se seleccione la opción Uno del parámetro Opción de instalación.
Ruta del artefacto del servicio o servicios	Ruta en donde se ubica el artefacto con los archivos del o de los servicios a instalar
Ruta de instalación del servicio	Ruta en el servidor donde se colocarán los archivos del o de los servicios a instalar
Cuenta de instalación del o de los servicios	Cuenta del servicio con la cual se instalará. Si la opción seleccionada es Personalizada deberá aportar un usuario y contraseña válidos para el servidor. Si selecciona Cuenta local el servicio se instalará con la cuenta Local System
Cuenta del usuario	Visible solo cuando se selecciona la opción Personalizada del parámetro Cuenta de instalación. Cuenta de servicio para instalar el servicio; debe ser una cuenta de dominio o local en el servidor, que posea permisos para poder ejecutar el servicio
Contraseña del usuario	Visible solo cuando se selecciona la opción Personalizada del parámetro Cuenta de instalación. Contraseña de la cuenta correspondienter en el parámetro anterior
Tipo de inicio	Será el tipo de inicio del o de los servicios windows a instalar. En Automático los servicios tendrán este tipo de inicio cuando el servidor se reinicie y además los servicios instalados se iniciarán en el proceso. En Manual se instalarán con este tipo de inicio y no serán iniciados. Con la opción Deshabilitado seleccionada, los servicios se instalarán pero permanecerán desactivados
Otras configuraciones
Completa	Los servicios existentes serán detenidos y eliminados, volviendo a instalarlos e iniciarlos (dependiendo de su tipo de inicio)
Detener y eliminar	Los servicios existentes serán detenidos y eliminados. El contenido de los servicios como sus archivos .exe y demás, seguirán existiendo en el servidor
Eliminar todo	Los servicios existentes serán detenidos y eliminados, borrando también los archivos físicos en el servidor de dichos servicios

Formato JSON del parámetro

A continuación se detalla el formato que debe utilizarse en el JSON para el parámetro Listado de servicios:

{
	"servicios": [
		{
			"name": "SERVICE_NAME",
			"displayname": "DISPLAY_NAME",
			"description": "DESCRIPTION",
			"exepath": "EXECUTABLE_FILE"
		},
		{
			"name": "SERVICE_NAME",
			"displayname": "DISPLAY_NAME",
			"description": "DESCRIPTION",
			"exepath": "EXECUTABLE_FILE"
		}
	]
}

El anterior, es el formato básico para los servicios, pero pueden agregarse al menos cuatro parámetros más de manera opcional si así se desea, los cuales serán el tipo de inicio para el servicio, el tipo de usuario, un usuario y contraseña para instalarlo si el tipo de usuario fuera CUSTOM. Estos cuatro parámetros sobreescribirán los valores colocados en los parámetros de la tarea. El formato deberá quedar de la siguiente manera si se agregan los parámetros:

{
	"servicios": [
		{
			"name": "SERVICE_NAME",
			"displayname": "DISPLAY_NAME",
			"description": "DESCRIPTION",
			"exepath": "EXECUTABLE_FILE (.EXE)",
			"startuptype": "AUTOMATIC / MANUAL / DISABLED",
			"usertype": "CUSTOM / LOCAL",
			"username": "USUARIO_SERVICIO",
			"password": "CONTRASEÑA_USUARIO_SERVICIO"
		},
		{
			"name": "SERVICE_NAME",
			"displayname": "DISPLAY_NAME",
			"description": "DESCRIPTION",
			"exepath": "EXECUTABLE_FILE (.EXE)",
			"startuptype": "AUTOMATIC / MANUAL / DISABLED",
			"usertype": "CUSTOM / LOCAL",
			"username": "USUARIO_SERVICIO",
			"password": "CONTRASEÑA_USUARIO_SERVICIO"
		}
	]
}

No colocar el JSON tal cual se explicó anteriormete, ocasionará que la tarea falle ya que las propiedades deben coincidir tal cual se colocaron.

Notas de versiones

0.35.0 - Despliegue inicial

Contribuciones

Sientase libre de reportar cualquier problema, sugerencia o nueva caracteristica que desee agregar a la tarea, al correo josejaviercl@hotmail.com.

Tareas Servicios Windows