Use operadores de comparação em documentos de AWSTOE componentes - EC2Image Builder
Compare sequências de caracteresCompare númerosVerifique os arquivos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Use operadores de comparação em documentos de AWSTOE componentes

Você pode usar os seguintes operadores de comparação com o módulo de Afirmar ação e com expressões condicionais que usam o. se Construir Um operador de comparação pode operar em um único valor, por exemplostringIsEmpty, ou pode comparar um valor de linha de base com um segundo valor (valor variável) para determinar se a expressão condicional é avaliada como ou. true false

Se a comparação operar em dois valores, o segundo valor pode ser uma variável de encadeamento.

Ao comparar valores de um tipo diferente, as seguintes conversões de valor podem ocorrer antes da comparação:

  • Para comparações numéricas, se o valor da variável for uma string, AWSTOE converte a string em um número antes da avaliação. Se a conversão não for possível, a comparação será retornadafalse. Por exemplo, se o valor da variável for"1.0", a conversão funcionará, mas se o valor da variável for, "a10" a conversão falhará.

  • Para comparações de strings, se o valor da variável for um número, AWSTOE converte-o em uma string antes da avaliação.

Compare sequências de caracteres

Os operadores de comparação a seguir funcionam com cadeias de caracteres para comparar valores, testar espaços ou uma string vazia ou comparar um valor de entrada com um padrão regex. As comparações de strings não diferenciam maiúsculas de minúsculas e não reduzem os espaços do início ou do final das entradas da string.

Operadores de comparação de strings
stringIsEmpty

O stringIsEmpty operador retornará true se a string especificada não contiver nenhum caractere. Por exemplo:

# Evaluates to true
stringIsEmpty: ""

# Evaluates to false
stringIsEmpty: " "
				
# Evaluates to false
stringIsEmpty: "Hello."
stringIsWhitespace

Testa se a string especificada para stringIsWhitespace contém somente espaços. Por exemplo:

# Evaluates to true
stringIsWhitespace: "   "

# Evaluates to false
stringIsWhitespace: ""
				
# Evaluates to false
stringIsWhitespace: " Hello?"
stringEquals

Testa se a string especificada para stringEquals é uma correspondência exata para a string especificada no value parâmetro. Por exemplo:

# Evaluates to true
stringEquals: 'Testing, testing...'
value: 'Testing, testing...'

# Evaluates to false
stringEquals: 'Testing, testing...'
value: 'Hello again.'

# Evaluates to false
stringEquals: 'Testing, testing...'
value: 'TESTING, TESTING....'

# Evaluates to false
stringEquals: 'Testing, testing...'
value: '   Testing, testing...'
				
# Evaluates to false
stringEquals: 'Testing, testing...'
value: 'Testing, testing...   '
stringLessThan

Testa se a string especificada para stringLessThan é menor que a string especificada no value parâmetro. Por exemplo:

# Evaluates to true
# This comparison operator isn't case sensitive
stringlessThan: 'A'
value: 'a'

# Evaluates to true - 'a' is less than 'b'
stringlessThan: 'b'
value: 'a'

# Evaluates to true
# Numeric strings compare as less than alphabetic strings
stringlessThan: 'a'
value: '0'

# Evaluates to false
stringlessThan: '0'
value: 'a'
stringLessThanIgual

Testa se a string especificada para stringLessThanEquals é menor ou igual à string especificada no value parâmetro. Por exemplo:

# Evaluates to true - 'a' is equal to 'a'
stringLessThanEquals: 'a'
value: 'a'

# Evaluates to true - since the comparison isn't case sensitive, 'a' is equal to 'A'
stringLessThanEquals: 'A'
value: 'a'

# Evaluates to true - 'a' is less than 'b'
stringLessThanEquals: 'b'
value: 'a'

# Evaluates to true - '0' is less than 'a'
stringLessThanEquals: 'a'
value: '0'

# Evaluates to false - 'a' is greater than '0'
stringLessThanEquals: '0'
value: 'a'
stringGreaterThan

Testa se a string especificada para stringGreaterThan é maior que a string especificada no value parâmetro. Por exemplo:

# Evaluates to false - since the comparison isn't case sensitive, 'A' is equal to 'a'
stringGreaterThan: 'a'
value: 'A'

# Evaluates to true - 'b' is greater than 'a'
stringGreaterThan: 'a'
value: 'b'

# Evaluates to true - 'a' is greater than '0'
stringGreaterThan: '0'
value: 'a'

# Evaluates to false - '0' is less than 'a'
stringGreaterThan: 'a'
value: '0'
stringGreaterThanIgual

Testa se a string especificada para stringGreaterThanEquals é maior ou igual à string especificada no value parâmetro. Por exemplo:

# Evaluates to true - 'a' is equal to 'A'
stringGreaterThanEquals: 'A'
value: 'a'

# Evaluates to true - 'b' is greater than 'a'
stringGreaterThanEquals: 'a'
value: 'b'

# Evaluates to true - 'a' is greater than '0'
stringGreaterThanEquals: '0'
value: 'a'

# Evaluates to false - '0' is less than 'a'
stringGreaterThanEquals: 'a'
value: '0'
patternMatches

Testa se a string especificada no value parâmetro corresponde ao padrão regex especificado parapatternMatches. A comparação usa o pacote Golang regexp, que está em conformidade com a sintaxe. RE2 Para obter mais informações sobre RE2 regras, consulte o repositório google/ re2 em. GitHub

