Como usar expressões no Cloud Provisioning and Governance
As expressões em ações de política podem definir ou substituir valores. As expressões em planos gráficos podem acessar atributos de recursos e mapear valores para campos de formulário de solicitação. As expressões estão disponíveis em blocos de recursos, planos gráficos, políticas e em qualquer lugar que Cloud Provisioning and Governance permita scripts.
Como usar expressões
As expressões podem conter os valores das informações geradas dinamicamente no sistema, como os valores das seleções que os usuários fazem no Portal de usuário da nuvem. As expressões estão disponíveis em blocos de recursos, planos gráficos, políticas e em qualquer lugar que Cloud Provisioning and Governance permita scripts.
- Como usar expressões em blocos de recursos
Cada operação de bloco de recursos usa uma expressão para conter um valor para cada parâmetro. A expressão pode usar valores codificados, dados da pilha que o usuário provisiona no Portal de usuário da nuvem, dados no CMDB e dados derivados de scripts. Por padrão, Cloud Provisioning and Governance gera um conjunto de parâmetros e suas expressões para cada operação de bloco de recursos.
Por exemplo, o parâmetro Location, que contém o datacenter ao qual um recurso pertence, usa a expressão
${parameter.Location}Figura 1. Expressões em um bloco de recursos - Como usar expressões em planos gráficos
Os planos gráficos podem usar expressões para mapear parâmetros de entrada para cada operação em um bloco de recursos. Por padrão, o plano gráfico exibe os mesmos parâmetros e valores especificados no bloco de recursos.
Você pode acessar atributos de plano gráfico com expressões. A expressão na coluna Mapeamento define atributos de plano gráfico para cada operação em uma etapa. Por exemplo, o atributo Local, que aparece no formulário de solicitação de pilha, pode ser acessado por meio da expressão
{$parameter.Location}. O parâmetro Local com ovalor ${parameter.Location}aparece na guia Entradas quando você seleciona uma operação de plano gráfico.Figura 2. Expressões em um plano gráfico - Como usar expressões em ações de política
As ações de política podem usar expressões para substituir valores de parâmetro que os usuários enviam em um formulário de solicitação no Portal de usuário da nuvem. Você também pode acessar e substituir dados do usuário em operações de pilha. Por exemplo, use a seguinte expressão para renomear uma pilha:
formData.Stackname = "your-naming-convention";.Figura 3. Expressões em um script de política
Você pode acessar atributos de plano gráfico com expressões. A expressão na coluna Mapeamento define atributos de plano gráfico para cada operação em uma etapa. Por exemplo, o atributo Local, que aparece no formulário de solicitação de uma máquina virtual, é acessado na seguinte expressão: {$parameter.Location}.
Tipos de expressão
- Expressões de definição
- As expressões de definição são uma forma de vinculação antecipada (ou vinculação estática). Essas vinculações se referem à vinculação de tempo de compilação e são avaliadas quando o usuário envia o formulário de solicitação de pilha (quando o provisionamento de pilha ou de recursos é iniciado). As expressões de definição não têm acesso aos dados gerados durante Orquestração. As expressões de definição são colocadas entre chaves. Por exemplo:
${parameter.CloudAccount} - Expressões de tempo de execução
- As expressões de tempo de execução são uma forma de vinculação atrasada (ou vinculação dinâmica). Essas vinculações se referem à vinculação de tempo de execução e têm acesso aos dados criados durante Orquestração (por exemplo, empilhar itens). As expressões de tempo de execução são avaliadas quando chamadas durante uma execução de Orquestração. As expressões de tempo de execução são normalmente usadas para referência com pontos para dados em tabelas. As expressões de tempo de execução são colocadas entre parênteses. Por exemplo:
$(Stack.items[VM1].attributes[node_id]) - Expressões de definição/tempo de execução
- Algumas expressões incluem expressões de definição e de tempo de execução.
- Expressões complexas
- Você pode aninhar expressões de qualquer tipo em outras expressões.
Sintaxe e exemplos de expressão de definição
${parameter.}. Use este tipo de expressão para recuperar valores de atributos de entrada de processos, como provisões de planos gráficos. Os dados não são obtidos das tabelas.${Stack.items[]}. Use esta sintaxe para acessar atributos de itens específicos em uma pilha.${randomNumber}. Use esta sintaxe para gerar um número aleatório. Por exemplo, você pode provisionar uma VM com um nome de nó aleatório ou nome de pilha.
| Exemplo | Descrição |
|---|---|
| ${parâmetro.CódigoDeCobrança} | Esta expressão mostra como um parâmetro de código de cobrança aparece em um plano gráfico. |
| ${parameter.formData.CatalogAttributeType} | Esta expressão usa um atributo de catálogo que é enviado por um usuário enquanto o usuário preenche o formulário para um item do catálogo no Portal de usuário da nuvem. |
| ${parameter.userData.userId} | Esta expressão usa o ID de um usuário enquanto o usuário preenche o formulário de um item do catálogo no Portal de usuário da nuvem. |
| ${Stack.items[Virtual Server].attributes[sys_id]} | Esta expressão obtém o sys_id de um servidor virtual que está separado de uma pilha. Servidor virtual é o alias de um bloco de recursos usado na pilha. |
Sintaxe e exemplos de expressões de tempo de execução
$(ci.tablename)em quetablenameé uma tabela no sistema, geralmente uma tabela de IC no CMDB. Use esta sintaxe para acessar valores de campos na tabela.$(Stack.items[]). Use esta sintaxe para acessar atributos de itens específicos em uma pilha.
| Exemplo | Descrição |
|---|---|
$(ci.cmdb_ci_cloud_subnet[ sys_id=12231231231231231231].cidr) |
Este ponto de expressão vai até a tabela Sub-rede em nuvem, encontra o registro específico com o sys_id fornecido e obtém o valor da coluna cidr. |
$(ci.sn_cmp _ip_pool[subnet=${parameter.formData.Subnet Id}]) |
Esta expressão combina expressões de tempo de execução e de tipo de definição. O sinal de igual = é usado para avaliar um valor para uma correspondência. A expressão faz referência com pontos até a tabela de Pool de IPs e procura a sub-rede que tem o ID de sub-rede que o usuário enviou. |
$(ci.cmdb_ci_cloud_subnet[${parameter.formData.SubnetId}].cidr) |
Esta expressão combina expressões de tempo de execução e de tipo de definição. A expressão obtém o valor do campo cidr de uma sub-rede que o usuário escolheu durante o provisionamento. Os colchetes [] indicam que a expressão faz referência com pontos até a tabela Sub-rede em nuvem e, em seguida, verifica o valor da sub-rede que o usuário enviou em um provisionamento de plano gráfico. A expressão obtém o valor do campo cidr e vai até o valor no campo cidr do sys_id da sub-rede. |
| $(Stack.items[Servidor virtual].attributes[sys_id]) | Como no exemplo de expressão de definição, esta expressão usa o sys_id de um servidor virtual que está separado de uma pilha. |
Exemplo de expressão
$(ci.cmdb_ci_nic[$(Script:CMPVMNICs.getNICs[arg=$(Stack.items[Virtual Server].attributes[sys_id])])].private_ip) - $(ci: expressão de tempo de execução para recuperar dados da tabela.
- cmdb_ci_nic: IC para NIC (Placa de Interface de Rede).
- $(Script: Expressão baseada em script.
- CMPVMNICs: Inclusão de script.
- getNICs: função dentro de uma inclusão de script.
- arg: argumentos para a função de inclusão de script. Os argumentos são separados por "," quando há vários atributos.
- $(Stack.items: Expressão de pilha de tempo de execução para recuperar item de pilha de uma pilha. O argumento é o alias especificado no plano gráfico.
- Virtual Server: alias do recurso usado no plano gráfico.
- $(Stack.items[Virtual Server].attributes[sys_id]): Recupere o sys_id da instância de recurso do item de pilha ("Servidor virtual") em uma pilha.
- private_ip: Atributo de cmdb_ci_nic. Substitua pelo IP público, se necessário.
Expressões
Simple parameter mapping expression Este tipo de expressão recupera valores de atributos de entrada de processos, como operações de plano gráfico, blocos de recursos e políticas. Os dados não são obtidos das tabelas. Mapeia valores de uma camada para outra, como de um plano gráfico para um recurso para a API de nuvem.
|
Stack item expression Uma instância de IC no CMDB representa cada item de pilha. Use expressões de item de pilha para pesquisar propriedades de primeiro nível no IC que apóia o item de pilha ou no próprio item de pilha.
|
Property override expressions in policies Nas políticas, você pode substituir as propriedades extraindo um valor do sistema ou usando um número aleatório. Você pode usar dados dos formulários no Portal de usuário da nuvem e do usuário que realizou a operação no formulário.
|
Script expression No exemplo,
|
CI lookup expression Acessa valores de campos em uma tabela, geralmente uma tabela de IC no CMDB.
|
Random number expression Gera um número aleatório. Por exemplo, você pode provisionar uma VM com um nome de nó aleatório ou nome de pilha.
|
Scratchpad expression/Resource operation output attribute expression Lê atributos de saída de uma operação para outra.
|
Conditions in expressions Você pode usar expressões condicionais em etapas de plano gráfico e etapas de operação de recursos para executar condicionalmente ou ignorar a etapa. As expressões condicionais são expressões Javascript e oferecem suporte a substituições de expressão.
|
Complex expression Você pode aninhar expressões. No exemplo,
|
Order context Esta expressão é útil para operações de ciclo de vida e permite que você faça referência com pontos nos atributos de pedido como parte da tabela sn_cmp_order.
|