Propriedades

As propriedades podem ser configuradas para várias coisas diferentes, incluindo componentes, ambientes, processos e aplicativos. Também é possível configurar propriedades globais para o sistema.

As propriedades que estão disponíveis para você dependem do contexto. Por exemplo, em um processo do componente, é possível acessar as propriedades do componente do componente atual. Em um processo de aplicativo, é possível acessar as propriedades do aplicativo e propriedades do ambiente, mas não as propriedades do componente. A tabela a seguir mostra os processos nos quais cada tipo de propriedade está disponível.

Para ver as propriedades que estão disponíveis para um processo, execute o processo. Quando o processo for concluído, acesse a guia Propriedades da solicitação de processo. Essa guia lista todas as propriedades que estão disponíveis para o processo.

A tabela a seguir lista os tipos de propriedades que estão disponíveis para processos e quais processos têm acesso a cada tipo de propriedade.
Tabela 1. As propriedades e os processos nos quais eles estão disponíveis
Tipo de propriedade Processos que podem acessar a propriedade Sintaxe de exemplo
Propriedades do processo genérico Processos genéricos ${p:ProcessProp1}
Propriedades do processo de aplicativo Processos de aplicativos e processos de componentes ${p:ProcessProp1}
Propriedades do processo do componente Processos de componentes ${p:componentProcess/ProcessProp1}
Propriedades da versão do componente Tipos de processos de componentes que incluem versões, como Implementação e Operacional (com versão) ${p:version/VersionProp1}
Propriedades do recurso Todos os processos ${p:resource/ResourceProp1}
Propriedades do ambiente Processos de componentes e processos de aplicativos ${p:environment/EnvProp1}
Propriedades do aplicativo Processos de aplicativos e processos de componentes ${p:application/AppProp1}
Propriedades do sistema Todos os processos ${p:system/SystemProp1}
Propriedades da solicitação Todos os processos
  • ${p:request.user.id}
  • ${p:request.user.name}
  • ${p:request.user.displayName}
Tabela 2. Contextos de propriedade
Contexto Descrição
ambiente

Disponível na guia Propriedades do componente ou do ambiente.

Referenciado: ${p:environment/propertyName}.

Ambas as versões usam a mesma sintaxe. Um valor que é configurado no ambiente do componente substitui um com o mesmo nome configurado diretamente em uma propriedade de ambiente. As propriedades do ambiente do componente ajudam a centralizar as propriedades, rastreando valores de tipo e padrão, por exemplo. Propriedades do ambiente fornecem listas ad hoc de pares propriedade=valor.

recurso Seleciona todas as propriedades com o mesmo valor em um ambiente.
função do recurso Seleciona todas as propriedades com o mesmo valor em um recurso.
aplicativo

Disponível na guia Propriedades do aplicativo (Aplicativo > [aplicativo selecionado] > Propriedades).

Referenciado: ${p:application/propertyName}.

componente Seleciona todas as propriedades com o mesmo valor em um sistema.
processo

Disponível na guia Propriedades do aplicativo (Aplicativo > [aplicativo selecionado] > Propriedades).

Referenciado: ${p:application/propertyName}.

Uma etapa do processo tem acesso às propriedades configuradas anteriormente por outras etapas no processo, para propriedades configuradas pelo aplicativo que iniciou o processo do componente e para propriedades no ambiente de destino e recurso. Os valores da propriedade de etapa se tornam indisponíveis após o processo do componente terminar.

Referenciado: ${p:propertyName}.

sistema

Propriedades do sistema (global) estão disponíveis na guia Configurações (Configurações > Propriedades).

Referenciado: ${p:system/propertyName}.

