G
.github
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
bin
feat: TOOLS-2398 convert yaml to asconf (#1)
cmd
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
conf
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
dist
SERVER-216
docker
feat(docker): TOOLS-4360 help entrypoint that lists the tools the image ships (#141)
log
chore: Enable lint (#77)
pkg
fix(pkg): name .deb files with the dpkg architecture (#138)
schema
feat: TOOLS-3675 Add 8.2 Server Schema based Test cases (#144)
testdata
feat: TOOLS-3675 Add 8.2 Server Schema based Test cases (#144)
testutils
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
.dockerignore
feat(docker): TOOLS-4360 help entrypoint that lists the tools the image ships (#141)
.gitignore
ci(TOOLS-3297): replace Docker builder images with inline container builds and add macOS artifacts (#97)
.gitmodules
ci(TOOLS-3297): replace Docker builder images with inline container builds and add macOS artifacts (#97)
.golangci.yml
deps: TOOLS-3565 Bump Go version and update dependencies (#100)
.pre-commit-config.yaml
[StepSecurity] Apply security best practices (#103)
constants.go
Tools 2790 gen conf (#29)
DEV.md
Tools 2546 make readme build focused (#11)
go.mod
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
go.sum
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
integration_test.go
feat: TOOLS-3675 Add 8.2 Server Schema based Test cases (#144)
LICENSE
Initial commit
main.go
chore: Enable lint (#77)
Makefile
build: TOOLS-4446 upgrade Go to 1.26.8 and update Go modules (#149)
README.md
Tools 2841 (#35)
VERSION
chore(release): bump version to 0.21.4-rc1 (#150)

Asconfig

A CLI tool for managing Aerospike configuration files.

Overview

Asconfig allows you to validate and compare Aerospike configuration using a versioned YAML schema directory. For more information and usage examples see the Aerospike Configuration Tool docs.

Build

Build asconfig using the included makefile and display usage information.

git clone https://github.com/aerospike/asconfig.git
cd asconfig
git submodule update --init
make
./bin/asconfig --help

The built binary is available at bin/asconfig.

Install or uninstall asconfig.

make install
make uninstall

Cleanup build and test files.

make clean

Building rpm, deb, and tar packages is also done using the makefile. You will have to install fpm and rpmbuild to build all of these.

make rpm deb tar

The packages will be available in the pkg/ directory.

Testing

Asconfig has unit and integration tests.

You can run the tests using the make file.

Unit Tests

make unit

Integration Tests

Integration tests require that docker is installed and running. A path to an Aerospike feature key file should be defined at the FEATKEY_DIR environment variable. For more information about the feature key file see the feature-key docs.

FEATKEY_DIR=/path/to/aerospike/features/dir make integration

All Tests

FEATKEY_DIR=/path/to/aerospike/features/dir make test

Test Coverage

FEATKEY_DIR=/path/to/aerospike/features/dir make view-coverage