Skip to content
This repository has been archived by the owner on Sep 19, 2024. It is now read-only.

Latest commit

 

History

History
74 lines (44 loc) · 3.74 KB

README.md

File metadata and controls

74 lines (44 loc) · 3.74 KB

azure-templates

This directory contains ARM templates that provision XAP data grid on Azure VMs

Pre-requirements

You need to generate Azure service principal

Deployment notes

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

Run XAP components with Docker on Azure

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"

Run XAP data-grid with Kubernetes on Azure

xap-k8s-ubuntu-azure.json template allows deploying an Azure Container Service cluster with Kubernetes orchestrator and XAP deployments.

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 to http://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.