com.microsoftopentechnologies.azure

Class AzureManagementServiceDelegate

java.lang.Object

com.microsoftopentechnologies.azure.AzureManagementServiceDelegate

public class AzureManagementServiceDelegate
extends Object

Business delegate class which handles calls to Azure management service SDK.

Author:

Suresh Nallamilli (snallami@gmail.com)

Constructor Summary

Constructors

Constructor and Description
AzureManagementServiceDelegate()

Method Summary

Methods

Modifier and Type	Method and Description
static ArrayList<com.microsoft.windowsazure.management.compute.models.ResourceExtensionReference>	addResourceExtenions(String roleName, String storageAccountName, String storageAccountKey, String containerName, String blobURL, String fileName, String jenkinsServerURL) Adds BGInfo and CustomScript extension
static boolean	checkIfCloudServiceNameAvailable(com.microsoft.windowsazure.management.compute.ComputeManagementClient client, String cloudServiceName) Checks if cloud service name is available.
static String	createStorageAccount(com.microsoft.windowsazure.Configuration config, String location)
static AzureSlave	createVirtualMachine(AzureSlaveTemplate template) Handles virtual machine creation in azure as per the configuration in slave template.
static String	getCustomScriptPrivateConfigValue(String storageAccountName, String storageAccountKey) JSON string for custom script private config value
static String	getCustomScriptPublicConfigValue(String sasURL, String fileName, String jenkinsServerURL, String vmName) JSON string custom script public config value
static Map<ImageProperties,String>	getImageProperties(com.microsoft.windowsazure.Configuration config, String imageIDOrFamily) Returns image properties
static int	getRoleCount(com.microsoft.windowsazure.management.compute.ComputeManagementClient client, String cloudServiceName) Retrieves count of role instances in a cloud service
static List<String>	getStorageAccountsInfo(com.microsoft.windowsazure.Configuration config)
static Set<String>	getVirtualImageFamilyList(com.microsoft.windowsazure.Configuration config)
static Set<String>	getVirtualImageFamilyList(String subscriptionId, String serviceManagementCert, String passPhrase, String serviceManagementURL) Returns virtual machine family list
static int	getVirtualMachineCount(com.microsoft.windowsazure.management.compute.ComputeManagementClient client) Retrieves count of virtual machine roles in a azure subscription
static List<String>	getVirtualMachineLocations(com.microsoft.windowsazure.Configuration config) Gets list of Azure datacenter locations which supports Persistent VM role
static List<String>	getVirtualMachineLocations(String subscriptionId, String serviceManagementCert, String passPhrase, String serviceManagementURL) Gets list of Azure datacenter locations which supports Persistent VM role
static String	getVirtualMachineStatus(com.microsoft.windowsazure.Configuration config, String cloudServiceName, com.microsoft.windowsazure.management.compute.models.DeploymentSlot slot, String VMName) Gets current status of virtual machine
static List<String>	getVMSizes(com.microsoft.windowsazure.Configuration config) Gets list of virtual machine sizes
static List<String>	getVMSizes(String subscriptionId, String serviceManagementCert, String passPhrase, String serviceManagementURL) Gets list of virtual machine sizes
static ArrayList<com.microsoft.windowsazure.management.compute.models.ResourceExtensionReference>	handleCustomScriptExtension(com.microsoft.windowsazure.Configuration config, String roleName, String cloudServiceName, AzureSlaveTemplate template) Adds custom script extension
static void	handleProvisioningException(Exception ex, AzureSlaveTemplate template, String deploymentName) Handle provisioning errors
static String	isValidCustomImageID(String imageID, Map<ImageProperties,String> imageProps, com.microsoft.windowsazure.Configuration config) Checks whether custom image ID is valid or not
static String	isValidImageFamily(String imageFamily, Map<ImageProperties,String> imageProperties, com.microsoft.windowsazure.Configuration config) Checks whether image family is valid or not
static String	isValidImageID(String imageID, Map<ImageProperties,String> imageProps, com.microsoft.windowsazure.Configuration config) Checks whether image ID is valid or not
static boolean	isVirtualMachineExists(AzureSlave slave)
static void	restartVirtualMachine(AzureSlave slave) Restarts Azure virtual machine
static void	setVirtualMachineDetails(AzureSlave azureSlave, AzureSlaveTemplate template) Sets properties of virtual machine like IP and ssh port
static void	shutdownVirtualMachine(AzureSlave slave) Shutdowns Azure virtual machine
static void	startVirtualMachine(AzureSlave slave) Starts Azure virtual machine
static void	terminateVirtualMachine(AzureSlave slave, boolean sync) Deletes Azure virtual machine
static boolean	validateCloudServiceName(com.microsoft.windowsazure.Configuration config, String cloudServiceName)
static String	verifyConfiguration(com.microsoft.windowsazure.Configuration config)
static String	verifyConfiguration(String subscriptionId, String serviceManagementCert, String passPhrase, String serviceManagementURL) Validates certificate configuration
static String	verifyNoOfExecutors(String noOfExecutors)
static String	verifyRetentionTime(String retentionTimeInMin)
static List<String>	verifyTemplate(String subscriptionId, String serviceManagementCert, String passPhrase, String serviceManagementURL, String maxVirtualMachinesLimit, String templateName, String labels, String location, String virtualMachineSize, String storageAccountName, String noOfParallelJobs, String imageIdOrFamily, String slaveLaunchMethod, String initScript, String adminUserName, String adminPassword, String retentionTimeInMin, String cloudServiceName, String templateStatus, String jvmOptions, boolean returnOnSingleError) Verifies template configuration by making server calls if needed

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AzureManagementServiceDelegate

public AzureManagementServiceDelegate()

Method Detail

createVirtualMachine

public static AzureSlave createVirtualMachine(AzureSlaveTemplate template)
                                       throws AzureCloudException

Handles virtual machine creation in azure as per the configuration in slave template.

Parameters:

template - Slave template configuration as defined in global configuration.

Returns:

instance of Azure slave which holds necessary details of virtual machine and cloud details.

Throws:

AzureCloudException - throws exception in case of any error during virtual machine creation.

handleProvisioningException

public static void handleProvisioningException(Exception ex,
                               AzureSlaveTemplate template,
                               String deploymentName)
                                        throws AzureCloudException

Handle provisioning errors

Throws:

AzureCloudException

handleCustomScriptExtension

public static ArrayList<com.microsoft.windowsazure.management.compute.models.ResourceExtensionReference> handleCustomScriptExtension(com.microsoft.windowsazure.Configuration config,
                                                                                                                     String roleName,
                                                                                                                     String cloudServiceName,
                                                                                                                     AzureSlaveTemplate template)
                                                                                                                              throws AzureCloudException

Adds custom script extension

Parameters:

config - Azure cloud config object

roleName - rolename

cloudServiceName - cloud service name

template - slave template configuration

Returns:

List of ResourceExtensionReference

Throws:

AzureCloudException

addResourceExtenions

public static ArrayList<com.microsoft.windowsazure.management.compute.models.ResourceExtensionReference> addResourceExtenions(String roleName,
                                                                                                              String storageAccountName,
                                                                                                              String storageAccountKey,
                                                                                                              String containerName,
                                                                                                              String blobURL,
                                                                                                              String fileName,
                                                                                                              String jenkinsServerURL)
                                                                                                                       throws Exception

Adds BGInfo and CustomScript extension

Throws:

Exception

getCustomScriptPublicConfigValue

public static String getCustomScriptPublicConfigValue(String sasURL,
                                      String fileName,
                                      String jenkinsServerURL,
                                      String vmName)
                                               throws Exception

JSON string custom script public config value

Throws:

Exception

getCustomScriptPrivateConfigValue

public static String getCustomScriptPrivateConfigValue(String storageAccountName,
                                       String storageAccountKey)
                                                throws Exception

JSON string for custom script private config value

Throws:

Exception

setVirtualMachineDetails

public static void setVirtualMachineDetails(AzureSlave azureSlave,
                            AzureSlaveTemplate template)
                                     throws Exception

Sets properties of virtual machine like IP and ssh port

Parameters:

azureSlave -

template -

Throws:

Exception

isVirtualMachineExists

public static boolean isVirtualMachineExists(AzureSlave slave)

validateCloudServiceName

public static boolean validateCloudServiceName(com.microsoft.windowsazure.Configuration config,
                               String cloudServiceName)
                                        throws Exception

Throws:

Exception

checkIfCloudServiceNameAvailable

public static boolean checkIfCloudServiceNameAvailable(com.microsoft.windowsazure.management.compute.ComputeManagementClient client,
                                       String cloudServiceName)

Checks if cloud service name is available.

Parameters:

client - ComputeManagementClient

cloudServiceName - cloudServiceName

Returns:

Throws:

IOException

com.microsoft.windowsazure.exception.ServiceException

ParserConfigurationException

SAXException

getVirtualMachineLocations

public static List<String> getVirtualMachineLocations(String subscriptionId,
                                      String serviceManagementCert,
                                      String passPhrase,
                                      String serviceManagementURL)
                                               throws IOException,
                                                      com.microsoft.windowsazure.exception.ServiceException,
                                                      ParserConfigurationException,
                                                      SAXException

Gets list of Azure datacenter locations which supports Persistent VM role

Throws:

IOException

com.microsoft.windowsazure.exception.ServiceException

ParserConfigurationException

SAXException

getVirtualMachineLocations

public static List<String> getVirtualMachineLocations(com.microsoft.windowsazure.Configuration config)
                                               throws IOException,
                                                      com.microsoft.windowsazure.exception.ServiceException,
                                                      ParserConfigurationException,
                                                      SAXException

Gets list of Azure datacenter locations which supports Persistent VM role

Throws:

IOException

com.microsoft.windowsazure.exception.ServiceException

ParserConfigurationException

SAXException

getStorageAccountsInfo

public static List<String> getStorageAccountsInfo(com.microsoft.windowsazure.Configuration config)
                                           throws Exception

Throws:

Exception

createStorageAccount

