Análise de Ficheiros de Modelo de Cluster do CycleCloud
O CycleCloud consegue resolver valores de parâmetros e realizar uma avaliação lógica das funções.
Tipos de Parâmetro
O CycleCloud processa vários tipos básicos de parâmetros. Na maioria dos casos, irá processá-los conforme esperado:
Attribute = foo # string
Attribute = 1 # integer
Attribute = 1.1 # double
Attribute = false # boolean
Attribute = foo, bar # string[]
Para ser mais explícito, os valores de cadeia podem estar entre aspas duplas (por exemplo, Attribute = "foo"). Isto pode ser útil no caso de um valor parecer um número, mas deve ser interpretado como uma cadeia (números de versão, por exemplo). Os valores booleanos podem ser definidos como tokens simples ou (não sensíveis a maiúsculas e false minúsculastrue). Os valores separados por vírgulas são interpretados como listas e os elementos são, por sua vez, interpretados com as mesmas regras acima.
Avaliação do Valor do Parâmetro
O CycleCloud interpreta diretamente os valores dos parâmetros que utilizam a $ notação ou ${} .
MyAttribute = $MyParameter
MyAttribute2 = ${MyParameter2}
MyAttributeList = $Param1, $Param2
Funções com Parâmetros
O analisador de modelos do CycleCloud é capaz de efetuar análises matemáticas e lógica ternary, como se pode ver abaixo.
MaxCoreCount = ${HyperthreadedCoreCount/2}
SubnetId = ${ifThenElse($Autoscale, $BurstSubnet, $FixedSubnet)}
JetpackPlatform = ${imageselect == "windows" ? "windows" : "centos-7"}
Funções disponíveis:
Nota
Esta lista não é abrangente, mas abrange algumas das funções mais utilizadas.
ifThenElse
Atua como um operador ternary. Devolve um de dois valores, tendo em conta uma expressão que é avaliada como verdadeira ou falsa.
Sintaxe:
ifThenElse(predicate, trueValue, falseValue)
Argumentos:
| Name | Necessário | Descrição |
|---|---|---|
| predicado | sim | Uma expressão que avalia como verdadeira ou falsa. |
| trueValue | sim | O valor a utilizar quando predicate avaliado como verdadeiro. |
| falseValue | sim | O valor a utilizar quando predicate avaliado como falso. |
ifUndefined
Se o resultado da avaliação de uma determinada expressão for indefinido, devolve um valor diferente. Caso contrário, devolve simplesmente o resultado.
Sintaxe:
ifUndefined(expression, value)
Argumentos:
| Name | Necessário | Descrição |
|---|---|---|
| expression | sim | A expressão a avaliar. |
| valor | sim | O valor a devolver quando expression avaliado como indefinido. |
regexp
Executa uma correspondência de expressão regular na cadeia especificada e devolve true se existir uma correspondência, caso contrário, falso.
Sintaxe:
regexp(pattern, target, [options])
Argumentos:
| Name | Necessário | Descrição |
|---|---|---|
| padrão | sim | Uma expressão normal de estilo Java. |
| destino | sim | A cadeia de entrada. |
| opções | não | Opções a utilizar ao avaliar a expressão regular. Veja os sinalizadores de expressão regulares do Java ativados java.util.regex.Pattern para obter mais detalhes. |
regexps
Efetua a substituição regular de expressões na cadeia especificada e devolve a nova cadeia.
Sintaxe:
regexps(pattern, target, substitution, [options])
Argumentos:
| Name | Necessário | Descrição |
|---|---|---|
| padrão | sim | Uma expressão regular de estilo Java que corresponde à cadeia a substituir. |
| destino | sim | A cadeia de entrada. |
| substituição | sim | A nova cadeia de carateres a substituir em vez da parte da target qual corresponde à expressão regular. |
| opções | não | Opções a utilizar ao avaliar a expressão regular. Veja os sinalizadores de expressão regulares do Java ativados java.util.regex.Pattern para obter mais detalhes. |
size
Devolve o comprimento de uma determinada cadeia.
Sintaxe:
size(string)
Argumentos:
| Name | Necessário | Description |
|---|---|---|
| cadeia (de carateres) | sim | A cadeia a verificar. |
strjoin
Concatena múltiplas cadeias de carateres em conjunto com um separador.
Sintaxe:
strjoin(separator, strings)
Argumentos:
| Name | Necessário | Descrição |
|---|---|---|
| separador | sim | Um separador de cadeia para acrescentar entre cadeias. |
| cadeias | sim | Uma lista de cadeias a concatenar. Também pode ser especificado como um número variável de argumentos de função: strjoin(separator, string1, string2, string3...) |
subcadeia
Devolve parte de uma cadeia do índice inicial para o índice final (ou o fim da cadeia se não for fornecido nenhum índice final).
Sintaxe:
substr(string, startIndex, [endIndex])
Argumentos:
| Name | Necessário | Description |
|---|---|---|
| cadeia (de carateres) | sim | A cadeia de entrada. |
| startIndex | sim | O índice de início a utilizar. |
| endIndex | não | Um índice final opcional. |
cortar
Remove todos os carateres de espaço em branco do início e fim de uma cadeia e devolve o resultado.
Sintaxe:
trim(string)
Argumentos:
| Name | Necessário | Description |
|---|---|---|
| cadeia (de carateres) | sim | A cadeia a cortar. |
Operadores disponíveis
| Operador | Definição |
|---|---|
| -, +, /, * | aritmética |
| <, <=, >=, > | comparadores |
| ==, != | avaliadores de igualdade |
| &&, || | operadores booleanos compostos |
Variável De ClusterName Especial
Uma variável sempre fornecida é ${ClusterName}. Isto é avaliado com o nome do cluster CycleCloud.
EmailAddress = ${strcat("myuser", "@", ClusterName)}
ResourceId = ${ClusterName}-00-resource
Hora Relativa
O CycleCloud interpreta os tiques pendentes em torno da duração do tempo como tempo relativo; suportando segundo, minuto e dia.
ThrottleCapacityTime=`10m`
Attribute1=`30s`
Attribute2=`7d`