Acciones de creación de versiones para implementar una aplicación en Release Management
Agregue acciones de versión para definir la secuencia de implementación de cada fase de la producción de versiones. Cada acción emplea una herramienta específica para ejecutar un comando con un conjunto de argumentos.
Si no ha creado la ruta de inicio todavía, vaya aquí a hacerlo.
Arrastre una acción de versión desde el cuadro de herramientas para agregarla a la secuencia de implementación. Use cualquiera de las acciones de versión predefinidas que se muestran en el cuadro de herramientas o cree sus propias acciones de versión personalizadas.
.png "Pestaña Configurar aplicaciones, pestaña Plantillas de versión")
Después de agregar una acción de versión a la secuencia, puede editar las variables de configuración según sea necesario. Puede ver aquí más información sobre las acciones de versión predefinidas y sus variables de configuración. Averigüe sobre las herramientas utilizadas por acciones aquíde lanzamiento.
Agregar una acción de versión personalizada
Agregue una nueva acción de versión y elija la herramienta que desea que use esta acción. O bien, puede copiar una acción existente y usarla como base para crear una acción de versión personalizada. No puede editar una acción de versión existente.
Desde Release Management Client, abra la página Inventario. (Si la página no aparece, solicite el permiso Puede administrar el inventario).
Copie la acción que desea editar o agregue una nueva acción.
.png "Acción de copiar una versión")
Seleccione la herramienta que desea usar en función de los requisitos de la acción. Elija new para agregar dispone de la herramienta personalizada si herramientas predefinidas no puede hacer lo que necesita para ese paso en la secuencia de implementación.
En la sección Ejecución, especifique los argumentos obligatorios con sus tokens en el formato necesario. Debe agregar el prefijo y el sufijo __ a cada parámetro. Siempre que se eliminan o agregan argumentos con sus tokens, aparecen en la lista Parámetros.
Por ejemplo, agregue los siguientes argumentos con tokens: -servername __servername__ -switch __onoff__. Ahora, servername y onoff se muestran en la lista de parámetros.
Para desactivar una acción de versión
- Si hay acciones que no desea que el equipo use, desactívelas. Abra la acción en la página Inventario y elija el botón Desactivar.
Para reactivar una acción de versión
Abra la lista Inactivo, abra la acción y elija Activar.
.png "Lista inactiva en la página Inventario")
Preguntas y respuestas
.gif "Ff425471.collapse_all(es-es,VS.120).gif")
P: ¿Qué permisos necesito para editar acciones de versión?
R: Para editar o agregar acciones de versión, los usuarios deben disponer del permiso Puede administrar el inventario. Si el permiso no está habilitado, la página Inventario no se muestra.
Cuando se selecciona la opción Ninguna herramienta, los campos Comando y Argumentos no se pueden editar a menos que se tenga el permiso Puede usar la herramienta personalizada en acciones y componentes. En Configurar aplicaciones, Componentes, cuando un usuario no tiene el permiso Puede usar la herramienta personalizada en acciones y componentes, los campos Comando y Argumentos no se pueden editar cuando se selecciona la opción Ninguna herramienta.
Acciones y variables de configuración para las acciones de versión
Administrar grupos de aplicaciones y sitios web
Crear o modificar archivos .ini
Administrar bases de datos de SQL Server
Configurar servidores
Administrar servicios de Windows
Administrar grupos de aplicaciones y sitios web
Estas acciones emplean la herramienta predefinida IIS Deployer para administrar grupos de aplicaciones, sitios web, aplicaciones web y directorios virtuales. Estas acciones se admiten en IIS 7.0, 7.5, 8.0 y 8.5. Para obtener más información sobre esta herramienta, vaya aquí.
Acción |
Uso y condiciones de error de la implementación |
|---|---|
.png "espacio en blanco") |
Crear grupo de aplicaciones: esta acción crea un nuevo grupo de aplicaciones en IIS. Para IIS 7.0, 7.5, 8.0 y 8.5. Si el grupo de aplicaciones ya existe, se reconfigura para que coincida con los valores definidos en las variables de configuración (las variables de configuración no definidas no afectan a la configuración real del grupo de aplicaciones). En versiones de IIS anteriores a la 7.0, si el grupo de aplicaciones ya existe, se producirá un error en la implementación. Configurar grupo de aplicaciones, Reciclar grupo de aplicaciones, Iniciar grupo de aplicaciones o Detener grupo de aplicaciones: estas acciones reconfiguran, reciclan, inician o detienen un grupo de aplicaciones. Se produce un error en la implementación si el grupo de aplicaciones no existe. |
|
Crear sitio web: crea un nuevo sitio web en IIS. Para IIS 7.0, 7.5, 8.0 y 8.5. Si el sitio web ya existe, se reconfigura para que coincida con los valores definidos en las variables de configuración (las variables de configuración no definidas no afectan a la configuración real del sitio web). En versiones de IIS anteriores a la 7.0, si el grupo de aplicaciones ya existe, se producirá un error en la implementación. Configurar sitio web, Reiniciar sitio web, Iniciar sitio web, Detener sitio web: estas acciones reconfiguran, reinician, inician o detienen un sitio web. Se produce un error en la implementación si el sitio web no existe. |
|
Crear aplicación web: crea una nueva aplicación web en IIS. Para IIS 7.0, 7.5, 8.0 y 8.5. Si la aplicación web ya existe, se reconfigura para que coincida con los valores definidos en las variables de configuración (las variables de configuración no definidas no afectan a la configuración real de la aplicación web). En versiones de IIS anteriores a la 7.0, si el grupo de aplicaciones ya existe, se producirá un error en la implementación. Configurar aplicación web reconfigura una aplicación web. Se produce un error en la implementación si la aplicación web no existe. |
|
Crear directorio virtual: crea un directorio virtual en IIS. Para IIS 7.0, 7.5, 8.0 y 8.5. Si el directorio virtual ya existe, se reconfigurará para que coincida con los valores definidos en las variables de configuración (las variables de configuración no definidas no afectarán a la configuración real del directorio virtual). Configurar directorio virtual reconfigura un directorio virtual. Se produce un error en la implementación si el directorio virtual no existe. |
Variables de configuración
Parámetros |
Necesario |
Descripción |
|---|---|---|
AppPoolName |
Sí [acciones sobre grupos de aplicaciones] No [acciones sobre sitios web] |
Nombre del grupo de aplicaciones que se va a configurar, crear, reciclar, quitar, iniciar o detener. [Acción sobre grupos de aplicaciones] Nombre del grupo de aplicaciones que se va a usar para un sitio web nuevo o modificado. [Acción sobre sitios web] |
DotNetVersion |
No |
Versión de .NET Framework que se usará para el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.5, 8.0 y 8.5. Los valores permitidos son: v1.0, v1.1, v2.0 o v4.0. |
IdentityUserDomain |
No |
Dominio del usuario que se usará como identidad del grupo de aplicaciones. Si no se define este parámetro y se define “IdentityUserName”, se considera que se trata de un usuario local (es decir, .\localuser). |
IdentityUserName |
No |
Nombre de usuario que se usará como identidad del grupo de aplicaciones. Si no se define, se omiten los parámetros IdentityUserDomain e IdentityUserPassword y se usa el valor predeterminado de IIS (es decir, ApplicationPoolIdentity). |
IdentityUserPassword |
No |
Contraseña del usuario que se usará como identidad del grupo de aplicaciones. |
Is32BitsAllowed |
No |
Marca para permitir o impedir la ejecución de aplicaciones de 32 bits en el grupo de aplicaciones. Los valores permitidos son:
|
IsAutoStart |
No |
Marca que indica si el grupo de aplicaciones o el sitio web debe iniciarse automáticamente cuando se inicie Windows. Los valores permitidos son:
|
IsPreloadEnabled |
No |
Marca que indica si la funcionalidad de precarga está habilitada para un sitio web o una aplicación web. Los valores permitidos son:
|
PhysicalPath |
Sí [acción de creación] No [todas las demás acciones sobre directorios virtuales, sitios web y aplicaciones web] |
Ruta de acceso física completa del directorio virtual, el sitio web o la aplicación web. |
PipeLineMode |
No |
Modo de canalización administrada que se usará en el grupo de aplicaciones. Los valores permitidos son:
|
PortNumber |
Sí [solo acciones de creación] |
Número de puerto que se va a usar para un sitio web nuevo o modificado. |
ProcessIdleTimeOut |
No |
Número de minutos que un proceso puede estar inactivo en el grupo de aplicaciones. |
RecycleAfterMinutes |
No |
Número fijo de minutos después de los cuales se reciclará el grupo de aplicaciones. |
RecycleFixedTime |
No |
Hora fija a la que se reciclará el grupo de aplicaciones. El formato necesario es HH:MM; por ejemplo, 23:58 o 01:23. |
RecycleKbMemory |
No |
Número máximo de kilobytes de memoria que hay que usar antes de que se recicle el grupo de aplicaciones. |
SiteName |
Sí [acción sobre sitios web] No [acción sobre directorios virtuales] |
Nombre del sitio web que se va a crear, configurar, quitar, iniciar o detener. [Acción sobre sitios web] Nombre del sitio web en el que reside el directorio virtual. Si no se define, se usa el sitio web predeterminado. [Acción sobre directorios virtuales] |
StartMode |
No |
Modo de inicio que se va a usar para el grupo de aplicaciones. Los valores permitidos son:
|
VirtualDirectoryName |
Sí |
Nombre del directorio virtual que se va a crear, configurar o quitar. |
WebApplicationName |
No |
Nombre de la aplicación web en la que reside el directorio virtual. Si no se define, se usa la aplicación web raíz del sitio web. |
WebAppName |
Sí |
Nombre de la aplicación web que se va a configurar, crear o quitar. |
WebSiteName |
Sí [acción sobre sitios web] No [acción sobre aplicaciones web] |
Nombre del sitio web que se va a configurar, crear, quitar, iniciar o detener. [Acción sobre sitios web] Nombre del sitio web en el que reside la aplicación web. Si no se define, se usa el sitio web predeterminado. [Acción sobre aplicaciones web] |
Crear o modificar archivos .ini
Estas acciones de archivo .ini emplean la herramienta Administrador de archivos INI para agregar, modificar o quitar secciones y claves del archivo. Para obtener más información sobre esta herramienta, vaya aquí.
Acción |
Descripción |
|---|---|
Crear clave |
Crea una nueva clave con un valor en una sección concreta de un archivo .ini. Si el archivo especificado no existe, la acción lo crea. Si la sección especificada no existe, la acción la crea. Si la clave ya existe en la sección especificada, la acción reemplaza su valor. |
Modificar clave |
Modifica una clave existente con un nuevo valor en una sección concreta de un archivo .ini. Si el archivo especificado no existe, la acción lo crea. Si la sección especificada no existe, la acción la crea. Si la clave ya existe en la sección especificada, la acción la modifica. |
Modificar valor |
Modifica el valor de una clave existente en una sección concreta de un archivo .ini. Si el archivo especificado no existe, la acción lo crea. Si la sección especificada no existe, la acción la crea. Si la clave no existe en la sección especificada, la acción la agrega. |
Quitar clave |
Quita una clave y sus valores de una sección concreta de un archivo .ini. Si el archivo especificado no existe, se produce un error en la acción. La acción se realiza correctamente aunque la sección o la clave especificada no exista. Si especifica quitar todas las claves de una sección, la acción también quita la sección. |
Modificar sección |
Cambia el nombre de una sección dentro de un archivo .ini. Si el archivo especificado no existe, la acción lo crea. La acción se realiza correctamente aunque la sección especificada no exista. |
Quitar sección |
Quita una sección, y todas sus claves y valores, de un archivo .ini. Si el archivo especificado no existe, se produce un error en la acción. La acción se realiza correctamente aunque la sección especificada no exista. |
Variables de configuración
Parámetros |
Necesario |
Descripción |
|---|---|---|
INIFile |
Sí |
Nombre y ruta de acceso, según sea necesario, del archivo .ini que se va a modificar. |
KeyName |
Sí |
Nombre de la clave que se va a crear, modificar o quitar. |
KeyValue |
No |
Nuevo valor que se va a asignar a una clave. Si no se especifica este parámetro y se especifica NewKeyName, el sistema usa el valor real. Si no se especifica este parámetro y tampoco se especifica NewKeyName, se vacía el valor. |
NewKeyName |
No |
Nuevo nombre que se va a asignar a una clave. Si no se especifica, no se cambiará el nombre de la clave. |
NewSectionName |
No |
Nuevo nombre que se va a asignar a un nombre de sección. Si no se especifica, las claves de la antigua sección se pondrán en la sección raíz (se considera que todas las claves que están al principio del archivo antes de la primera sección están en la raíz). |
SectionName |
No |
[Acción de crear o modificar clave] Nombre de sección donde se va a agregar o modificar una clave. Si no se especifica, la acción actualiza la sección raíz. .gif "Nota") Nota
Se considera que están en la raíz todas las claves situadas al principio del archivo, antes de la primera sección.
[Acción de cambiar nombre] Sección cuyo nombre se va a cambiar. Si no se especifica, las claves de la antigua sección se colocan en la sección raíz. [Acción de quitar] Sección cuyo nombre se va a quitar. Si no se especifica, se quita la sección raíz. |
Administrar bases de datos de SQL Server
Estas acciones emplean la herramienta Implementador de bases de datos – Ejecutar script para crear, eliminar, hacer copia de seguridad y restaurar una base de datos de SQL Server. Para obtener más información sobre esta herramienta, vaya aquí.
Acciones |
Descripción |
|---|---|
Crear base de datos SQL |
Crea una nueva base de datos. Si la base de datos ya existe, se produce un error en la acción. |
Quitar base de datos SQL |
Elimina una base de datos. Si la base de datos no existe, se produce un error en la acción. |
Crear copia de seguridad de base de datos SQL |
Hace copia de seguridad de una base de datos existente en una ruta de acceso especificada. |
Restaurar base de datos SQL |
Restaura una base de datos desde un origen especificado. |
Variables de configuración
Parámetros |
Necesario |
Descripción |
|---|---|---|
DatabaseName |
Sí |
Nombre de la base de datos SQL Server que se va a crear, quitar, restaurar o de la que se va a hacer copia de seguridad. |
Path |
Sí |
Ruta de acceso y nombre de archivo que se va a usar para almacenar la copia de seguridad de la base de datos. Por ejemplo, \\servidor\nombreDeArchivo.bak. |
ServerName |
Sí |
Nombre del servidor donde se va a crear, hacer copia de seguridad, restaurar o quitar la base de datos SQL. |
Source |
Sí |
Ruta de acceso y nombre de archivo de la copia de seguridad de la base de datos que se va a usar para restaurar la base de datos. |
Configurar servidores
Estas acciones se pueden usar para configurar el equipo servidor si funciona con cualquier sistema operativo Windows. Puede ejecutar comandos y terminar procesos, así como administrar archivos, carpetas, variables de entorno, y valores y claves del Registro de Windows. El sistema ejecuta estas acciones mediante varias herramientas predefinidas de Release Management, incluidas Ejecutor de línea de comandos, Proceso de Windows e Implementador de XCOPY. Para obtener más información sobre estas herramientas, vaya aquí.
Acción |
Notas y condiciones de error de la implementación |
|---|---|
|
Use Ejecutar línea de comandos para ejecutar un comando mediante la identidad de Deployment Agent. Use Ejecutar línea de comandos como usuario para ejecutar un comando con determinadas credenciales de usuario. |
|
Estas acciones admiten crear, modificar y eliminar archivos y carpetas, y seleccionar atributos. Cuando se crean archivos o carpetas, también se crean los directorios principales que no existan de la carpeta que se va a crear. |
|
Estas acciones admiten crear, modificar y eliminar variables de entorno. |
|
Estas acciones admiten crear, modificar y eliminar claves y valores del Registro. Solo se produce un error en la secuencia de implementación cuando se intenta modificar una clave del Registro que no existe. |
Variables de configuración para ejecutar comandos o terminar un proceso
Parámetros |
Necesario |
Descripción |
|---|---|---|
Arguments |
No |
Argumentos necesarios para ejecutar la línea de comandos. |
command |
Sí |
Valor fijo ./WindowsProcess.ps1. |
FilePath |
No |
Dominio del usuario que se usará como identidad del grupo de aplicaciones. Si no se define este parámetro y se define IdentityUserName, se considera que se trata de un usuario local (es decir, .\localuser). |
IsKillProcessTree |
No |
Indica si se va a terminar el árbol de procesos. Los valores permitidos son:
|
ProcessName |
Sí |
Nombre del proceso de Windows que se va a terminar. |
UserDomain |
No |
Dominio del usuario que se va a usar para ejecutar el archivo ejecutable. Si no se especifica, se asigna .\localuser. |
UserName |
Sí [acción de ejecutar comando] No [acción de terminar proceso] |
Nombre del usuario que se va a usar para ejecutar el archivo ejecutable. Cuenta de usuario en la que se ejecuta el proceso. Si no se especifica, se terminará el proceso para todos los usuarios. |
UserPassword |
No |
Contraseña del usuario que se va a usar para ejecutar el archivo ejecutable. |
Variables de configuración para administrar archivos y carpetas
Parámetros |
Necesario |
Descripción |
|---|---|---|
Archive |
No |
Establece o restablece el atributo archive de los archivos o carpetas.
|
DestinationFileFolder |
Versión de .NET Framework que se usará para el grupo de aplicaciones. Este parámetro solo se permite para IIS 7.5, 8.0 y 8.5. Los valores permitidos son: v1.0, v1.1, v2.0 o v4.0. |
|
DestinationName |
Sí |
Ruta de acceso de destino donde se van a copiar o mover archivos o carpetas. O bien, nuevo nombre que se va a asignar al archivo o a la carpeta cuyo nombre se va a cambiar. |
FileFolderName |
Sí |
Archivos o carpeta de origen que se van a eliminar, modificar, mover o cambiar de nombre. Para la acción de eliminación, puede usar caracteres comodín; por ejemplo, c:, temp o *.log. |
FolderName |
Sí |
Nombre y ruta de acceso de la carpeta que se va a crear. |
Hidden |
No |
Establece o restablece el atributo hidden de los archivos o carpetas.
|
OwnerDomain |
No |
Dominio del nuevo propietario de los archivos o carpetas. Si no se especifica, se asigna .\localuser. |
OwnerDomain |
Sí |
Nombre del nuevo propietario de los archivos o carpetas. |
ReadOnly |
Establece o restablece el atributo de solo lectura de los archivos o carpetas.
|
|
SourceFileFolder |
Sí |
Archivos o carpetas de origen que se van a copiar. Puede usar caracteres comodín; por ejemplo, c:, temp o *.log. |
System |
Establece o restablece el atributo system de los archivos o carpetas.
|
Variables de configuración para las acciones de variable de entorno
Parámetros |
Necesario |
Descripción |
|---|---|---|
VariableName |
Sí |
Nombre de la variable que se va a crear, modificar o eliminar. |
VariableValue |
No |
Valor que se va a asignar a la variable agregada o modificada. Si no se establece ningún valor, se eliminará la variable. |
Variables de configuración para las acciones del Registro de Windows
Parámetros |
Necesario |
Descripción |
|---|---|---|
NewRegistryKey |
Sí |
Nombre completo de la clave del Registro de destino; por ejemplo, HKLM, Software o NUEVACLAVE. |
OperatingSystemType |
No |
Tipo de sistema operativo en el que se va a crear la clave del Registro. Los valores permitidos son:
|
RegistryData |
No |
Datos que van a afectar al valor del Registro. |
RegistryKey |
Sí |
Nombre completo de la clave del Registro que se va a crear, modificar o eliminar. Por ejemplo, HKLM, Software o NUEVACLAVE. |
RegistryValue |
Sí |
Nombre del valor del Registro que se va a agregar o modificar. |
ValueType |
No |
Tipo de datos del valor del Registro. Los valores permitidos son:
|
Administrar servicios de Windows
Estas acciones emplean la herramienta predefinida Administrador de servicios de Windows para crear, configurar, eliminar, reiniciar, iniciar y detener un servicio de Windows. Para obtener más información sobre esta herramienta, vaya aquí.
Acción |
Uso y condiciones de error de la implementación |
|---|---|
|
Use Crear servicio para crear un nuevo servicio. Se produce un error en la secuencia de implementación si el servicio ya existe. Use Configurar servicio para configurar un servicio existente. Se produce un error en la secuencia de la implementación si el servicio no existe. Use Configurar credenciales del servicio para configurar un servicio existente con nuevas credenciales. Se produce un error en la secuencia de la implementación si el servicio no existe. Además, se produce un error en la secuencia de implementación si el ServiceName indicado no existe cuando se especifica iniciar, detener o reiniciar un servicio. No se produce ningún error si el servicio ya está iniciado o detenido. |
Variables de configuración
Parámetros |
Necesario |
Descripción |
|---|---|---|
BinPath |
No |
Ruta de acceso y nombre binarios del servicio. |
Description |
Sí |
Descripción del servicio que se va a crear o configurar. |
DisplayName |
No |
Nombre del servicio que se va a crear o configurar. |
Password |
No |
Contraseña del nombre de usuario especificado para iniciar el servicio. |
ServiceName |
Sí |
Nombre del servicio que se va a crear, configurar, eliminar, reciclar, iniciar o detener. |
StartMode |
No |
Modo de inicio del servicio. Los valores permitidos son:
|
UserName |
Sí |
Nombre de usuario de las credenciales que se emplean para iniciar el servicio. Use el formato DOMINIO\USUARIO; por ejemplo, NT AUTHORITY\NETWORK SERVICE. Si especifica UserName, debe especificar también Password. Para restablecer las credenciales a la cuenta LocalSystem, especifique LocalSystem como usuario y "" como contraseña. |