HashiCorp 설정 언어(HCL) 참조

HashiCorp 설정 언어(HCL) 참조 (HCL reference)

Nomad 작업 명세가 기반으로 하는 HashiCorp Configuration Language(HCL)의 참조 정보를 알아봐요.

출처: 문서

본문

Nomad 작업 명세(job specification)는 HashiCorp Configuration Language(HCL)를 사용해 작성돼요. 이 페이지는 Nomad에서 사용되는 HCL 구문에 대한 참조를 제공해요.

HCL 개요

HCL은 HashiCorp 도구들이 인간이 읽고 쓰기 쉽도록 설계한 구성 언어예요. HCL은 블록, 속성, 표현식을 지원하며 선언적인 설정을 표현하는 데 적합해요.

Nomad 작업 명세는 .nomad.hcl 또는 .hcl 확장자를 가진 파일로 작성돼요. 작업 파일은 서버에서 실행하는 명령으로 구성되며, 서버는 이를 평가해 작업을 등록해요.

블록과 속성

HCL 구성은 블록(block)과 속성(attribute)으로 구성돼요.

  • 속성 - 키 = 값 형태. 예: count = 3
  • 블록 - 중괄호로 감싼 속성들의 묶음. 예:
group "app" {
  count = 3
}

표현식과 보간

HCL은 표현식을 지원하며, ${...} 구문을 사용해 값을 보간할 수 있어요(예: ${NOMAD_PORT_http}). 내장 함수도 사용할 수 있어요.

표현식에 대한 자세한 내용은 HCL 표현식 참조를 참고해요.

함수

HCL은 표현식 안에서 호출할 수 있는 내장 함수들을 제공해요. 함수 목록은 HCL 함수 참조를 참고해요.

더 알아보기 (Learn more)