Knowledge Graph용 Terraform 시작하기
Knowledge Graph용 Terraform 시작하기 (Get started with Terraform for Knowledge Graph)
Grafana Cloud를 사용하면 직접 Grafana 인스턴스를 설치·유지·확장할 필요가 없어요. 10k 메트릭, 50GB 로그, 50GB 트레이스, 500VUh k6 테스트 등을 평생 무료로 포함하는 시작을 위해 무료 계정 만들기를 해요.
Terraform을 구성해 Grafana Cloud Knowledge Graph 리소스를 관리하는 방법을 배워요. 이 가이드는 Grafana Terraform 제공자를 설정하고 환경을 준비하는 과정을 안내해요.
출처: 문서
본문
Terraform을 구성해 Grafana Cloud Knowledge Graph 리소스를 관리하는 방법을 배워요. 이 가이드는 Grafana Terraform 제공자를 설정하고 환경을 준비하는 과정을 안내해요.
시작하기 전에 (Before you begin)
시작하기 전에 다음이 있는지 확인해요:
- Get started에 표시된 Grafana Cloud 계정
- 머신에 설치된 Terraform
- Grafana 인스턴스의 관리자 권한
Note Terraform을 사용하기 전에 Knowledge Graph를 활성화할 필요는 없어요.
grafana_asserts_stack리소스가 스택에서 Knowledge Graph 활성화를 포함한 전체 온보딩 흐름을 처리해요.
Note 모든 Terraform 구성 파일은 같은 디렉터리에 저장해야 해요.
Grafana 제공자 구성 (Configure the Grafana provider)
이 Terraform 구성은 knowledge graph 리소스를 관리할 때 필요한 인증을 제공하도록 Grafana 제공자를 설정해요.
Terraform을 사용한 Grafana Cloud 스택 생성 및 관리에 설명된 것과 비슷한 설정을 재사용해 서비스 계정과 토큰을 설정할 수 있어요.
단계 (Steps)
- Grafana에서 서비스 계정과 토큰을 만들어요. 새로 만들려면 Service account tokens을 참고해요.
main.tf라는 파일을 만들고 다음을 추가해요:
terraform
terraform {
required_providers {
grafana = {
source = "grafana/grafana"
version = ">= 2.9.0"
}
}
}
provider "grafana" {
alias = "asserts"
url = "<Stack-URL>"
auth = "<Service-account-token>"
stack_id = "<Stack-ID>"
}
- 다음 필드 값을 바꿔요:
<Stack-URL>을 Grafana 스택의 URL로(예:https://my-stack.grafana.net/)<Service-account-token>을 만든 서비스 계정 토큰으로<Stack-ID>를 Grafana Cloud 스택 ID로
Note knowledge graph 리소스가 리소스가 속한 스택을 식별하려면
stack_id매개변수가 필수예요.
Terraform 구성 적용 (Apply Terraform configurations)
Terraform 구성 파일을 만든 후 다음 명령어로 적용해요:
- Terraform 구성 파일이 들어 있는 작업 디렉터리를 초기화해요:
shell
terraform init
- Terraform이 만드는 변경 사항을 미리 보여요:
shell
terraform plan
- 구성 파일을 적용해요:
shell
terraform apply
설정 확인 (Verify your setup)
구성을 적용한 후 다음을 확인해 설정을 검증해요:
- Terraform이 Grafana Cloud 스택으로 인증할 수 있나요
- 제공자가 올바른 스택 ID로 제대로 구성되어 있나요
- Terraform 출력에 오류가 나타나지 않나요
모범 사례 (Best practices)
Terraform으로 knowledge graph 리소스를 관리할 때 다음 모범 사례를 고려해요.
이름 규칙 (Name conventions)
- 각 리소스의 목적을 명확히 나타내는 설명적인 이름을 사용해요
- 조직 전체에서 일관된 명명 패턴을 따르세요
- 적절할 때 이름에 환경 또는 팀 식별자를 포함해요
버전 관리 (Version control)
- Terraform 구성을 버전 관리(Git)에 저장해요
- 서로 다른 환경에 별도의 디렉터리나 워크스페이스를 사용해요
- 커밋 메시지에 변경 사항을 문서화해요
상태 관리 (State management)
- 팀 협업을 위해 원격 상태 백엔드를 사용해요
- 동시 수정을 방지하려면 상태 잠금을 활성화해요
- Terraform 상태 파일을 정기적으로 백업해요
보안 (Security)
- 서비스 계정 토큰이나 민감한 데이터를 버전 관리에 커밋하지 마세요
- 자격 증명에는 환경 변수나 시크릿 관리 도구를 사용해요
- 서비스 계정 토큰을 정기적으로 회전해요
다음 단계 (Next steps)
이제 Terraform 제공자를 구성했으니 knowledge graph 리소스 관리를 시작할 수 있어요: