Internet Explorer is no longer supported. Many things will still work, but your experience will be degraded and some things won't function. Please use a modern browser such as Edge, Chrome, or Firefox.

HOWTO: Connect BuildMaster to Azure

view on GitHub

To deploy your applications to Azure App Services, you'll need to first connect to Azure by creating an Azure Service Principal in BuildMaster.

This guide will explain how to find and set up the necessary credentials to create an Azure Service Principal in Azure, and use them to create an Azure Service Principal account in BuildMaster.

Step 1 - Locating your Tenant ID

Log in to your Azure Portal, navigate to your Azure Active Directory and then click "Properties".

Home

Scroll down to the "Tenant ID" section and copy the "Tenant ID", this will be used in a future step.

Tenant ID

Step 2 - Registering and locating your Application ID

Navigate to "App Registrations" on the left and click "New Registration".

New App

Enter a name and select the supported account type and then click "Register". Copy the "Application ID", this will be used in a future step.

Register

Step 3 - Adding and copying your Client Secret

Navigate to "App Registrations" and select your newly created Application.

Select App

Navigate to "Certificates & secrets" on the left and add a new Client Secret.

New Secret

Copy the "Value" (not the Secret ID). This will be used as the "Client Secret" in a future step.

Secret

Step 4 - Creating a Service Principal

Navigate to your Azure Subscription in the root of the Azure Portal and then click "Access control (IAM)" and add a new role assignment.

Select Subscription

Add Role

Locate and click the "Contributor" role under "Privileged administrator roles" and click next.

Contributor

Click "Select Members", then search for and select the app registration you created in Step 5, and click "Select".

Select Members

Click "Review + assign". You will receive a message indicating that the application was added as a contributor to the subscription.

Review Assign

Step 5 - Creating your Azure Service Principal account in Buildmaster

Open BuildMaster, navigate to "Administration" > "Services & Credentials" and click "Add Service Account".

Service Credentials

Add Account

Select "Cloud Service Account" > "Azure Service Principal", and then enter your "Tenant ID", "Application ID", and "Client Secret" from the service principal you created in Azure. Finally, click "Create Azure Service Principal".

Add Principal

Following these steps allows us to create an Azure service principal that we can then use to connect to Buildmaster.

Added Principal