This is an example implementation of URL Shortener using Serverless technologies in Azure. Check out the accompanying blog for the details about the implementation.

• Active Azure Subscription

• GitHub account and Personal Access Token (PAT) with scope to create repository, create actions, and create secrets. Learn more

• Azure AD permissions to create RBAC Role, CosmosDB, API Managment, Azure functions, Storage Account, Azure Front Door, and other dependent services

• Ability to login to Azure using browser

• Latest version of Azure CLI and Azure Function Core Tools installed

• Python version 3.9+ installed and create a Virtual environment to execute the deployment script

• Existing Azure AD B2C tenant (Step by step guide can be found in this documentation)

  • Create 2 app registrations for Single Page Application (SPA) and API
  • Create a Sign Up and Sign In user flow

• config.yaml - Configuration file which you need to update to provide the required parameters
• deploy.py - Deployment script which will deploy this solution in your Azure Subscription
• url-shortener.bicep - Bicep template which creates required infrastructure in Azure
• main.bicep - Main Bicep template which creates a new Resource Group and create the resources from the url-shortener module
• dns-records.bicep - Bicep template which creates DNS records in Azure DNS
• function_code - Azure Functions source code to create short URL
• frontend/index-template.html - HTML template for the Single Page Application (SPA) which will be updated with appropriate values deployed by Bicep
• frontend/link-checker-template.html - HTML template for the Link Checker page which will be updated with appropriate values deployed by Bicep

You need to update the config.yaml with appropriate values for the deployment script to deploy the right resources.

Make sure you have cloned the repository and navigate inside the repository directory. If you haven't already created a python virtual environment, create one as the deployment script requires a virtual environment and activate it.

After updating the config.yaml run the following command to deploy the solution

python deploy.py

Review the prompts and confirm the subscription ID to start the deployment. Once the deployment has been completed you should add the following URI ([Your Short URL]/url-shortener/index.html - e.g. https://suru.ku/) in redirect URI section of SPA app client registration in your Azure AD B2C tenant. In case if you don't have a domain and just want to test the solution you can use the Azure Front Door endpoint URL in the redirect URI (e.g. https://us-cdn-ep-example-babcdbdxyzb1234q.z01.azurefd.net/). Front Door endpoint URL will be printed after the successful deployment of the above script.