public static String createStorageAccount(com.microsoft.windowsazure.Configuration config,
                          String location)
                                   throws Exception

Throws:

Exception

getVMSizes

public static List<String> getVMSizes(String subscriptionId,
                      String serviceManagementCert,
                      String passPhrase,
                      String serviceManagementURL)
                               throws IOException,
                                      com.microsoft.windowsazure.exception.ServiceException,
                                      ParserConfigurationException,
                                      SAXException

Gets list of virtual machine sizes

Throws:

IOException

com.microsoft.windowsazure.exception.ServiceException

ParserConfigurationException

SAXException

getVMSizes

public static List<String> getVMSizes(com.microsoft.windowsazure.Configuration config)
                               throws IOException,
                                      com.microsoft.windowsazure.exception.ServiceException,
                                      ParserConfigurationException,
                                      SAXException

Gets list of virtual machine sizes

Throws:

IOException

com.microsoft.windowsazure.exception.ServiceException

ParserConfigurationException

SAXException

verifyConfiguration

public static String verifyConfiguration(String subscriptionId,
                         String serviceManagementCert,
                         String passPhrase,
                         String serviceManagementURL)

Validates certificate configuration

Parameters:

subscriptionId -

serviceManagementCert -

passPhrase -

serviceManagementURL -

Returns:

verifyConfiguration

public static String verifyConfiguration(com.microsoft.windowsazure.Configuration config)

getVirtualMachineStatus

public static String getVirtualMachineStatus(com.microsoft.windowsazure.Configuration config,
                             String cloudServiceName,
                             com.microsoft.windowsazure.management.compute.models.DeploymentSlot slot,
                             String VMName)
                                      throws Exception

Gets current status of virtual machine

Parameters:

config -

cloudServiceName -

slot -

VMName -

Returns:

Throws:

Exception

getRoleCount

public static int getRoleCount(com.microsoft.windowsazure.management.compute.ComputeManagementClient client,
               String cloudServiceName)
                        throws Exception

Retrieves count of role instances in a cloud service

Throws:

Exception

getVirtualMachineCount

public static int getVirtualMachineCount(com.microsoft.windowsazure.management.compute.ComputeManagementClient client)
                                  throws Exception

Retrieves count of virtual machine roles in a azure subscription

Throws:

Exception

shutdownVirtualMachine

public static void shutdownVirtualMachine(AzureSlave slave)
                                   throws Exception

Shutdowns Azure virtual machine

Throws:

Exception

terminateVirtualMachine

public static void terminateVirtualMachine(AzureSlave slave,
                           boolean sync)
                                    throws Exception

Deletes Azure virtual machine

Throws:

Exception

restartVirtualMachine

public static void restartVirtualMachine(AzureSlave slave)
                                  throws Exception

Restarts Azure virtual machine

Throws:

Exception

startVirtualMachine

public static void startVirtualMachine(AzureSlave slave)
                                throws Exception

Starts Azure virtual machine

Throws:

Exception

getVirtualImageFamilyList

public static Set<String> getVirtualImageFamilyList(com.microsoft.windowsazure.Configuration config)
                                             throws Exception

Throws:

Exception

getVirtualImageFamilyList

public static Set<String> getVirtualImageFamilyList(String subscriptionId,
                                    String serviceManagementCert,
                                    String passPhrase,
                                    String serviceManagementURL)
                                             throws Exception

Returns virtual machine family list

Throws:

Exception

isValidImageID

public static String isValidImageID(String imageID,
                    Map<ImageProperties,String> imageProps,
                    com.microsoft.windowsazure.Configuration config)

Checks whether image ID is valid or not

isValidCustomImageID

public static String isValidCustomImageID(String imageID,
                          Map<ImageProperties,String> imageProps,
                          com.microsoft.windowsazure.Configuration config)

Checks whether custom image ID is valid or not

isValidImageFamily

public static String isValidImageFamily(String imageFamily,
                        Map<ImageProperties,String> imageProperties,
                        com.microsoft.windowsazure.Configuration config)

Checks whether image family is valid or not

getImageProperties

public static Map<ImageProperties,String> getImageProperties(com.microsoft.windowsazure.Configuration config,
                                             String imageIDOrFamily)

Returns image properties

verifyTemplate

public static List<String> verifyTemplate(String subscriptionId,
                          String serviceManagementCert,
                          String passPhrase,
                          String serviceManagementURL,
                          String maxVirtualMachinesLimit,
                          String templateName,
                          String labels,
                          String location,
                          String virtualMachineSize,
                          String storageAccountName,
                          String noOfParallelJobs,
                          String imageIdOrFamily,
                          String slaveLaunchMethod,
                          String initScript,
                          String adminUserName,
                          String adminPassword,
                          String retentionTimeInMin,
                          String cloudServiceName,
                          String templateStatus,
                          String jvmOptions,
                          boolean returnOnSingleError)

Verifies template configuration by making server calls if needed

Throws:

Exception

verifyNoOfExecutors

public static String verifyNoOfExecutors(String noOfExecutors)

verifyRetentionTime

public static String verifyRetentionTime(String retentionTimeInMin)