Terraform 1.17.0 업그레이드: 프로바이더 변수와 Policy, CI 점검
Terraform 1.17.0의 프로바이더 요구사항, refresh 옵션, Policy GA와 JSON 출력 변경을 기준으로 IaC 파이프라인의 업그레이드 점검 범위를 정한다.
2026-10-31
업그레이드 범위를 실행 파일 밖까지 잡는다
Terraform 실행 파일을 교체하는 작업과 새 계획 옵션을 도입하는 작업은 검증 범위가 다르다. -minimal-refresh는 refresh할 리소스의 범위를 바꾸고, terraform version -json의 새 필드는 명령 출력을 읽는 자동화 코드에 영향을 준다. 같은 업그레이드에 포함돼 있어도 확인할 지점은 각각 다르다.
이 글의 기준은 Terraform v1.17.0 (2026-10-21) 이다. 공식 릴리스노트에 명시된 변경을 기준으로, 현재 파이프라인에서 사용하는 기능부터 점검 범위를 잡는다.
| 변경 영역 | 릴리스에 명시된 동작 | 실무 점검 대상 |
|---|---|---|
| 프로바이더 요구사항 | 변수와 로컬 지원 | 요구사항 값을 구성하는 기존 방식 |
| 계획 옵션 | -minimal-refresh가 변경 제안 리소스만 refresh |
해당 옵션을 적용할 계획 작업과 refresh 범위 |
| Terraform Policy | -policies GA |
실험 빌드 의존성, 실행 인자, 정책 결과 처리 |
| 버전 JSON | format_version 필드 추가 |
JSON 파서와 출력 스키마 검증 |
| 함수·진단 | log·pow 오류 처리, ephemeral 갱신 진단 반영 |
실패 처리와 로그 판독 |
| 빌드·인증서 | Go 1.26.10 및 인증서 신뢰 변경 | 외부 연결에 쓰이는 인증서 체인 |
검증할 때는 기존 구성으로 업그레이드 영향을 확인한 뒤, 새 기능을 적용할 작업을 구분해 기록한다. 그래야 계획 결과나 진단이 달라졌을 때 실행 파일 변경과 옵션 도입 중 어느 쪽을 먼저 확인할지 정할 수 있다.
프로바이더 요구사항의 값 구성 방식을 재검토한다
이번 릴리스는 프로바이더 요구사항에서 변수와 로컬을 지원한다. 요구사항 값을 구성하기 위해 별도 처리를 두고 있었다면, 새 지원 범위 안에서 그 처리를 줄일 수 있는지 검토할 지점이다.
먼저 저장소에서 프로바이더 요구사항을 선언하는 위치와 그 값을 만드는 과정을 함께 확인한다. 요구사항 선언만 보면 값이 어디에서 결정되는지 놓칠 수 있다. 반대로 구성 파일을 생성하는 절차만 보면, 이제 Terraform 구성 안에서 표현할 수 있는 부분을 계속 외부에 남겨둘 수 있다.
다만 제공된 릴리스노트에는 허용되는 표현식의 상세 범위나 설정 예시가 없다. 따라서 이 변경을 근거로 프로바이더 요구사항의 모든 속성에 임의의 표현식을 사용할 수 있다고 확대해서는 안 된다. 적용하려는 구성에서 변수·로컬 참조를 검증하고, 그 결과를 확인한 뒤 기존 처리를 바꾼다.
이 작업의 완료 기준은 문법을 치환했다는 사실보다 의도한 요구사항이 유지되는지 확인했는가에 둔다. 업그레이드와 구성 단순화를 함께 진행한다면 변경 전후 요구사항을 검토할 수 있게 남겨둔다.
minimal-refresh는 refresh 범위를 선택하는 옵션이다
새 계획 옵션 -minimal-refresh는 변경이 제안된 리소스만 refresh한다. 도입 판단의 출발점은 옵션 이름이 아니라 이 범위다.
이 옵션을 적용하려는 작업에서는 계획에 표시되는 변경과 refresh 대상이 어떻게 연결되는지 확인해야 한다. 특히 변경이 제안되지 않은 리소스까지 이 옵션이 refresh했다고 전제해서는 안 된다. CI 결과를 읽는 사람도 어떤 옵션으로 계획을 만들었는지 알 수 있어야 한다.
다음 그림은 -minimal-refresh를 사용할 때 변경 제안 여부에 따라 refresh 대상이 갈리는 경계를 보여 준다.
적용 후보를 고를 때는 대표 구성의 계획 결과와 refresh 대상을 함께 확인한다. 이 검증으로 해당 작업이 기대하는 확인 범위를 충족하는지 판단한다. 실행 시간이 줄어드는지도 측정할 수 있지만, 릴리스노트에는 성능 수치가 없으므로 일정한 속도 향상을 도입 근거로 미리 약속할 수는 없다.
옵션을 켠 뒤에는 CI 작업 정의나 실행 기록에 사용 여부를 남긴다. 계획 결과를 검토할 때 refresh 범위까지 해석할 수 있도록 하기 위해서다.
Policy GA는 실행 조건과 결과 처리를 함께 바꾼다
Terraform Policy가 GA가 되면서 plan, apply, query의 -policies 플래그는 더 이상 실험 빌드나 -allow-experimental-features를 요구하지 않는다.
이미 실험 기능으로 정책을 실행하던 파이프라인이라면 정책 내용보다 실행 환경부터 확인한다. Policy 사용 때문에 선택했던 빌드나 실행 인자를 찾아, GA에서 필요한 조건으로 정리할 수 있는지 검증한다. 다만 다른 실험 기능도 함께 사용하는 작업이라면 Policy의 GA만을 근거로 공용 인자를 일괄 삭제하지 않는다.
실험 기능 사용 시점과 GA의 차이는 정책 실행에 필요한 조건을 같은 축에 놓으면 분명해진다.
query를 사용하는 경우에는 실행 성공 여부와 정책 평가 결과를 구분해서 확인한다. 릴리스노트에 따르면 query 정책은 list 블록이 발견한 리소스를 평가하고 사람이 읽는 형식 또는 JSON으로 결과를 보고한다. 관련 동작의 세부 설명은 릴리스노트가 안내하는 Terraform Policy 문서를 참조할 수 있다.
이번 릴리스에는 query 결과와 입력 경계에 관한 수정도 포함돼 있다.
- 발견한 리소스의 정책 평가에서
Unknown과N/A결과를 보고한다. terraform query -policies는 디렉터리가 아닌 경로를 정책 엔진에 넘기지 않고 거부한다.
따라서 정책 결과를 자동 판독하는 코드에서는 Unknown과 N/A를 어떻게 표시하고 처리할지 확인한다. 정책 경로를 주입하는 작업에서는 실제로 디렉터리를 전달하는지도 점검한다. GA 전환 검증을 “명령이 실행됐다”에서 끝내면 결과 해석과 잘못된 경로 입력에 대한 처리를 놓칠 수 있다.
version JSON을 읽는 코드에 format_version을 반영한다
terraform version -json 출력에는 format_version 필드가 추가됐다. 릴리스노트는 이를 앞으로 명령의 JSON 출력 형식을 더 안전하게 변경하기 위한 필드로 설명한다.
버전 정보를 수집하는 기존 명령부터 실행해 소비 코드에 전달해 본다.
terraform version -json
릴리스노트는 기존 도구가 알 수 없는 필드를 무시한다고 가정하므로, 필드 추가 자체를 호환성을 깨는 변경으로 보지는 않는다. 이 가정이 현재 파이프라인에도 맞는지 확인하는 것이 업그레이드 작업이다. 허용한 키만 받는 스키마 검증이나 출력 전체를 비교하는 검사가 있다면 새 필드를 받아들이는지 점검한다.
파서가 필드를 수용하는지와 앞으로 그 값을 어떻게 다룰지는 별개의 검토 사항이다. Terraform 실행 파일 버전 확인에 더해, 출력 형식의 변경을 판단할 때 format_version을 활용할 수 있도록 소비 경로를 확인한다.
릴리스노트는 향후 릴리스에서 이 필드에 주의를 기울이거나, 이를 다루는 최신 hashicorp/terraform-json과 hashicorp/terraform-exec를 사용하도록 권고한다. 해당 라이브러리를 사용하는 저장소라면 의존성도 점검 대상에 포함한다. 제공된 자료에는 필요한 최소 라이브러리 버전이 없으므로 특정 버전을 호환성 기준으로 제시할 수는 없다.
오류와 진단이 달라지는 경로를 검증한다
업그레이드 후 새 오류나 경고가 보인다면 구성 변경과 함께 이번 릴리스의 함수·진단 수정도 확인한다. 특히 수학 함수의 경계 입력과 ephemeral 리소스 갱신을 사용하는 구성에 해당한다.
log와 pow에는 구분해서 확인할 변경이 있다. 결과가 NaN인 경우 더 이상 panic하지 않으며, 결과가 양의 무한대나 음의 무한대인 경우에는 오류를 낸다. 무한대 결과는 후속 코드에서 사용할 수 없기 때문이라고 릴리스노트는 설명한다.
이 함수를 사용하는 구성은 정상 입력뿐 아니라 기존에 문제가 됐던 경계 입력도 검증 대상으로 잡는다. 기존 오류 처리나 로그 판독이 있었다면 panic 방지와 무한대 오류 발생을 같은 변화로 취급하지 말고 각각 확인한다.
ephemeral 리소스는 갱신 중 발생한 진단을 사용하고 표시하게 됐다. 이전에 유실되던 경고가 새로 나타날 수 있다. 릴리스노트는 유실되던 오류 진단이 혼란스러운 후속 오류로 이어졌을 것으로 보며, 이 변경이 호환성을 깨지는 않을 것으로 예상한다.
갱신 경로를 사용하는 작업에서는 새로 보이는 진단을 보존하고 내용을 확인한다. 테스트에서 ephemeral 리소스를 모킹한다면 이번에 추가된 mock_provider 지원도 적용 후보가 된다. 테스트 정리 그래프의 의존성 순서가 결정적으로 바뀐 점과, 로컬 계획을 보여 줄 때 변수 값을 계획 파일에서 읽도록 수정된 점도 해당 기능을 검증하는 저장소에서 확인할 항목이다.
인증서 신뢰 변경까지 확인하고 전환한다
Terraform 1.17.0은 Go 1.26.10으로 빌드됐다. 이 버전은 침해된 eMudhra 중간 CA 집합을 통해 발급된 인증서를 더 이상 신뢰하지 않으며, 릴리스노트는 CVE-2026-111943을 관련 항목으로 명시한다.
외부 연결을 검증할 때는 사용하는 인증서 체인이 이 변경에 해당하는지 확인한다. 업그레이드 후 인증서 오류가 발생한다면 설정 차이와 함께 신뢰 체인의 변경도 조사할 근거가 된다. 제공된 자료에는 영향받는 인증서 전체 목록이 없으므로 eMudhra 관련 인증서 전체가 동일하게 처리된다고 일반화할 수는 없다.
운영 로그에서 활용할 개선도 있다. init 로그에는 프로바이더 버전 정보가 보강됐고, 조직의 TTL 정책 적용 대상 사용자는 로그인 성공 후 경고를 보게 된다. 초기화 문제를 조사하거나 로그인 결과를 읽을 때 이 정보가 남는지 확인해 두면 된다.
전환 완료 기준은 현재 사용 경로에 맞춰 정한다. 기존 구성의 계획 결과, JSON 소비 코드, 정책 결과 처리, 함수와 갱신 진단, 외부 연결을 확인한 뒤 새 옵션의 적용 범위를 기록한다. 특히 -minimal-refresh 도입과 Policy 실행 환경 정리는 별도 변경으로 검토할 수 있게 남겨야 이후 결과 차이를 추적하기 쉽다.