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

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 the id
ARM_TENANT_ID is the tenantId

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 the appId
ARM_CLIENT_SECRET is the password

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
cert_duration	2160h	Certification renew period
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)

Microsoft Azure

Initial Setup

Azure CLI

Terraform

Convox CLI

Environment

Select Subscription

Create Service Principal

Grant Permissions

Install Rack

Available Parameters