Terraform으로 Git Sync 설정

Terraform으로 Git Sync 설정 (Set up Git Sync with Terraform)

이 문서는 Grafana 프로비저닝 앱 플랫폼(app platform)에서 Terraform을 사용해 Git Sync를 구성하는 방법을 안내해요. 사전 준비, Grafana provider 구성, 그리고 Git Sync를 사용하기 위한 리소스 생성까지 다뤄요.

출처: 문서

본문

Grafana 프로비저닝 앱 플랫폼(app platform)에서 Terraform을 사용해 Git Sync를 구성할 수도 있어요.

시작하기 전에 (Before you begin)

시작하기 전에 다음 항목을 준비해요:

Grafana Cloud 계정 또는 온프레미스 Grafana 인스턴스.
Grafana 스택/인스턴스의 관리자 권한.
머신에 설치된 Terraform 1.11 이상. 자세한 내용은 Terraform 설치 문서를 참고해요.

Note 다음의 모든 Terraform 구성 파일을 같은 디렉터리에 저장해요.

Grafana provider 구성 (Configure the Grafana provider)

Git Sync를 설정하는 데 필요한 인증으로 Grafana provider를 구성하려면 이 Terraform 구성을 사용해요.

Grafana에서 서비스 계정과 토큰을 만들어요. 자세한 내용은 Service account tokens 또는 Create and manage a Grafana Cloud stack using Terraform을 참고해요.
토큰에 Admin 또는 Provisioning:Repositories writer 권한이 있는지 확인해요.
main.tf 파일을 만들고 다음 내용을 추가해요:

   terraform {
     required_providers {
       grafana = {
         source  = "grafana/grafana"
         version = ">= 4.28.1"
       }
     }
   }

   provider "grafana" {
     url = "https://<your-stack>.grafana.net/"
     auth = var.grafana_service_account_token
     stack_id = var.grafana_stack_id
   }

다음 필드 값을 바꿔주세요:

<Stack-URL> — Grafana 스택의 URL (예: https://my-stack.grafana.net/)
<Service-account-token> — 생성한 서비스 계정 토큰 (또는 기본 인증용 <USERNAME>:<PASSWORD>)
<Stack-ID> — Grafana Cloud 스택을 사용한다면 Grafana 스택 ID

Caution Git Sync Terraform 리소스는 App Platform 리소스이며 Grafana 스택의 API와 직접 통신해요. 이 구성에서는 Grafana Cloud provider 설정을 사용하지 마세요. url과 auth로 provider를 구성해요(cloud_api_url과 cloud_access_policy_token은 사용하지 않아요). Grafana Cloud를 사용한다면 stack_id를 스택 ID로 설정해요.

Git Sync를 사용하기 위한 리소스 생성 (Create the resources to use Git Sync)

Git Sync를 구성하고 관리하려면 두 개의 리소스가 필요해요:

저장소(repository) 리소스 — Grafana 리소스를 동기화할 Git 저장소를 구성해요. 예시는 Terraform 레지스트리의 Repository resource를 참고해요.
연결(connection) 리소스 — Git provider 자격 증명을 구성해요. 예시는 Terraform 레지스트리의 Connection resource를 참고해요.

필요한 리소스에 대한 자세한 이해를 위해 Git Sync 핵심 개념을 참고해요.

더 알아보기

원문 문서