Skip to main content
We are excited to be a part of AWS re:Invent 2024. Visit us at booth #1844 in Las Vegas.More info
Loading
Version: Operator 2.5.0

YAML Configuration Mapping for Aerospike on Kubernetes

Mapping Between YAML and Aerospike Configuration​

Kubernetes uses YAML configuration files whereas the Aerospike DB uses its own format for configuration. The Aerospike DB configurations are stored in aerospike.conf.

The Aerospike Kubernetes Operator translates its YAML configurations to the Aerospike server's aerospike.conf format.

Translation Conventions​

These are the rules we used to translate between the Aerospike Kubernetes Operator's YAML and Aerospike DB's aerospike.conf format.

Simple Key and Values​

Most simple key-value pairs file translate directly, with the exception of storage sizes.

YAML

replication-factor: 2
memory-size: 4294967296

aerospike.conf

replication-factor 2
memory-size 4G

Storage Sizes​

Memory, file, and device sizes in the YAML format are integers and need to be specified as number of bytes. In aerospike.conf you may optionally provide a unit as a string.

YAML

memory-size: 4294967296 # 4G

Or

memory-size: 419430400  # 400M

aerospike.conf

memory-size 4G
memory-size 400M

Lists of Simple Values​

YAML uses a key's plural form when there are a list of values (and it uses a list type).

Lists of simple values are written in Aerospike by repeating the same configuration key multiple times.

YAML

addresses:
  - 192.168.1.1
  - 192.168.5.1

aerospike.conf

address 192.168.1.1
address 192.168.5.1

YAML

files:
  - /opt/aerospike/ns1.dat
  - /opt/aerospike/ns2.dat

aerospike.conf

file /opt/aerospike/ns1.dat
file /opt/aerospike/ns2.dat

Fixed Sections​

The Aerospike configuration has sections grouping parts of the configuration together. The YAML forms of these are represented as maps.

YAML

service:
  service-threads: 4
  proto-fd-max: 15000

aerospike.conf

service {
  service-threads 4
  proto-fd-max 15000
}

Named Sections​

Named sections which can have multiple named entries in aerospike.conf file (eg namespace, dc, datacenter, etc.) will be translated to a named list of maps in YAML.

The name of the list will be the plural form of the aerospike.conf section.

YAML

namespaces:
  - name: test
    replication-factor: 2
    memory-size: 4294967296
    storage-engine:
      type: device
      files:
        - /opt/aerospike/data/test1.dat
        - /opt/aerospike/data/test2.dat
      filesize: 4294967296
      data-in-memory: true
  - name: bar
    replication-factor: 2
    memory-size: 4294967296
    storage-engine:
      type: memory

aerospike.conf

namespace test {
    replication-factor 2
    memory-size 4G
    storage-engine device {
            file /opt/aerospike/data/test1.dat
            file /opt/aerospike/data/test2.dat
            filesize 4G
            data-in-memory true
    }
}
namespace bar {
    replication-factor 2
    memory-size 4G
    storage-engine memory
}

Typed Sections​

Typed sections have a fixed enum type associated with them in aerospike.conf (eg storage-engine, index-type, etc.) and will be translated to map with additional property type in YAML. The valid values for type will be the valid enum values for the section.

YAML

namespaces:
  - name: test
    .
    .
    storage-engine:
      type: device
      files:
        - /opt/aerospike/data/test1.dat
        - /opt/aerospike/data/test2.dat
      filesize: 4294967296
      data-in-memory: true

aerospike.conf

namespace test {
    .
    .
    storage-engine device {
            file /opt/aerospike/data/test1.dat
            file /opt/aerospike/data/test2.dat
            filesize 4G
            data-in-memory true
    }
}

Aerospike logging section​

The Yaml logging section comprises a list of log sinks, where Aerospike offers three types: file, console, and syslog (introduced in version 6.3). The type of log sink is specified by the name field in the YAML file, which can have the values console, syslog, or the actual file name if the sink type is file. Users can define the logging context and log level for the log sink as key: value pairs. To learn more about configuring Aerospike logging, please refer to the official Aerospike logging documentation.

YAML

logging:
  - name: console
    any: info
  - name: /var/log/aerospike/aerospike.log
    any: info
    tls: debug
  - name: syslog
    audit: info
    facility: local0
    tag: aerospike-audit
    path: /dev/log

aerospike.conf

logging {
    console {
        context any info
    }
    file /var/log/aerospike/aerospike.log {
        context any info
        context tls debug
    }
    syslog {
        context audit info
        facility local0
        tag aerospike-audit
        path /dev/log
    }
}

Complete Example​

YAML

service:
  proto-fd-max: 15000

security: {}

logging:
  - name: console
    any: info
  - name: /var/log/aerospike/aerospike.log
    any: info

xdr:
  enable-xdr: true
  xdr-digestlog-path: /opt/aerospike/xdr/digestlog 5G
  xdr-compression-threshold: 1000
  datacenters:
    - name: REMOTE_DC_1
      dc-node-address-ports:
       - 172.68.17.123 3000
      dc-security-config-file: /etc/aerospike/secret/security_credentials_DC1.txt

namespaces:
  - name: test
    enable-xdr: true
    xdr-remote-datacenter: REMOTE_DC_1
    replication-factor: 2
    memory-size: 4294967296
    storage-engine:
      type: device
      files:
        - /opt/aerospike/data/test.dat
      filesize: 4294967296
      data-in-memory: true # Store data in memory in addition to file.

mod-lua:
  user-path: /opt/aerospike/usr/udf/lua

aerospike.conf


service {                # Tuning parameters and process owner
    proto-fd-max 15000
}

security {               # (Optional, Enterprise Edition only) to enable
                         # ACL on the cluster
    enable-security true
}

logging {               # Logging configuration
    console {
        context any info
    }
    file /var/log/aerospike/aerospike.log {
        context any info
    }
}

xdr {
    enable-xdr true # Globally enable/disable XDR on local node.
    xdr-digestlog-path /opt/aerospike/digestlog 5G # Track digests to be shipped.
    xdr-compression-threshold 1000
    datacenter REMOTE_DC_1 {
            dc-node-address-port 172.68.17.123 3000
            dc-security-config-file /etc/aerospike/secret/security_credentials_DC1.txt
    }
}

namespace test {       # Define namespace record policies and storage engine
    enable-xdr true
    xdr-remote-datacenter REMOTE_DC_1
    replication-factor 2
    memory-size 4G
    storage-engine device {
            file /opt/aerospike/data/test.dat
            filesize 4G
            data-in-memory true # Store data in memory in addition to file.
    }
}

mod-lua {                # location of UDF modules
    user-path /opt/aerospike/usr/udf/lua
}
Last updated on