Developer Tutorials
These Aerospike tutorials will help developers quickly learn and enjoy using Aerospike Database. They contain both:
- Concepts – Explanations of common database and Aerospike concepts.
- Code – Functioning Aerospike API code snippets.
Using Jupyter Notebooks
Please accept marketing cookies to view this content.
To install these tutorials as part of a complete Aerospike development environment in a Docker container, go here.
To check out what the development environmment offers, click the "Launch with Binder" link at the beginning of any tutorial. Binder creates a fresh container for your temporary use.
Tutorial Sections
The following types of tutorial are already available:
- Java – Aerospike Java Client API
- Python – Aerospike Python Client API
- Spark – Aerospike Connect for Spark
Aerospike also provides client APIs for Go, Node.js, C, C#, and more.
Please provide feedback and suggestions for new tutorials.
Run Tutorials in a Docker Container
These tutorials can be installed and run locally in a Docker container in just a few minutes. The Docker image contains an interactive Aerospike development environment.
Install Docker.
Get the Docker image.
docker pull aerospike/intro-notebooks
Run the image and expose port 8888:
docker run --name aero-nb -p 8888:8888 aerospike/intro-notebooks
Point your browser at the url with token which should be printed on the output. By default it should be:
http://127.0.0.1:8888/?token=<token>
Example:
$ docker run --name aero-nb -p 8888:8888 aerospike/intro-notebooks
link eth0 state up
link eth0 state up in 0
Set username to: jovyan
usermod: no changes
Executing the command: jupyter notebook
[I 05:28:34.202 NotebookApp] Writing notebook server cookie secret to /home/jovyan/.local/share/jupyter/runtime/notebook_cookie_secret
[I 05:28:34.954 NotebookApp] JupyterLab extension loaded from /opt/conda/lib/python3.8/site-packages/jupyterlab
[I 05:28:34.954 NotebookApp] JupyterLab application directory is /opt/conda/share/jupyter/lab
[I 05:28:34.957 NotebookApp] Serving notebooks from local directory: /home/jovyan/notebooks
[I 05:28:34.957 NotebookApp] Jupyter Notebook 6.1.4 is running at:
[I 05:28:34.957 NotebookApp] http://6a374afd9f00:8888/?token=c45783e6631e305c97f6919905250e61f09049e750813cf6
[I 05:28:34.957 NotebookApp] or http://127.0.0.1:8888/?token=c45783e6631e305c97f6919905250e61f09049e750813cf6
[I 05:28:34.957 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
Docker Installation Options
To get started, There are advanced options for installation, including:
- Building the image from the Git repo.
- Specifying a LOGFILE location for the built-in Aerospike Database.
- Setting up the Spark tutorials on on Linux (CentOS) and MacOS X.
Go here for instructions.
Development Environment Contents
The following software is in the Docker Image:
- Aerospike development software:
- Aerospike Database
- Aerospike Java and Python Client Libraries
- Aerospike Tools
- Jupyter Notebook Server