Skip to main content

Hosting on Azure VMSS

The Jarvis agent can be hosted in various ways, one of them is Virtual Machine Scale Sets (VMSS). Azure Virtual Machine Scale Sets let you create and manage a group of load balanced VMs, and the number of VM instances can automatically increase or decrease in response to demand or a defined schedule. Instead of using Jarvis Kubernetes agent, Azure VMSS will utilize Jarvis Docker.

Jarvis Agent prerequisites for VMSS​

  1. Jarvis Agent installation ZIP

    1. Open Jarvis self-service web interface as an admin user
    2. Navigate to the "Administration" section and open the "Agents" tab
    3. Add a New Agent in the top right corner
    4. Select vCenter, then "Docker" and provide a name for the new agent (copy the name aside as we'll use it later on in the configuration process)
    5. Click "skip for now"

  2. Jarvis API long token - Jarvis long token allows API access without the need to refresh token once it's expires. It's possible to use the API references or the Jarvis self-service web interface to generate such a token.

    Long token generation

Creating an VMSS in Azure​

  1. Navigate to portal.azure.com and search for VMSS.

  2. click on "Create"

  3. Choose a base image for you VMSS while making sure the image ships with docker pre-installed or supports docker execution. Here is an example for an Ubuntu based image shipped with pre-installed Docker.

  4. Change to the "Advanced" tab, and use the following installation code script in the Custom data section under Custom data and cloud init. The following code will use the Jarvis API to install, execute and register the new agent on the VMSS machines once they are launched.

  5. Make sure to replace the TOKEN with the token you generated earlier in Toruqe API or self-service, and the AGENT with the name of the torque agent you wish to create.

  6. Finish the VMSS creation wizard and wait for the VMS to be created.

Validating the installation​

To validate that a new Jarvis agent was launched following VMSS creation:

  1. log into the newly created machine (we used ssh in this example) and run the following:

    sudo docker ps -a

    In case the installation process ended successfully, you should see two docker containers running on the VM:

  2. Login into the Jarvis web-interface and make sure the new agent is marked as "Active" in the Toruqe administration/agents tab.

Troubleshooting​

In case an error occurred or the Jarvis agent is not presented as Active, make sure to go over the cloud-init logs for more information.

sudo cat /var/log/cloud-init-output.log