O exemplo a seguir mostra uma correspondência de padrões que retornatrue:

patternMatches: '^[a-z]+$'
value: 'ThisIsValue'

Compare números

Os operadores de comparação a seguir funcionam com números. Os valores fornecidos para esses operadores devem ser de um dos seguintes tipos, de acordo com a YAML especificação. O suporte para comparações numéricas usa o operador de comparação de pacotes grandes golang, por exemplo: func (*Float) Cmp.

  • Inteiro

  • Float (baseado em float64, que suporta números de -1,7e+308 a +1,7e+308)

  • Uma string que corresponde ao seguinte padrão de regex: ^[-+]?([0-9]+[.])?[0-9]+$

Operadores de comparação de números
numberEquals

Testa se o número especificado para numberEquals é igual ao número especificado no value parâmetro. Todos os exemplos de comparações a seguir retornam: true

# Values provided as a positive number
numberEquals: 1
value: 1

# Comparison value provided as a string
numberEquals: '1'
value: 1

# Value provided as a string
numberEquals: 1
value: '1'

# Values provided as floats
numberEquals: 5.0
value: 5.0

# Values provided as a negative number
numberEquals: -1
value: -1
numberLessThan

Testa se o número especificado para numberLessThan é menor que o número especificado no value parâmetro. Por exemplo:

# Evaluates to true
numberLessThan: 2
value: 1

# Evaluates to true
numberLessThan: 2
value: 1.9

# Evaluates to false
numberLessThan: 2
value: '2'
numberLessThanIgual

Testa se o número especificado para numberLessThanEquals é menor ou igual ao número especificado no value parâmetro. Por exemplo:

# Evaluates to true
numberLessThanEquals: 2
value: 1

# Evaluates to true
numberLessThanEquals: 2
value: 1.9

# Evaluates to true
numberLessThanEquals: 2
value: '2'

# Evaluates to false
numberLessThanEquals: 2
value: 2.1
numberGreaterThan

Testa se o número especificado para numberGreaterThan é maior que o número especificado no value parâmetro. Por exemplo:

# Evaluates to true
numberGreaterThan: 1
value: 2

# Evaluates to true
numberGreaterThan: 1
value: 1.1

# Evaluates to false
numberGreaterThan: 1
value: '1'
numberGreaterThanIgual

Testa se o número especificado para numberGreaterThanEquals é maior ou igual ao número especificado no value parâmetro. Por exemplo:

# Evaluates to true
numberGreaterThanEquals: 1
value: 2

# Evaluates to true
numberGreaterThanEquals: 1
value: 1.1

# Evaluates to true
numberGreaterThanEquals: 1
value: '1'

# Evaluates to false
numberGreaterThanEquals: 1
value: 0.8

Verifique os arquivos

Os operadores de comparação a seguir verificam o hash do arquivo ou verificam se existe um arquivo ou pasta.

Operadores de arquivos e pastas
binaryExists

Testa se um aplicativo está disponível no caminho atual. Por exemplo:

binaryExists: 'foo'
nota

Em sistemas Linux e macOS, para um aplicativo chamado foo, isso funciona da mesma forma que o seguinte comando bash:type foo >/dev/null 2>&1, onde $? == 0 indica uma comparação bem-sucedida.

Em sistemas Windows, para um aplicativo chamado foo, isso funciona da mesma forma que o PowerShell comando & C:\Windows\System32\where.exe /Q foo que $LASTEXITCODE = 0 indica uma comparação bem-sucedida.

fileExists

Testa se um arquivo existe no caminho especificado. Você pode fornecer um caminho absoluto ou relativo. Se o local especificado existir e for um arquivo, a comparação será avaliada como. true Por exemplo:

fileExists: '/path/to/file'
nota

Nos sistemas Linux e macOS, isso funciona da mesma forma que o seguinte comando bash:-d /path/to/file, onde $? == 0 indica uma comparação bem-sucedida.

Nos sistemas Windows, isso funciona da mesma forma que o PowerShell comandoTest-Path -Path 'C:\path\to\file' -PathType 'Leaf'.

folderExists

Testa se existe uma pasta no caminho especificado. Você pode fornecer um caminho absoluto ou relativo. Se o local especificado existir e for uma pasta, a comparação será avaliada como. true Por exemplo:

folderExists: '/path/to/folder'
nota

Nos sistemas Linux e macOS, isso funciona da mesma forma que o seguinte comando bash:-d /path/to/folder, onde $? == 0 indica uma comparação bem-sucedida.

Nos sistemas Windows, isso funciona da mesma forma que o PowerShell comandoTest-Path -Path 'C:\path\to\folder' -PathType 'Container'.

arquivo MD5Equals

Testa se o MD5 hash de um arquivo é igual a um valor especificado. Por exemplo:

fileMD5Equals: '<MD5Hash>'
path: '/path/to/file'
arquivo SHA1Equals

Testa se o SHA1 hash de um arquivo é igual a um valor especificado. Por exemplo:

fileSHA1Equals: '<SHA1Hash>'
path: '/path/to/file'
arquivo SHA256Equals

Testa se o SHA256 hash de um arquivo é igual a um valor especificado. Por exemplo:

fileSHA256Equals: '<SHA256Hash>'
path: '/path/to/file'
arquivo SHA512Equals

Testa se o SHA512 hash de um arquivo é igual a um valor especificado. Por exemplo:

fileSHA512Equals: '<SHA512Hash>'
path: '/path/to/file'