Análisis de archivos de plantilla de clúster de CycleCloud

  • Artículo

CycleCloud puede resolver los valores de parámetro y realizar la evaluación lógica de las funciones.

Tipos de parámetros

CycleCloud controla varios tipos básicos de parámetros. En la mayoría de los casos, los controlará según lo previsto:

Attribute = foo      # string
Attribute = 1        # integer
Attribute = 1.1      # double
Attribute = false    # boolean
Attribute = foo, bar # string[]

Para ser más explícito, los valores de cadena se pueden rodear entre comillas dobles (por ejemplo, Attribute = "foo"). Esto puede ser útil en el caso de que un valor tenga un aspecto similar a un número, pero debe interpretarse como una cadena (números de versión, por ejemplo). Los valores booleanos se pueden establecer en los tokens true sin sistema operativo o false (sin distinción entre mayúsculas y minúsculas). Los valores separados por comas se interpretan como listas y, a su vez, los elementos se interpretan con las mismas reglas que anteriormente.

Evaluación de valores de parámetros

CycleCloud interpreta directamente los valores de parámetro que usan la $ notación o ${} .

MyAttribute = $MyParameter
MyAttribute2 = ${MyParameter2}
MyAttributeList = $Param1, $Param2

Funciones que usan parámetros

El analizador de plantillas de CycleCloud es capaz de realizar análisis matemáticos y de lógica ternaria, como se muestra a continuación.

MaxCoreCount = ${HyperthreadedCoreCount/2}
SubnetId = ${ifThenElse($Autoscale, $BurstSubnet, $FixedSubnet)}
JetpackPlatform = ${imageselect == "windows" ? "windows" : "centos-7"}

Funciones disponibles:

Nota

Esta lista no es completa, pero trata algunas de las funciones más usadas.

ifThenElse

Actúa como operador ternario. Devuelve uno de los dos valores dados una expresión que se evalúa como true o false.

Sintaxis:

ifThenElse(predicate, trueValue, falseValue)

Argumentos:

Nombre Obligatorio Descripción
predicate sí Expresión que se evalúa como true o false.
trueValue sí Valor que se va a usar cuando se evalúa como predicate true.
falseValue sí Valor que se va a usar cuando predicate se evalúa como false.

ifUndefined

Si el resultado de evaluar una expresión determinada no está definido, devuelve un valor diferente en su lugar. De lo contrario, simplemente devuelve el resultado.

Sintaxis:

ifUndefined(expression, value)

Argumentos:

Nombre Obligatorio Descripción
expresión sí La expresión que se va a evaluar.
value sí Valor que se va a devolver cuando expression se evalúa como indefinido.

regexp

Realiza una coincidencia de expresión regular en la cadena especificada y devuelve true si hay una coincidencia; de lo contrario, false.

Sintaxis:

regexp(pattern, target, [options])

Argumentos:

Nombre Obligatorio Descripción
pattern sí Expresión regular de estilo Java.
Destino sí Cadena de entrada.
opciones no Opciones que se usarán al evaluar la expresión regular. Para más información, consulte Marcas de expresiones java.util.regex.Pattern regulares de Java.

regexps

Realiza la sustitución de expresiones regulares en la cadena especificada y devuelve la nueva cadena.

Sintaxis:

regexps(pattern, target, substitution, [options])

Argumentos:

Nombre Obligatorio Descripción
pattern sí Expresión regular de estilo Java que coincide con la cadena que se va a sustituir.
Destino sí Cadena de entrada.
substitution sí Nueva cadena que se va a sustituir en lugar de la parte de target la que coincide con la expresión regular.
opciones no Opciones que se usarán al evaluar la expresión regular. Para más información, consulte Marcas de expresiones java.util.regex.Pattern regulares de Java.

tamaño

Devuelve la longitud de una cadena determinada.

Sintaxis:

size(string)

Argumentos:

Nombre Obligatorio Descripción
string sí Cadena que se va a comprobar.

strjoin

Concatena varias cadenas juntas mediante un separador.

Sintaxis:

strjoin(separator, strings)

Argumentos:

Nombre Obligatorio Descripción
separador sí Separador de cadena que se va a anexar entre cadenas.
cadenas sí Lista de cadenas que se van a concatenar. También se puede especificar como un número variable de argumentos de función: strjoin(separator, string1, string2, string3...)

substr

Devuelve parte de una cadena desde el índice inicial hasta el índice final (o el final de la cadena si no se da ningún índice final).

Sintaxis:

substr(string, startIndex, [endIndex])

Argumentos:

Nombre Obligatorio Descripción
string sí Cadena de entrada.
startIndex sí Índice de inicio que se va a usar.
endIndex no Índice final opcional.

trim

Quita todos los caracteres de espacio en blanco del inicio y el final de una cadena y devuelve el resultado.

Sintaxis:

trim(string)

Argumentos:

Nombre Obligatorio Descripción
string sí La cadena que se recortará.

Operadores disponibles

Operator Definición
-, +, /, * operaciones aritméticas
<, <=, >=, > Comparadores
==, != evaluadores de igualdad
&&, || operadores booleanos compuestos

Variable ClusterName especial

Una variable siempre proporcionada es ${ClusterName}. Esto se evalúa como el nombre del clúster de CycleCloud.

EmailAddress = ${strcat("myuser", "@", ClusterName)}
ResourceId = ${ClusterName}-00-resource

Tiempo relativo

CycleCloud interpreta las tics inversas en torno a la duración del tiempo como tiempo relativo; apoyo de segundo, minuto y día.

ThrottleCapacityTime=`10m` 
Attribute1=`30s`
Attribute2=`7d`