Propiedades

Se pueden configurar propiedades para cosas muy distintas, como componentes, entornos, procesos y aplicaciones. También puede definir propiedades globales para el sistema.

Las propiedades que tendrá a su disposición dependerán del contexto. Por ejemplo, en un proceso de componentes, podrá acceder a las propiedades de componente del componente actual. En un proceso de aplicaciones, podrá acceder a las propiedades de la aplicación y del entorno, pero no a las de todos los componentes. En la tabla siguiente se muestran los procesos en los que está disponible cada tipo de propiedad.

Para ver las propiedades que están disponibles para un proceso, ejecute el proceso. Cuando el proceso haya finalizado, vaya a la pestaña Propiedades de la solicitud de proceso. En esta pestaña, se enumeran todas las propiedades disponibles para el proceso.

La tabla siguiente lista los tipos de propiedades que están disponibles para los procesos y qué procesos tienen acceso a cada tipo de propiedad.
Tabla 1. Las propiedades y los procesos en los que están disponibles
Tipo de propiedad Procesos que pueden acceder a la propiedad Sintaxis de ejemplo
Propiedades de proceso genéricas Procesos genéricos ${p:ProcessProp1}
Propiedades del proceso de aplicaciones Procesos de aplicaciones y procesos de componentes ${p:ProcessProp1}
Propiedades de proceso de componentes Procesos de componentes ${p:componentProcess/ProcessProp1}
Propiedades de la versión del componente Tipos de procesos de componentes que incluyen versiones, como Despliegue y Operativo (con versión) ${p:version/VersionProp1}
Propiedades de recursos Todos los procesos ${p:resource/ResourceProp1}
Propiedades del entorno Procesos de componentes y procesos de aplicaciones ${p:environment/EnvProp1}
Propiedades de la aplicación Procesos de aplicaciones y procesos de componentes ${p:application/AppProp1}
Propiedades del sistema Todos los procesos ${p:system/SystemProp1}
Propiedades de solicitudes Todos los procesos
  • ${p:request.user.id}
  • ${p:request.user.name}
  • ${p:request.user.displayName}
Tabla 2. Contexto de propiedades
Contexto Descripción
environment

Disponible en la pestaña Propiedades del entorno o del componente.

Referencia: ${p:environment/propertyName}.

Ambas versiones utilizan la misma sintaxis. Un valor definido en el entorno del componente anula a otro con el mismo nombre definido directamente en una propiedad del entorno. Las propiedades del entorno del componente le ayudan a centralizar propiedades, rastreando, por ejemplo, los valores predeterminados y de tipo. Las propiedades del entorno proporcionan listas especiales de pares propiedad=valor.

resource Selecciona todas las propiedades con el mismo valor en un entorno.
resource role Selecciona todas las propiedades con el mismo valor en un recurso.
application

Disponible en la pestaña Propiedades de la aplicación (Aplicación > [aplicación seleccionada] > Propiedades).

Referencia: ${p:application/propertyName}.

component Selecciona todas las propiedades con el mismo valor de un sistema.
process

Disponible en la pestaña Propiedades de la aplicación (Aplicación > [aplicación seleccionada] > Propiedades).

Referencia: ${p:application/propertyName}.

Un paso de proceso tiene acceso a las propiedades definidas anteriormente por otros pasos del proceso, a las propiedades definidas mediante la aplicación que inició el proceso del componente y a las propiedades de recurso y el entorno de destino. Los valores de propiedades del paso se vuelven no disponibles después de que termine el proceso del componente.

Referencia: ${p:propertyName}.

system

Las propiedades del sistema (global) están disponibles en la pestaña Ajustes (Ajustes > Propiedades).

Referencia: ${p:system/propertyName}.

