Azure terraform
Learn how to use Terraform for Azure to set up Cobrowse Enterprise in your cloud.
Last updated
Was this helpful?
Learn how to use Terraform for Azure to set up Cobrowse Enterprise in your cloud.
Last updated
Was this helpful?
This is the documentation for how to use our Terraform for Azure to set up Cobrowse Enterprise in your cloud.
You will need the following installed locally:
– at least
Azure CLI
kubectl
These are the steps you'll need to go through to get Cobrowse running:
The first thing you'll need is access to a MongoDB database. Cobrowse will need a connection string containing the address and authentication information for your cluster.
A MongoDB cluster is required for running Cobrowse. We do not provide this as part of the terraform environment.
You will need to create a cluster and provide the connection URL as a part of the Cobrowse configuration. You can either and manage the deployment and backups yourself. Alternatively, we recommend using a hosted service such as . They have a required by many enterprises with compliance requirements.
Terraform requires the Azure CLI to be installed and authenticated.
There are some resources that are not created by our Terraform. You will need to manually create:
A storage bucket to save terraform state (this is optional but strongly recommended)
Add a secret in the key vault called "mongo-url" with the value set to the url of the Mongo database from step 1.
We have provided a small command line utility to help you get started. This utility will gather the required config for your deployment. Run the following command from your terminal:
You can replace "./example" with the directory where you wish to save the configuration data. The directory will be created if it does not exist yet.
Once you have successfully generated a configuration directory via our command line utility you are then ready to deploy the terraform to Azure. Navigate to the configuration directory you created and run the following commands:
This will instruct terraform to prepare the resources it needs to deploy. Run the following command to start the deployment of resources to Azure:
This will list the modifications that terraform will make to your Azure account. If that looks good, type 'yes' to continue the deployment.
Configure your DNS provider with an A record to point to the IP address provisioned by the terraform. We recommend doing this as soon as the IP is provisioned in the Azure portal to prevent DNS propagation delays, although this is not essential
Once the terraform is deployed and the DNS is configured you will have to wait for the certificate to be provisioned. Depending on DNS propagation delays this can take some time (usually between 5 minutes and an hour).
Your Cobrowse instance should now be deployed. Head to /register
on your domain to create an account.
Next, learn about managing and upgrading your deployment.
the Azure CLI
the Azure CLI (hint: az login
)
A resource group for Cobrowse. You create it via the cli or in the Azure portal:
A key vault for Cobrowse secrets. You can do this via the cli or in the Azure portal:
Make sure you have with your access credentials.
Warning: This will store all Terraform state locally. We strongly recommend configuration for almost all deployment scenarios.
The terraform automatically creates an SSL certificate for you using the .