Variables de configuración y variables del sistema

Al implementar una aplicación, suele ser necesario acceder a la configuración o a las opciones del sistema para su script. De esa manera no tendrá que codificar los valores en varias ubicaciones si los valores pueden cambiar en función de la configuración, compilación, servidor o versión. Para evitar tener que codificar valores, con Release Management para Visual Studio 2013 Update 4 puede usar variables de configuración o del sistema en sus scripts para versiones vNext.

Variables de configuración

Las variables de configuración proporcionan opciones de configuración reutilizables y personalizables que están disponibles durante la ejecución de la acción. Puede establecer variables de configuración y valores predeterminados en servidores, componentes y globalmente, y usar después esos valores en sus scripts de PowerShell y en sus scripts de configuración. Y si no quiere usar un valor predeterminado durante una implementación, puede invalidarlo. Un ejemplo del uso de variables de configuración es establecer el nombre de usuario y la contraseña utilizados para implementar su aplicación en el servidor.

Las variables de configuración se pueden establecer en los niveles global, de servidor, de componente y de acción.

• Variables de configuración globales: se establecen mediante Administración > Configuración > Variables de configuración. Disponibles en cualquier lugar.

• Variables de configuración de servidor: se establecen mediante Configurar rutas de acceso > Servidor, selección de un servidor, Variables de configuración. Disponible para acciones que implementan la aplicación en el servidor. Se usa para variables específicas del servidor, por ejemplo, UserName y Password.

• Variables de configuración de componente: se establecen mediante Configurar aplicaciones > Componente, selección de un componente, Variables de configuración. Disponible para acciones que usan el componente.

• Variables de configuración de acción: se establecen en el diseñador de plantillas de versión, disponible para las acciones.

Cuando se usa un nombre de variable de configuración en más de un nivel, el orden de prioridad de mayor a menor es Archivo de script de configuración > Acción > Componente > Servidor > Global.

Para administrar variables de configuración, en la esquina inferior izquierda de las vistas Plantillas de versión y Versiones hay pestañas llamadas Variables de configuración y Variables de recurso.

La pestaña Variables de configuración muestra las variables de configuración en vigor para la acción, para cada fase.

La pestaña Variables de recursos muestra las variables de configuración y los valores que se establecen globalmente, para servidores y para componentes. (Estos son valores actuales, no una instantánea de un momento anterior). Los cambios en las variables de recurso surtirán efecto en las versiones en vuelo que inician una nueva implementación.

Para agregar una variable de configuración dentro de una acción, en el diseñador de plantillas de versión, abra una actividad, haga clic en la flecha desplegable en la sección Configuración personalizada y especifique Estándar o Cifrado como tipo de variable de configuración. (Si usa Cifrado, asegúrese de que el agente de escucha HTTPS está configurado en el servidor donde implementa la aplicación).

Escriba el nombre de la nueva variable y proporcione su valor.

Para invalidar un valor en una variable de recurso, haga clic en el signo + y, después, haga clic en la flecha desplegable en la sección Configuración personalizada. Seleccione la variable para personalizar y proporcione un valor.

Variables del sistema

Además de las opciones de configuración, su script también podría necesitar acceder a la configuración del sistema. Por ejemplo, si su script necesita realizar una acción especial cuando implemente su aplicación en un entorno Production, el script puede examinar la variable Environment. Hay disponibles las siguientes variables del sistema:

• ApplicationPath Ruta de destino, incluido el nombre del componente, donde se copia el componente.

• ApplicationPathRoot Ruta de destino donde se copia el componente.

• BuildDefinition Definición de compilación para el componente.

• BuildDirectory Directorio de compilación para el componente.

• BuildNumber Número de compilación para el componente.

• Environment Entorno para la versión.

• PackageLocation Ruta de origen desde la que se copia el componente. Para las compilaciones enviadas a un servidor Standard, la ruta apunta a container-id. Para las compilaciones enviadas a Azure, la ruta apunta al GUID del blob de almacenamiento.

• ReleaseId ID de la versión; lo asigna Release Management.

• ReleaseNumber Número de la versión.

• Stage Fase de la versión.

• Tag Etiqueta usada para agrupar el servidor donde se ejecuta la acción.

• TeamProject Proyecto de equipo para el componente.

• TFSUrl Dirección URL de TFS del componente.

Si usa variables de configuración o del sistema en scripts, agregue un prefijo $ al nombre de la variable. Por ejemplo: $Stage.

Tenga en cuenta que un valor podría estar sin asignar. Por ejemplo, si va a implementar la aplicación en un servidor que no estaba agrupado por una etiqueta, el valor de la variable $Tag estará sin asignar.