This directory contains ARM templates that provision XAP data grid on Azure VMs
You need to generate Azure service principal
You can deploy the following templates through Azure Portal or Azure XPlat CLI 0.10.0:
- xap-docker-ubuntu-azure.json
- xap-k8s-ubuntu-azure.json
To deploy them using the portal you need to create a custom deployment, copy XAP azure template content to the editor and save it.
To deploy them using the CLI you need to:
- Install the Azure CLI 0.10.0
- Configure the Azure CLI to use your Azure account and subscription
azure login
azure account set "<SUBSCRIPTION NAME OR ID>"
azure config mode arm
With xap-docker-ubuntu-azure.json
template you will be able to deploy an Ubuntu VM with an XAP docker container, such as:
- XAP management node (1 LUS, 1 GSM and n GSCs)
- XAP compute node (n GSCs)
- GS web management console
If you use the Azure CLI you can:
-
Edit parameters placeholders and default values in
xap-docker-ubuntu-azure-parameters.json
. Ensure that 'xapLicense' parameter points to your XAP license key. You might want to change value for 'xapNodeType' parameter to be set to either 'xap-compute-node' or 'gs-webui'. In case of 'xap-compute-node' deployment you will have to edit 'xapLookupLocators' and 'gscCount' parameters values as well. -
Run the following commands:
azure group create --name="<RESOURCE_GROUP_NAME>" --location="<LOCATION>"
azure group deployment create --name="<DEPLOYMENT NAME>" --resource-group="<RESOURCE_GROUP_NAME>" --template-file="azure-templates/xap-docker-ubuntu-azure.json" --parameters-file="azure-templates/xap-docker-ubuntu-azure-parameters.json"
xap-k8s-ubuntu-azure.json
template allows deploying an Azure Container Service cluster with Kubernetes orchestrator and XAP deployments.
- You will need to have an SSH RSA public key. You may follow instructions in acs-engine documentation in order to create a key pair.
- You will need to build XAP docker image using the Dockerfile and push the image to some private docker registry server.
In case you are using the Azure CLI:
- You will need to provide correct paramaters values in
xap-k8s-ubuntu-azure-parameters.json
- Run the following commands:
azure group create --name="<RESOURCE_GROUP_NAME>" --location="<LOCATION>"
azure group deployment create --name="<DEPLOYMENT NAME>" --resource-group="<RESOURCE_GROUP_NAME>" --template-file="azure-templates/xap-k8s-ubuntu-azure.json" --parameters-file="azure-templates/xap-k8s-ubuntu-azure-parameters.json"
- You may want to install kubectl to your local machine. For the remote access you need to configure kubectl by copying
~/.kube/config
from Kubernetes master VM on Azure to your machine and set KUBECONFIG environment variable to point to the kubeconfig. - To access Kubernetes dashboard run
kubectl proxy
and navigate tohttp://localhost:8001/ui
in your browser. - Gigaspaces Web Management console endpoint can be found in the Kubernetes dashboard under 'gs-webui' service or just run
kubectl get service gs-webui
to obtain it.