사용자 지정 프로바이더 구축
프로바이더의 작동 방식을 이해하고 Terraform Plugin Framework로 사용자 지정 프로바이더를 작성해 기존 통합을 넘어 Terraform을 확장합니다.
사용자 지정 프로바이더 구축은(는) CoddyKit의 무료 DevOps Bootcamp 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 DevOps Bootcamp 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
기존 공급자가 부족할 때
레지스트리는 대부분의 플랫폼을 지원하지만, 기업에서는 공급자가 없는 내부 API를 사용하는 경우가 많습니다. 사용자 지정 공급자를 사용하면 동일한 plan/apply 수명 주기로 Terraform에서 해당 리소스를 관리할 수 있습니다.
공급자의 작동 방식
공급자는 Terraform이 실행하고 gRPC를 통해 통신하는 별도의 플러그인 이진 파일입니다. 플러그인은 Terraform의 CRUD 작업을 대상 시스템에 대한 API 호출로 변환합니다.
플러그인 프레임워크
HashiCorp의 최신 Terraform Plugin Framework(Go)는 공급자를 구축하는 데 권장되는 방식이며, 이전 SDKv2를 대체합니다. 공급자는 Go로 작성합니다.
import (
"github.com/hashicorp/terraform-plugin-framework/provider"
)공급자 정의하기
공급자 유형은 이름과 제공하는 리소스 및 데이터 원본을 선언합니다.
type widgetProvider struct{}
func (p *widgetProvider) Metadata(_ context.Context, _ provider.MetadataRequest, resp *provider.MetadataResponse) {
resp.TypeName = "widget"
}리소스 스키마
각 리소스는 유형과 메타데이터가 포함된 특성 스키마를 선언합니다. 사용자는 HCL에서 이를 설정합니다.
resp.Schema = schema.Schema{
Attributes: map[string]schema.Attribute{
"name": schema.StringAttribute{Required: true},
"id": schema.StringAttribute{Computed: true},
},
}CRUD 구현하기
리소스는 Create, Read, Update, Delete를 구현합니다. 각 메서드는 API를 호출하고 결과를 Terraform 상태에 다시 기록합니다.
func (r *widgetResource) Create(ctx context.Context, req resource.CreateRequest, resp *resource.CreateResponse) {
// call API, then save state
}Read로 상태를 정확하게 유지하기
Read 메서드는 실제 API에서 상태를 새로 고칩니다. 원격 리소스가 사라졌다면 상태에서 제거하여 Terraform이 다시 생성하도록 plan을 수립하게 합니다.
승인 테스트
공급자는 테스트 환경에서 실제 plan/apply 주기를 실행하는 승인 테스트를 사용합니다. 실수로 실행되지 않도록 환경 변수로 실행 여부를 제어합니다.
TF_ACC=1 go test ./... -v로컬 개발 재정의
게시하기 전에 공급자를 테스트하려면 CLI 구성에서 개발 재정의를 사용하세요. 그러면 Terraform이 레지스트리에서 다운로드하는 대신 로컬 이진 파일을 불러옵니다.
provider_installation {
dev_overrides {
"acme/widget" = "/home/dev/go/bin"
}
direct {}
}공급자 게시하기
릴리스를 태그하고 GPG 키로 이진 파일에 서명하여 레지스트리에 게시하세요. 그러면 사용자는 required_providers에서 해당 공급자를 선언할 수 있습니다.
terraform {
required_providers {
widget = {
source = "acme/widget"
version = "~> 1.0"
}
}
}유지 관리 시 고려 사항
공급자는 장기적인 책임이 따릅니다. API 변경, 버전 호환성, 문서를 모두 지속적으로 관리해야 합니다. 일회성 요구 사항이라면 완전한 공급자를 만드는 것보다 external 데이터 원본이나 스크립트가 더 간단할 수 있습니다.
빠른 확인
사용자 지정 공급자에 대한 지식을 테스트해 보세요.
복습: Terraform 확장하기
사용자 지정 공급자를 구축하는 방법을 배웠습니다.
- 공급자는 핵심 기능과 gRPC로 통신하는 Go 플러그인입니다.
- 플러그인 프레임워크는 스키마와 CRUD 메서드를 정의합니다.
- 개발 재정의를 사용하면 로컬 테스트를 수행할 수 있고, 승인 테스트로 동작을 검증할 수 있습니다.
- 게시하려면 태그와 서명된 이진 파일이 필요합니다.
AI 튜터와 함께 DevOps Bootcamp을(를) 배우세요 — 무료
브라우저에서 실제 코드를 작성하고 실행하며, 24/7 AI 튜터로부터 즉각적인 도움을 받고, 웹이나 앱에서 중단한 부분부터 계속 학습하세요.
- 코스
- 142
- 레슨
- 568
자주 묻는 질문
“사용자 지정 프로바이더 구축” 강의는 무료인가요?
네 — “사용자 지정 프로바이더 구축” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 DevOps Bootcamp 강의 전체를 잠금 해제할 수 있습니다. DevOps Bootcamp 강의에는 총 4개의 강의가 포함되어 있습니다.
“사용자 지정 프로바이더 구축”에서 뭘 배우나요?
프로바이더의 작동 방식을 이해하고 Terraform Plugin Framework로 사용자 지정 프로바이더를 작성해 기존 통합을 넘어 Terraform을 확장합니다. 브라우저에서 직접 실행하는 실습 코드로 DevOps Bootcamp을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
DevOps Bootcamp을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 DevOps Bootcamp은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.
“사용자 지정 프로바이더 구축” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 DevOps Bootcamp 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 DevOps Bootcamp 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.