Aerospike

​

Overview

• Run it directly to get a managed Aerospike container with sensible defaults
• Inherit it in your own runnable to seamlessly add a high-performance NoSQL database to your stack

​

What this template manages

• Aerospike container (aerospike image, configurable tag)
• Network service on port 3000
• Persistent volume for data storage
• Hybrid memory architecture combining DRAM and flash memory for optimal performance

​

Quick start (run directly)

1. Load templates

monk load MANIFEST

2. Run Aerospike with defaults

monk run aerospike/aerospike

3. Customize configuration (recommended via inheritance)

• Preferred: inherit and override variables as shown below.
• Alternative: fork/clone and edit the variables in aerospike.yml, then monk load MANIFEST and run.

​

Configuration

variables:
  image_tag: "ce-6.2.0.7_1"    # container image tag
  service_port: 3000            # service port (env: SERVICE_PORT)

​

Use by inheritance (recommended for apps)

namespace: myapp
db:
  defines: runnable
  inherits: aerospike/aerospike
api:
  defines: runnable
  containers:
    api:
      image: myorg/api
  connections:
    database:
      runnable: db
      service: base-svc
  variables:
    database-host:
      value: <- connection-hostname("database")
    database-port:
      value: "3000"

monk run myapp/api

​

Ports and connectivity

• Service: base-svc on TCP port 3000
• From other runnables in the same process group, use connection-hostname("\<connection-name>") to resolve the DB host.

​

Persistence

• Data path: ${monk-volume-path}/aerospike:/opt/aerospike/data
• All data is automatically persisted to the host volume, ensuring data durability across container restarts.

​

Key features

• High Performance: Optimized for low latency and high throughput operations
• Distributed Architecture: Built-in support for data replication and automatic data distribution
• Fault Tolerance: Automatic failover in case of node failure
• Hybrid Memory: Combines DRAM and flash memory to maximize performance and minimize cost
• Key-Value Model: Supports key-value pairs with complex data types (lists, maps, sets)

​

Use cases

• Real-time bidding platforms
• Fraud detection systems
• Recommendation engines
• E-commerce applications
• Ad tech solutions
• Financial services
• Any application requiring fast data access with high throughput

​

Troubleshooting

• Ensure the host volumes are writable by the container user.
• Check logs:

monk logs -l 500 -f aerospike/aerospike

• Verify the service is listening on the expected port:

monk describe aerospike/aerospike

​

Related tools

• Aerospike Query Language (ASQL): SQL-like query language for Aerospike
• Aerospike Management Console (AMC): Web-based interface for monitoring and managing Aerospike clusters