Installation ยป Production Rack
Microsoft Azure
Please note that these are instructions for installing a Rack via the command line. The easiest way to install a Rack is with the Convox Web Console
Initial Setup
Azure CLI
- Install the Azure CLI
- Run
az login
Terraform
- Install Terraform
Convox CLI
Environment
The following environment variables are required:
ARM_CLIENT_ID
ARM_CLIENT_SECRET
ARM_SUBSCRIPTION_ID
ARM_TENANT_ID
Select Subscription
$ az account list
ARM_SUBSCRIPTION_ID
is theid
ARM_TENANT_ID
is thetenantId
Create Service Principal
$ az account set --subscription="$ARM_SUBSCRIPTION_ID"
$ az ad sp create-for-rbac --name=terraform --role=Owner --scopes="/subscriptions/$ARM_SUBSCRIPTION_ID"
ARM_CLIENT_ID
is theappId
ARM_CLIENT_SECRET
is thepassword
Grant Permissions
$ az ad app permission add --id $ARM_CLIENT_ID --api 00000002-0000-0000-c000-000000000000 --api-permissions 311a71cc-e848-46a1-bdf8-97ff7156d8e6=Scope 824c81eb-e3f8-4ee6-8f6d-de7f50d565b7=Role
$ az ad app permission grant --id $ARM_CLIENT_ID --api 00000002-0000-0000-c000-000000000000 --consent-type AllPrincipals --scope User.Read
$ az ad app permission admin-consent --id $ARM_CLIENT_ID
Install Rack
$ convox rack install azure <name> [param1=value1]...
Available Parameters
Name | Default | Description |
---|---|---|
node_type |
Standard_D3_v3 |
Node instance type |
region |
eastus |
Azure region |
syslog |
Forward logs to a syslog endpoint (e.g. tcp+tls://example.org:1234 ) |