Back to blog

PostgreSQL Buildfarm Query API: 빌드 상태 데이터 조회 방법

August 05, 2026

Andrew Dunstan · 2026년 6월 11일

PostgreSQL Buildfarm 데이터베이스의 정보를 웹 페이지 스크래핑 없이 조회할 수 있는 PostgreSQL Buildfarm Query API가 공개되었습니다. 이 글에서는 API가 개발된 배경과 특정 Buildfarm 멤버 및 브랜치의 최신 빌드 상태를 확인하는 실제 요청·응답 예시를 소개합니다.

PostgreSQL Buildfarm Query API가 필요한 이유

얼마 전 한 동료가 PostgreSQL Buildfarm 데이터베이스를 조회할 수 있는 API가 있느냐고 물었습니다. 당시에는 이용할 수 있는 API가 없었습니다.

그동안 여러 사람이 Buildfarm 데이터를 얻기 위해 웹 페이지를 스크래핑해 왔다는 사실을 알고 있었기 때문에 더 나은 방법이 필요하다고 생각했습니다. 그래서 Claude Code의 도움을 조금 받아 PostgreSQL Buildfarm Query API를 만들었습니다.

이 API는 현재 바로 사용할 수 있습니다. 엔드포인트와 사용 방법에 대한 전체 설명은 PGBuildFarm server-code 저장소의 API 문서에서 확인할 수 있습니다.

앞으로 이 API를 어떻게 확장하면 더 유용할지에 관한 사용자와 PostgreSQL 커뮤니티의 의견도 기다리고 있습니다.

PostgreSQL Buildfarm API로 최신 빌드 상태 조회하기

다음은 master 브랜치에서 crake 멤버의 최신 상태를 가져오는 API 사용 예시입니다.

$ GET https://buildfarm.postgresql.org/cgi-bin/bfapi.pl/status/master/crake
[
   {
      "architecture" : "x86_64",
      "branch" : "master",
      "build_flags" : [
         "buildtype",
         "cassert",
         "nls",
         "plperl",
         "plpython",
         "pltcl",
         "gssapi",
         "openssl",
         "ldap",
         "xml",
         "libxslt",
         "zlib",
         "readline",
         "tap-tests",
         "uuid",
         "icu",
         "PG_TEST_EXTRA",
         "injection-points",
         "curl",
         "debug",
         "meson",
         "git",
         "integer-datetimes",
         "thread-safety"
      ],
      "compiler" : "gcc",
      "compiler_version" : "16.1.1",
      "git_head_ref" : "7dd15325952fe85521b1fefea3ad39cf1b46e0c8",
      "log_archive_filenames" : [
         "SCM-checkout.log",
         "configure.log",
         "build.log",
         "test-setup.log",
         "check.log",
         "make-doc.log",
         "make-install.log",
         "install-testmodules.log",
         "BlackholeFDW-build.log",
         "RedisFDW-build.log",
         "FileTextArrayFDW-build.log",
         "perl-check.log",
         "BlackholeFDW-install.log",
         "RedisFDW-install.log",
         "FileTextArrayFDW-install.log",
         "misc-check.log",
         "initdb-C.log",
         "startdb-C-1.log",
         "install-check-C.log",
         "RedisFDW-installcheck-C.log",
         "FileTextArrayFDW-installcheck-C.log",
         "stopdb-C-1.log",
         "startdb-C-2.log",
         "misc-installcheck-C.log",
         "stopdb-C-2.log",
         "xversion-upgrade-save.log",
         "xversion-upgrade-HEAD-HEAD.log",
         "xversion-upgrade-REL_18_STABLE-HEAD.log",
         "xversion-upgrade-REL_17_STABLE-HEAD.log",
         "xversion-upgrade-REL_16_STABLE-HEAD.log"
      ],
      "operating_system" : "Fedora",
      "os_version" : "44",
      "report_time" : "2026-06-11 15:17:00.353648+00",
      "snapshot" : "2026-06-11 14:54:18",
      "stage" : "XversionUpgrade-REL_16_STABLE-HEAD",
      "status" : 1,
      "sysname" : "crake",
      "when_ago_secs" : 4607
   }
]

응답에서는 해당 멤버의 아키텍처, 브랜치, 빌드 플래그, 컴파일러, 운영체제, 로그 파일 목록, 빌드 단계 및 보고 시간 등의 정보를 확인할 수 있습니다.

PostgreSQL Buildfarm Query API FAQ

PostgreSQL Buildfarm Query API란 무엇인가요?

PostgreSQL Buildfarm 데이터베이스의 정보를 조회할 수 있도록 공개된 API입니다. 기존처럼 웹 페이지를 스크래핑하지 않고 Buildfarm 데이터를 요청할 수 있습니다.

PostgreSQL Buildfarm API가 개발된 이유는 무엇인가요?

기존에는 여러 사용자가 Buildfarm 데이터를 얻기 위해 웹 페이지를 스크래핑하고 있었습니다. 이러한 방식보다 데이터를 직접 조회할 수 있는 더 나은 방법을 제공하기 위해 API가 만들어졌습니다.

Buildfarm Query API로 어떤 정보를 확인할 수 있나요?

본문의 응답 예시에서는 아키텍처, 브랜치, 빌드 플래그, 컴파일러, 운영체제, 로그 파일, 빌드 단계 및 최신 보고 시간 등의 정보를 확인할 수 있습니다.

특정 Buildfarm 멤버의 최신 상태는 어떻게 조회하나요?

본문 예시처럼 상태 조회 엔드포인트에 브랜치와 멤버 이름을 지정합니다. master 브랜치의 crake 멤버는 /status/master/crake 경로를 사용해 조회합니다.

Buildfarm Query API 문서는 어디에서 확인할 수 있나요?

전체 API 설명은 PGBuildFarm server-code GitHub 저장소의 API.md 문서에서 확인할 수 있습니다.


EDB Postgres AI와 PostgreSQL 커뮤니티, 더 알아보기

EDB의 오픈소스 기여나 EDB Postgres AI가 궁금하시다면 EDB Korea로 문의해 주세요.


원문: Buildfarm Query API (EDB Blog)

Share this