HOWTO: Connect BuildMaster to Azure

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".

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

Step 2 - Registering and locating your Application ID

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

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.

Step 3 - Adding and copying your Client Secret

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

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

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

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.

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

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

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

Step 5 - Creating your Azure Service Principal account in Buildmaster

Open BuildMaster, navigate to "Administration" > "Services & Credentials" and click "Add Service 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".

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