HCL 표현식 참조

HCL 표현식 참조 (HCL expressions reference)

Nomad 작업 명세에서 사용하는 HCL 표현식의 구문과 연산자를 알아봐요.

출처: 문서

본문

HCL 표현식은 구성 파일에서 값을 계산하는 구문이에요. Nomad 작업 명세는 HCL2를 사용하며, 표현식 안에서 다양한 연산자와 함수, 보간을 사용할 수 있어요.

리터럴(Literals)

문자열, 숫자, 불리언, null 같은 리터럴 값을 표현식에 직접 사용할 수 있어요.

count = 3
enabled = true
name = "web"

연산자

HCL 표현식은 다음 연산자를 지원해요.

  • 산술: +, -, *, /, %
  • 비교(부등): <, >, <=, >=
  • 동등: ==, !=
  • 논리: &&, ||, !
  • 그룹화: ( )

컬렉션

리스트와 맵을 리터럴로 표현할 수 있어요.

ports = [8080, 8081]
tags = { "env" = "prod" }

컬렉션 요소는 인덱스(list[0]) 또는 키(map["env"])로 접근할 수 있어요.

보간(Interpolation)

${...} 구문으로 표현식을 문자열 안에 삽입할 수 있어요.

args = ["--port=${NOMAD_PORT_http}"]

조건 표현식

조건 ? 참일 때 : 거짓일 때 형태의 조건 표현식을 사용할 수 있어요.

count = var.use_hpa ? 3 : 1

함수 호출

내장 함수를 호출해 값을 변환·결합할 수 있어요. 함수 목록은 HCL 함수 참조를 참고해요.

count = max(3, 5)

더 알아보기 (Learn more)