Configure infrastructure

This guide is intended to help set up an environment for apps that live outside of Hub.

Prerequisites

• You have created a new app and you want to release it

• You have created a pipeline in Azure DevOps

  • Your app needs to have the right configured YAML files. Using the Queue Management application as a reference, use azure-pipelines.yml and deploy.yml. Adjust these files for your application after creating a storage account and static website.

info

The following steps need to be taken for all environments. It is recommended to finish each step for each environment before you contact the server and network support teams, so you don't have to send multiple emails.

Create a Storage Account

An Azure storage account contains all of your Azure Storage data objects: blobs, files, queues, tables, and disks.

• Official step by step guide

Create a Static Website

Once you have a storage account you can create a static website. Inside your storage account, in the left sidebar filter for "Static website".

• Official step by step guide

Integrate a static website with Azure CDN

You can enable Azure Content Delivery Network (CDN) to cache content from a static website that is hosted in an Azure storage account.

• Official step by step guide

Add a custom domain to your endpoint

1. Email server-support@iqmetrix.zendesk.com with the domain you want and the associated static website endpoint.

   • Submit a change request as well. Remember to specify the server-support team as the implementation team.
   • Example:
   Hi, please apply the following DNS record updates against the iqmetrix.net domain. These entries are required as part of the process for provisioning new service resources.

   Please create them at your earliest convenience.

   checkinint.iqmetrix.net : https://checkinint.z19.web.core.windows.net/

   checkinrc.iqmetrix.net : https://checkinrc.z19.web.core.windows.net/

   checkin.iqmetrix.net : https://iqcheckinprod.z19.web.core.windows.net/

2. Before you can use a custom domain with an Azure CDN endpoint, you must first create a canonical name (CNAME) record with network-support@iqmetrix.zendesk.com to point to your CDN endpoint.

   • Example:
   queueint.iqmetrix.net https://iqcheckinint.azureedge.net

   queuerc.iqmetrix.net https://iqcheckinrc.azureedge.net

   queue.iqmetrix.net https://iqcheckinprod.azureedge.net

3. Request that the new domain to be a trusted domain with Hydra

   • this could take time, please create a work request with them with at least 2 weeks notice

4. Create a new custom domain in azure for that endpoint

   • Click + Custom domain button, and input the custom domain you requested from Server-support
   • From there you can set up a certificate for the new domain

5. If using iQ's auth, you need to add a redirect url in the devconsole app for each environment (INT, RC and PROD)

info

All these steps need to be repeated if the custom domain changes

• Official step by step guide

Redirect HTTP to HTTPS

• Official step by step guide

Help

• If you need help with anything related to Azure portal you can message #sre_product_hosting or send an email to cloudops@iqmetrix.com
• If you have problems with service connections, you need to request that your service connection gets assigned the Storage Blob Data Contributor role. You can see the documentation on Creating a Dev-Ops Service Connection, but you won't have permission to do this yourself, instead send an email to cloudops@iqmetrix.com.

🎉 Well done, you should now have an up and running, secure, app living free from Hub 🎉