Log in to the Azure Portal (https://portal.azure.com)
- Select Azure Active Directory from the left side pane or by searching in "All Services"
- Click on App Registrations
- Then click "New application registration"
- Fill out the fields and click "Create" at the bottom. You can put whatever you like into the fields, the fills in our example are just suggestions.
- After the application is created, you will want to get the "Application ID" for it from the overview page. This will be your "Application ID" when entering the credentials in Containership.
- Go into the settings for the Application you just created and select "Keys".
- Create a key for Containership. We suggest selecting "Never expires" for the key expiration so you will not encounter unexpected behavior in Containership when the key expires, however this is obviously up to you.
- After you click save, Azure will encode the value and show the transformed version of it. This is what you will use as your "secret" when configuring with Containership. Make sure you hang on to this value, once you leave the page it will not longer be retrievable.
- After you have your secret go back to the root menu of the "Azure Active Directory". This time click "Properties".
- In properties, copy the "Directory ID". This will be used as the directory id when configuring with Containership.
- Now we need to give the Application the appropriate permissions. At the root navigation of the Azure Portal, select "Subscriptions".
- Select the subscription you would like to use with Containership, hang on to this subscription id as it will also be needed when configuring Containership. In this subscription's options select "Access Control (IAM)"
- Select "Add" at the top. Then set the role as Owner. We suggest the owner role however more refined roles will also work, as long as it has permissions to create, edit, and delete resource groups, storage accounts, virtual networks, subnets, network security groups, public ip addresses, network interfaces, and virtual machines. Then search for the application you previously created in the next box. Select it and click "Save".
- Go back to the options for the subscription you selected and click "Resource Providers" this time.
- Within "Resource Providers" make sure all of the following namespaces are registered, if they are not please register them now.
The account should now be set up for API authorization. Use the
subscription_id mentioned in the steps as the containership provider credentials.
Connecting to Containership Cloud
Now that all of the leg work is complete you are ready to officially connect your Azure account to Containership Cloud. Once logged into Containership, select the organization you want to setup from the drop down in the upper left hand corner and then go to Organization Settings.
Navigate to Providers on the left hand side and select Add Provider
Select Azure and press Continue
Now fill in the fields with the requested information and press Submit
You are now ready to roll! Refer to our cluster launch guide or our cluster launch video for a step by step guide on launching a cluster on Azure using Containership Cloud.