Tabela 3. Propriedades do IBM UrbanCode Deploy
Propriedade Descrição
version.name Um nome definido pelo usuário para distinguir a versão de outros. Um nome da versão é inserido quando uma nova versão é importada.
version.id O número que é designado à versão. Um ID de versão é criado quando uma nova versão é importada em CodeStation.
component.name Um nome definido pelo usuário para distingui-lo de outros componentes. Um nome do componente é inserido quando você cria um novo componente.
component.id Um número exclusivo que IBM® UrbanCode Deploy designa para distinguir o componente de outros. O ID de componente é criado quando um componente é criado em IBM UrbanCode Deploy.
resource.name Um nome definido pelo usuário para distingui-lo de outros recursos. O nome do recurso é inserido quando você edita ou cria um novo recurso.
resource.id Um número exclusivo que é dado a um recurso. Um ID do recurso é designado quando um novo recurso é criado.
application.name Um nome definido pelo usuário para distingui-lo de outros. Um nome de aplicativo é inserido quando você edita ou cria um novo aplicativo.
application.id Um número exclusivo que é dado a um aplicativo. Um ID do aplicativo é designado quando um novo aplicativo é criado no IBM UrbanCode Deploy.
environment.name Um nome definido pelo usuário para distinguir o ambiente de outros. Um nome do ambiente é inserido quando você edita ou cria um novo ambiente.
environment.id Um número exclusivo que é dado a um ambiente. Um ID do ambiente é designado quando um novo ambiente é criado.
agent.id Um número exclusivo que IBM UrbanCode Deploy fornece ao agente para distingui-lo de outros com nomes semelhantes. Um ID de agente é designado quando ele é instalado no sistema.
agent.name Um nome definido pelo usuário para distinguir o agente a partir de outros. O nome do agente pode ser inserido editando o arquivo conf/agent/installed.properties do agente e reiniciando o agente.
stepname, propertyname

Todas as etapas possuem as seguintes propriedades: exitCode, status, linhas de interesse (LOI, os itens que o script de pós-processamento localiza no log de saída da etapa).

É possível visualizar as propriedades usando as área de janela Log do componente para examinar o log de saída da etapa (Componentes > [componente selecionado] > [ação Visualizar Solicitação] > [ação Propriedades de Entrada/Saída]).

Status de inventário e de versões, que são definidos com a propriedade status, podem ser usados em portas aprovação de aplicativos (consulte Environment gates). As outras propriedades podem ser usadas pelos scripts de pós-processamento, consulte Criando plug-ins.

É possível usar scripts de pós-processamento para configurar propriedades de saída que podem ser usadas em outras etapas no mesmo processo, o que permite fluxos de trabalho complexos. Referencie propriedades de saída da etapa anterior desta maneira:

${p:stepName/propName}

Para configurar uma propriedade de ambiente a partir de um script de pós-processamento, por exemplo, você configura a propriedade de saída para a etapa no script de pós-processamento. Em seguida, você usa uma etapa Configurar propriedade do ambiente que consome a propriedade de saída.

property_name Propriedade do processo do componente ou aplicativo; definida na guia Propriedades do processo. Valor fornecido por quem quer que execute o processo.
component/property_name Propriedade customizada do componente; configurada na guia Propriedades do componente.
environment/property_name Propriedade do ambiente. Definida na guia Propriedades do ambiente ou do componente. Embora ambos utilizem a mesma sintaxe, o último não está associado a nenhum componente específico. Os valores são fornecidos no ambiente ou componente associado. Um valor que é configurado no ambiente do componente substitui um com o mesmo nome configurado diretamente em uma propriedade de ambiente.
resource/property_name Propriedades do recurso. Essas propriedades podem incluir as propriedades do agente integrado e quaisquer propriedades customizadas. Cada uma destas propriedades possui uma guia no recurso.
resource/role_name/property_name Propriedades de função do recurso. Essas propriedades são definidas em funções de recurso, e os valores são configurados quando você inclui uma função em um recurso.
application/property_name Propriedades customizadas do aplicativo. Essas propriedades são configuradas na guia de propriedades do aplicativo.
system/property_name Propriedades do sistema global. Essas propriedades são configuradas na guia Propriedades do Sistema na área Configurações.

Todos os itens a seguir são séries separadas por vírgula de pares de nome=valor, incluindo cada propriedade no objeto. Isso é útil para substituição de token.

Tabela 4. Pares nome-valor
Propriedade Descrição
component/allProperties Seleciona todas as propriedades com o mesmo valor em um componente.
environment/allProperties Seleciona todas as propriedades com o mesmo valor em um ambiente.
resource/allProperties Seleciona todas as propriedades com o mesmo valor em um recurso.
system/allProperties Seleciona todas as propriedades com o mesmo valor em um sistema.

Feedback