Terraform 프로바이더

공식 OpenAI Terraform 프로바이더를 사용하면 코드형 인프라로 OpenAI 조직 리소스를 관리할 수 있습니다. 프로바이더는 관리 API를 사용해 프로젝트, 사용자, 그룹, 역할, 서비스 계정, 인증서, 요청 한도, 지출 알림 및 관련 프로젝트 설정을 관리합니다.

이 가이드에서는 OpenAI 프로젝트를 만듭니다. 프로젝트 접근 권한, 서비스 계정, 운영 한도, 프로젝트 제어 설정, 리소스 가져오기는 이어지는 사용 사례별 가이드에서 다룹니다.

시작하기 전에

다음 항목이 필요합니다.

• Terraform 1.0 이상. 리소스 가져오기 예제를 실행하려면 Terraform 1.5 이상이 필요합니다.
• OpenAI 조직과 해당 조직에서 관리자 API 키를 생성할 권한.

관리 API 엔드포인트에는 관리자 API 키가 필요합니다. 이 키는 관리 API 이외의 OpenAI API 엔드포인트에서는 사용할 수 없습니다. 키는 환경 변수나 시크릿 관리자에 저장하세요. Terraform 구성에 키를 포함하거나 버전 관리 시스템에 커밋하지 마세요.

프로바이더 구성하기

새 디렉터리를 만들고 다음 구성을 담은 main.tf 파일을 추가하세요.

1234567891011121314151617181920terraform {
  required_version = ">= 1.0"

  required_providers {
    openai = {
      source  = "openai/openai"
      version = ">= 1.0.0"
    }
  }
}

provider "openai" {}

resource "openai_project" "example" {
  name = "terraform-managed"
}

output "project_id" {
  value = openai_project.example.project_id
}

이 버전 제약 조건은 프로바이더 버전 1.0.0 이상을 허용합니다. 업그레이드하기 전에 프로바이더 릴리스 정보를 확인하세요.

관리자 API 키를 환경 변수로 설정하세요.

export OPENAI_ADMIN_KEY="<your-admin-api-key>"

프로바이더는 기본적으로 OPENAI_ADMIN_KEY에서 키를 읽습니다. OPENAI_ORG_ID와 OPENAI_PROJECT_ID를 설정하면 API 요청에 OpenAI-Organization과 OpenAI-Project 헤더를 함께 보낼 수 있습니다. 이 선택적 환경 변수를 설정하지 않으면 OpenAI는 API 키를 기준으로 조직과 프로젝트를 식별합니다. Terraform 구성으로 관리할 조직이나 프로젝트를 명시하려면 해당 변수를 설정하세요. 사용 가능한 모든 인수는 프로바이더 구성 레퍼런스에서 확인할 수 있습니다.

초기화하고 적용하기

작업 디렉터리를 초기화한 다음 구성 파일의 서식을 정리하고 구성이 유효한지 확인하세요.

123terraform init
terraform fmt
terraform validate

Terraform은 프로바이더를 다운로드하고 .terraform.lock.hcl을 생성합니다. 이후 실행에서도 같은 프로바이더 버전이 선택되도록 잠금 파일을 버전 관리 시스템에 커밋하세요. 버전 제약 조건을 충족하는 최신 프로바이더 버전을 선택하려면 terraform init -upgrade를 실행하세요.

Terraform이 적용할 변경 사항을 검토하세요.

terraform plan

실행 계획에 추가할 openai_project 리소스가 하나 표시되어야 합니다. 실행 계획을 검토한 후에만 구성을 적용하세요.

terraform apply

적용 여부를 묻는 메시지가 표시되면 승인하세요. Terraform이 프로젝트를 생성하고 project_id 출력값으로 프로젝트 ID를 표시합니다.

사용 사례별 가이드 선택하기

개별 인수와 리소스 가져오기 형식은 프로바이더 리소스 및 데이터 소스 레퍼런스에서 확인하세요.