How to Install in an Azure Container Instance
Pre-requisites
Before installing an agent on an Azure Container Instance, you will need access to Azure CLI in order to run the container provisioning command. You can either make use of an Azure Cloud Shell, or install the Azure CLI on your computer. For the purposes of this installation guide we will use an locally installed Azure CLI, however the same commands can be run in an Azure Cloud Shell.
You can find documentation on how to install the Azure CLI, along with the installer here - Azure CLI Setup.
You will also need an Azure Subscription and a Resource Group to host the agent.
Installing the Agent
Follow along with the below instructions to install and configure the Loome Agent on an Azure Container Instance.
Complete the Agent configuration wizard
On the agent slide-out you will need to complete a few pieces of information to get started.
Provide an Agent Name for your Agent, this should be lowercase alpha-numeric, and can include hyphens.
You can then provide the name of an existing Resource Group in your Azure Subscription. If you don’t yet have one, go to portal.azure.com and create a new Resource Group.
Then select your Resource Location. It will determine what Azure Region the container is created in.
Once you’ve completed these steps, use the copy button next to the Azure CLI command to put the command in to your clipboard.
You can also use the Azure RM command if you have Azure RM installed.
Using Azure CLI to create the Agent
Open a command prompt from your machine. If you are not logged in to Azure CLI, you can type in az login and hit enter.
This process will open a browser and ask you to log in to Azure with your Microsoft credentials. This will then authorize your Azure CLI session.
Once complete you can close the browser and return to the command prompt window.
Now paste the Azure CLI command that you copied earlier from the Agent slide-out in to the command prompt window. You can tab back to the window and copy the command again if need be.
Press enter to start configuration of the Agent.
You should now see a message that the configuration is in progress. This may take several minutes to complete.
Once completed, you will see a JSON output of the configuration. You do not need to do anything with this output and can discard the Command Prompt window.
Completing additional configuration in the Azure Portal
Before we can use the Agent, we need to complete additional configuration on the Azure Container Instance containing the Agent.
We will configure the Agent with a Managed System Identity, and then provide it permissions to provision and manage resources within the Subscription.
Browse to portal.azure.com and locate the Resource Group where you provisioned the Container Instance and then click on it.
Locate the Identity menu option and click on it.
Under the System Assigned (preview) tab, click the On toggle for the Status.
Click the Save button above.
When prompted, click Yes to the confirmation.
Now click on the Azure Role Assignments button.
Click the Add Role Assignment (preview) button to add a new Role Assignment.
Select Subscription for the Scope, Select your Subscription, and then select Contributor for the Role.
Click Save to add this Role Assignment.
Repeat this step until you have all of the Roles in the below table assigned.
| Scope | Subscription | Role |
|---|---|---|
| Subscription | Your Subscription | Contributor |
| Subscription | Your Subscription | User Access Administrator |
| Subscription | Your Subscription | Resource Policy Contributor |
Your Role Assignments should look like this once completed.
Click on the Agent name near the top left of the screen.
Now let’s restart the Container Instance so the Agent can connect to Loome Assist.
Click on the Restart button near the top, and click Yes to the confirmation message.
Now click on Container on the left hand menu, and confirm the status of the container is Running.
You should now be able to go back to the Loome Assist Agent page and confirm that the Agent is connected.
The Agent will display a green status if everything has been configured successfully.
Additional Agent Configuration
You can optionally configure additional agent settings based on your needs.
- If you wish to configure Microsoft Teams integration for Loome Assist, check out the documentation here.
- If you need to configure Firewalls, Proxies, or Anti Virus software then check out the Additional Agent Configuration.