Tabla 3. Propiedades de IBM UrbanCode Deploy
Propiedad Descripción
version.name Un nombre definido por el usuario para distinguir la versión de otras versiones. Se introduce un nombre de versión cuando se importa una versión nueva.
version.id El número asignado a la versión. Se crea un identificador de versión cuando se importa una versión nueva en CodeStation.
component.name Un nombre de usuario definido para distinguirlo de otros componentes. Se introduce un nombre de componente cuando se crea un componente nuevo.
component.id Se asigna un número único IBM® UrbanCode Deploy para distinguir el componente de otros. El identificador de componente se crea cuando se crea un componente en IBM UrbanCode Deploy.
resource.name Un nombre definido por el usuario para distinguirlo de otros recursos. El nombre de recurso se introduce cuando se edita o se crea un recurso nuevo.
resource.id Un número único asignado a un recurso. se asigna un ID de recurso cuando se crea un recurso nuevo.
application.name Un nombre definido por el usuario para distinguirlo de otros. Se introduce un nombre de aplicación cuando se crea una aplicación nueva.
application.id Un número único asignado a una aplicación. Se asigna un ID de aplicación cuando se crea una aplicación nueva en IBM UrbanCode Deploy.
environment.name Un nombre definido por el usuario para distinguir el entorno de otros entornos. Se introduce un nombre de entorno cuando se crea o edita un entorno nuevo.
environment.id Un número único asignado a un entorno. se asigna un ID de entorno cuando se crea un entorno nuevo.
agent.id Se da un número único IBM UrbanCode Deploy al agente para distinguirlo de otros con nombres similares. Se asigna un ID de agente cuando se instala en el sistema.
agent.name Un nombre definido por el usuario para distinguir el agente de otros agentes. El nombre de agente puede introducirse editando el archivo conf/agent/installed.properties del agente y reiniciando el agente.
stepname, propertyname

Todos los pasos tienen las siguientes propiedades: exitCode, status, lines of interest (LOI, elementos que el script posterior al proceso encuentra en el registro de salida del paso).

Puede ver las propiedades utilizando el panel Registro del componente para examinar el registro de salida del paso (Componentes > [componente seleccionado] > [Ver acción solicitada] > [Acción propiedades de entrada/salida]).

El inventario y los estados de las versiones, definidos en la propiedad status, se puede utilizar en las puertas de aprobación de la aplicación (consulte Puertas de entorno). Los scripts de postprocesamiento pueden utilizar el resto de propiedades, consulteCreación de plug-ins.

Puede utilizar scripts de postprocesamiento para definir propiedades de salida que pueden utilizarse en otros pasos del mismo proceso, lo que habilita flujos de trabajo complejos. Haga referencia a las propiedades de salida del paso anterior del paso anterior:

${p:stepName/propName}

Para definir una propiedad de entorno desde un script de postprocesamiento, por ejemplo, defina la propiedad de salida del paso en el script de postprocesamiento. A continuación, utilice un paso Set Environment Property que consuma la propiedad de salida.

property_name Propiedad de proceso de aplicación o componente; definida en la pestaña Propiedades del proceso. valor dado por quien ejecuta el proceso.
component/nombre_propiedad Propiedad personalizada del componente; se define en la pestaña Propiedades del componente.
environment/nombre_propiedad Propiedad de entorno. Definida en la pestaña Propiedades del entorno o el componente. Aunque las dos utilizan la misma sintaxis, la última no está asociada a un componente específico. Los valores se suministran en el componente o entorno asociado. Un valor que se define en el entorno del componente anula a otro con el mismo nombre definido directamente en una propiedad del entorno.
resource/nombre_propiedad Propiedades de recurso. Estas propiedades pueden incluir las propiedades del agente incorporadas y cualquier propiedad personalizada. Cada una de estas propiedades cuenta con una pestaña en el recurso.
resource/nombre_rol/nombre_propiedad Propiedades del rol de recursos. Estas propiedades se definen en roles de recursos, y los valores de definen cuando añade un rol a un recurso.
application/nombre_propiedad Propiedades personalizadas de la aplicación. Estas propiedades se definen en las pestaña de propiedades de la aplicación.
system/nombre_propiedad Propiedades del sistema global. Estas propiedades se definen en la pestaña Propiedades del sistema en la zona Ajustes.

A continuación se proporcionan series separadas por coma de pares nombre=valor, incluyendo cada propiedad en el objeto. Esto resulta útil para las sustitución de señales.

Tabla 4. Pares nombre-valor
Propiedad Descripción
component/allProperties Selecciona todas las propiedades con el mismo valor en un componente.
environment/allProperties Selecciona todas las propiedades con el mismo valor en un entorno.
resource/allProperties Selecciona todas las propiedades con el mismo valor en un recurso.
system/allProperties Selecciona todas las propiedades con el mismo valor de un sistema.

Comentarios