H

Hashicorp 스킬

aws-ami-builder
hashicorp
Packer의 amazon-ebs 빌더로 사용자 지정 Amazon 머신 이미지를 구축합니다. HCL 템플릿과 프로비저너(셸 스크립트, 파일 업로드, 구성 관리)를 사용해 소스 AMI에서 AMI 생성을 자동화합니다. ami_regions를 통한 다중 리전 AMI 배포와 이름, 소유자, 가상화 유형별 유연한 소스 AMI 필터링을 지원합니다. 환경 변수, AWS 자격 증명 파일 또는 IAM 인스턴스 프로파일을 통해 인증하며 템플릿 검증 및 빌드 명령을 포함합니다...
official
aws-ami-builder
hashicorp
Packer의 amazon-ebs 빌더를 사용하여 Amazon 머신 이미지(AMI)를 빌드합니다. EC2 인스턴스용 사용자 지정 AMI를 생성할 때 사용하세요.
official
azure-image-builder
hashicorp
Azure 관리 이미지와 Azure Compute Gallery 이미지를 Packer로 빌드합니다. Azure VM용 사용자 지정 이미지를 생성할 때 사용합니다.
official
azure-image-builder
hashicorp
Azure 관리 이미지와 Azure Compute Gallery 이미지를 Packer로 빌드합니다. Azure VM용 사용자 지정 이미지를 생성할 때 사용합니다.
official
azure-verified-modules
hashicorp
Azure Terraform 모듈이 AVM 규정을 준수하기 위한 인증 요구 사항 및 모범 사례입니다. 공급자 버전 제약 조건(azurerm >= 4.0, < 5.0; azapi >= 2.0, < 3.0)을 적용하고, git 기반 모듈 참조를 금지하며 고정된 Terraform 레지스트리 소스를 사용하도록 합니다. 모든 식별자에 소문자 스네이크 케이스, 정확한 변수 유형, 반부패 계층 패턴을 통한 개별 출력 속성, 알파벳 순서로 정렬된 로컬 변수를 요구합니다. 새 리소스가 추가될 때 기능 토글 변수를 요구합니다...
official
azure-verified-modules
hashicorp
Azure Verified Modules (AVM) 요구 사항 및 인증된 Azure Terraform 모듈 개발을 위한 모범 사례입니다. Azure 모듈을 생성하거나 검토할 때 사용하세요…
official
new-terraform-provider
hashicorp
Plugin Framework를 사용하여 새로운 Terraform Provider를 스캐폴딩합니다. 표준 "terraform-provider-" 명명 규칙을 따르는 새로운 Go 모듈 워크스페이스를 생성하고 필요한 종속성을 초기화합니다. HashiCorp의 Plugin Framework 패턴을 따르는 템플릿 main.go 파일을 제공하며, 사용자 정의를 위한 TODO 마커가 포함되어 있습니다. 빌드 및 테스트 명령을 실행하여 Provider가 컴파일되고 초기 검사를 통과하는지 확인함으로써 설정을 검증합니다. 새 워크스페이스를 생성하기 전에 의도를 확인하여 워크스페이스 관리를 처리합니다.
official
new-terraform-provider
hashicorp
새로운 Terraform 제공자를 스캐폴딩할 때 사용하세요.
official
provider-actions
hashicorp
Plugin Framework를 사용하여 Terraform Provider 액션을 구현합니다. 라이프사이클 이벤트(전/후…)에서 실행되는 명령형 작업을 개발할 때 사용합니다.
official
provider-actions
hashicorp
Plugin Framework를 사용하여 리소스 수명 주기 이벤트에서 명령형 Terraform Provider 작업을 구현합니다. 생성 전/후 및 업데이트 전/후 수명 주기 트리거를 지원합니다(소멸 이벤트는 Terraform 1.14.0에서 사용 불가). 올바른 프레임워크 유형, 컬렉션용 ElementType, 입력 검증용 유효성 검사기를 포함한 적절한 스키마 정의가 필요합니다. 장기 실행 작업을 위한 진행 보고, 타임아웃 관리, 포괄적인 오류 처리를 포함합니다. 폴링 및...
official
provider-docs
hashicorp
Terraform 레지스트리를 위한 Terraform 공급자 문서를 HashiCorp 권장 패턴, tfplugindocs 템플릿 및 스키마를 사용하여 생성, 업데이트 및 검토합니다.
official
provider-docs
hashicorp
Terraform 레지스트리를 위한 Terraform 공급자 문서를 HashiCorp 권장 패턴, tfplugindocs 템플릿, 스키마를 사용하여 생성, 업데이트 및 검토합니다.
official
provider-resources
hashicorp
Terraform Provider 리소스와 데이터 소스를 완전한 CRUD 연산 및 테스트와 함께 구현합니다. SDKv2와 Plugin Framework 패턴을 모두 다루며, 스키마 설계, 계획 수정자, 검증기를 포함한 리소스 구현을 설명합니다. 오류 처리, 상태 관리, 리소스 미발견 패턴을 포함한 완전한 CRUD 연산 예제(Create, Read, Update, Delete)를 제공합니다. 기본 테스트, 사라짐 테스트, 헬퍼 함수, 테스트 실행 명령어를 포함한 승인 테스트 패턴을 포함합니다...
official
provider-resources
hashicorp
Terraform Provider 리소스와 데이터 소스를 Plugin Framework를 사용하여 구현합니다. CRUD 작업, 스키마 설계, 상태 관리 등을 개발할 때 사용합니다.
official
provider-test-patterns
hashicorp
Plugin Framework와 함께 terraform-plugin-testing을 사용하여 승인 테스트를 작성하기 위한 패턴입니다.
official
provider-test-patterns
hashicorp
Plugin Framework와 함께 terraform-plugin-testing을 사용하여 승인 테스트를 작성하기 위한 패턴입니다.
official
push-to-registry
hashicorp
Packer 빌드 메타데이터를 HCP Packer 레지스트리로 푸시하여 이미지 수명 주기 추적 및 거버넌스를 수행합니다. 최소한의 오버헤드로 빌드 아티팩트를 HCP Packer에 등록하며, 실제 이미지가 아닌 메타데이터만 저장하고 빌드 시간에 1분 미만을 추가합니다. 버킷 수준 레이블(빌드별 업데이트)과 변경 불가능한 빌드 수준 레이블(git SHA, 타임스탬프)을 지원하여 버전 제어 및 규정 준수 추적을 가능하게 합니다. hcp_packer_artifact 데이터 소스를 통해 Terraform과 통합되어 이미지를 쿼리하고 배포합니다.
official
push-to-registry
hashicorp
Packer 빌드 메타데이터를 HCP Packer 레지스트리에 푸시하여 이미지 수명 주기를 추적하고 관리합니다. Packer 빌드를 HCP Packer와 통합하여 버전 관리를 수행할 때 사용합니다.
official
refactor-module
hashicorp
모놀리식 Terraform 구성을 재사용 가능하고 잘 구조화된 모듈로 분할하며, 명확한 계약과 마이그레이션 경로를 제공합니다. 기존 코드를 분석하여 리팩토링 대상을 식별하고, 리소스를 논리적 기능별로 그룹화하며, 설계 전 복잡성을 평가합니다. HashiCorp 모범 사례를 따라 타입 변수, 검증 규칙, 설명적 출력을 포함한 모듈 인터페이스를 생성합니다. moved 블록(Terraform 1.1+) 또는 수동 terraform state mv 명령을 사용한 상태 마이그레이션 전략을 제공합니다...
official
refactor-module
hashicorp
모놀리식 Terraform 구성을 HashiCorp의 모듈 설계 원칙과 커뮤니티 모범 사례에 따라 재사용 가능하고 유지 관리가 용이한 모듈로 변환합니다.
official
run-acceptance-tests
hashicorp
Terraform 제공자의 Go 승인 테스트를 실행하고 구조화된 문제 해결을 통해 진단합니다. TF_ACC=1 환경 변수와 함께 go test -run=TestAccFeatureHappyPath를 사용하여 집중 승인 테스트를 실행합니다. 실패를 점진적으로 진단합니다: -count=1로 재시도, -v로 상세 출력 활성화, TF_LOG=debug를 통해 디버그 로깅 활성화, TF_ACC_WORKING_DIR_PERSIST=1로 Terraform 작업 공간 유지. TestCheckFunc를 의도적으로 중단시켜 테스트 신뢰성을 검증하고, 테스트를 재실행하여...
official
run-acceptance-tests
hashicorp
Guide for running acceptance tests for a Terraform provider. Use this when asked to run an acceptance test or to run a test with the prefix `TestAcc`.
official
terraform-search-import
hashicorp
Terraform Search 쿼리를 사용하여 기존 클라우드 리소스를 검색하고 이를 Terraform 관리로 대량 가져옵니다. 관리되지 않는 인프라를 도입할 때 사용합니다…
official
terraform-search-import
hashicorp
Terraform Search 쿼리를 사용하여 기존 클라우드 리소스를 검색하고 이를 Terraform 관리로 대량 가져옵니다. 관리되지 않는 인프라를 도입할 때 사용합니다…
official
terraform-stacks
hashicorp
Terraform Stack 구성을 환경 전반에 걸쳐 생성, 검증, 관리하기 위한 종합 가이드입니다. Stack 언어의 기본 요소인 컴포넌트 정의(.tfcomponent.hcl), 배포 인스턴스(.tfdeploy.hcl), 파일 구성, 필수 Terraform v1.13+를 다룹니다. for_each를 프로바이더와 컴포넌트에 사용하여 다중 리전 및 다중 환경 배포를 지원하며, 컴포넌트 간 자동 종속성 추론 기능을 제공합니다. 워크로드 아이덴티티(OIDC) 인증, 아이덴티티 토큰...
official
terraform-stacks
hashicorp
HashiCorp Terraform Stacks 작업을 위한 종합 가이드입니다. Terraform Stack 구성(.tfcomponent.hcl, …)을 생성, 수정 또는 검증할 때 사용하세요.
official
terraform-style-guide
hashicorp
HashiCorp의 공식 스타일 규칙을 따라 Terraform 코드를 생성하고 유지 관리합니다. 두 칸 들여쓰기, 소문자 밑줄 명명, terraform.tf, providers.tf, main.tf, variables.tf, outputs.tf, locals.tf의 표준 파일 구성을 적용합니다. 모든 변수와 출력에 유형과 설명이 필요하며, 자격 증명에 대한 유효성 검사 규칙과 민감 플래그 지원이 포함됩니다. 동적 리소스에는 count보다 for_each를 우선시하고, 보안 강화(암호화, 비공개...)를 적용합니다.
official
terraform-style-guide
hashicorp
HashiCorp의 공식 스타일 규칙과 모범 사례를 따라 Terraform HCL 코드를 생성합니다. Terraform을 작성, 검토 또는 생성할 때 사용합니다.
official
terraform-test
hashicorp
Terraform 테스트 작성 및 실행을 위한 종합 가이드로, 어설션, 모킹, 모듈 검증을 포함합니다. .tftest.hcl 구문을 사용하여 테스트 파일을 작성하며, plan 또는 apply 모드로 실행되는 run 블록을 지원하고, 선택적 상태 격리와 함께 순차 및 병렬 실행을 지원합니다. 리소스 속성, 출력, 데이터 소스에 대한 조건을 어설션하고, expect_failures를 사용하여 잘못된 입력이 적절히 거부되는지 검증합니다. Mock 제공자(Terraform 1.7.0+)는 인프라 동작을 시뮬레이션합니다...
official
terraform-test
hashicorp
Terraform 테스트 작성 및 실행을 위한 종합 가이드입니다. 테스트 파일(.tftest.hcl) 생성, run 블록을 사용한 테스트 시나리오 작성, 검증 시 사용하세요.
official
windows-builder
hashicorp
Packer와 WinRM 커뮤니케이터 및 PowerShell 프로비저너를 사용하여 Windows 이미지를 빌드합니다. Windows AMI, Azure 이미지 또는 VMware 템플릿을 생성할 때 사용하세요.
official
windows-builder
hashicorp
Packer와 WinRM 커뮤니케이터 및 PowerShell 프로비저너를 사용하여 Windows 이미지를 빌드합니다. Windows AMI, Azure 이미지 또는 VMware 템플릿을 생성할 때 사용하세요.
official