The current guide describes how to deploy Aspire 5 directly into a VM (Linux or Windows).
Follow the steps at Configuring Aspire Maven Repository using your registered credentials for maven to be able to download the Aspire artifacts.
The Aspire Distribution Maven Archetype allows for building aspire distributions consistently and easily.
Create the distribution archetype project with maven
You will be prompted with the following parameters (sample configuration):
You will see a folder with the name entered in the 'artifactId' parameter, change your current directory into it
Build the distribution
This generates the distribution into the 'target' folder
Copy your distribution to where you want it to be installed
If installing on Linux, give execution permissions to the bin/aspire.sh file:
Aspire 5 differs from previous versions of Aspire in its architecture which impacts the way it is deployed. See Aspire 5.0 Architecture for more information.
There are two types of nodes that can be deployed: manager and worker nodes. At a minimum there should be 1 manager and 1 worker node on any Aspire deployment.
The same aspire distribution can act as both manager and worker at the same time, which is usually ideal for installing POCs, as it is simpler to maintain only one distribution.
Follow the steps above to create distributions for the different nodes in your cluster.
Aspire 5 requires connectivity to Elasticsearch, for this a set of environment variables must be set up for Aspire to be able to connect the it. See Properties at the ElasticsearchNoSQLProvider section for more details.
If you are connecting to an unsecured, HTTP only elasticsearch instance the only variable you need is:
If it isn't set, this variable will default to:
Change directory to one of the aspire distributions previously built, and upload its settings file:
Now upload the license:
On the vm that will host the manager node
On the VM that will host the worker node:
On the VM that will host Aspire:
By default Aspire will start in port 50505.
The worker nodes only exposes the debug console at http://localhost:50505/aspire