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.
| 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 |
|
| 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 (). Referenciado: ${p:application/propertyName}. |
| componente | Seleciona todas as propriedades com o mesmo valor em um sistema. |
| processo | Disponível na guia Propriedades do aplicativo (). 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 (). Referenciado: ${p:system/propertyName}. |
| 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 (). 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.
| 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. |