alpine-packages/packaging/alpine/local/greptimedb

GreptimeDB Alpine Package

Builds greptime from the upstream source release and packages OpenRC service subpackages plus /etc/greptimedb defaults.

Build command:

cargo build --profile nightly --locked --bin greptime --features servers/dashboard

Runtime Layout

Installs /usr/bin/greptime and component OpenRC packages:

• greptimedb-docs: upstream configuration examples and reference files from config/
• greptimedb-standalone-openrc: greptime standalone start
• greptimedb-metasrv-openrc: greptime metasrv start
• greptimedb-datanode-openrc: greptime datanode start
• greptimedb-flownode-openrc: greptime flownode start
• greptimedb-frontend-openrc: greptime frontend start

Default TOML files are installed in /etc/greptimedb. Standalone ports:

• 127.0.0.1:4000: HTTP API and dashboard
• 127.0.0.1:4001: gRPC
• 127.0.0.1:4002: MySQL
• 127.0.0.1:4003: PostgreSQL

Configs bind to localhost by default. Upstream config examples are in /usr/share/doc/greptimedb/config.

OpenRC Usage

Standalone:

apk add greptimedb greptimedb-docs greptimedb-standalone-openrc
rc-update add greptimedb.standalone default
rc-service greptimedb.standalone start

Distributed components:

apk add \
  greptimedb \
  greptimedb-metasrv-openrc \
  greptimedb-datanode-openrc \
  greptimedb-flownode-openrc \
  greptimedb-frontend-openrc

Wrapper settings in /etc/conf.d/greptimedb.<component>:

• GREPTIMEDB_CONFIG: config file path passed with -c
• GREPTIMEDB_LOG_DIR: component log directory passed with --log-dir
• GREPTIMEDB_DATA_HOME: data directory passed with --data-home where the component supports it
• GREPTIMEDB_WAL_DIR: datanode WAL directory passed with --wal-dir
• GREPTIMEDB_OPTS: extra component arguments appended after package defaults
• GREPTIMEDB_GLOBAL_OPTS: arguments inserted before the component command

Package Commands

Refresh checksums:

ALPINE_PACKAGE=greptimedb mise run apk:checksum

Build:

ALPINE_PACKAGE=greptimedb mise run apk:build

Install-test local build:

ALPINE_PACKAGE=greptimedb SKIP_BUILD=1 mise run apk:test-install

Install-test published repository:

ALPINE_PACKAGE=greptimedb \
SKIP_BUILD=1 \
ALPINE_REPOSITORY_URL=https://code.factoring.digital/api/packages/public/alpine/v3.24/alpine-packages \
ALPINE_REPOSITORY_KEY_URL=https://code.factoring.digital/api/packages/public/alpine/key \
mise run apk:test-install

Full builds take close to an hour.