Awesome Open Source
Awesome Open Source

Azure Url Shortener (AzUrlShortener)

Deploy to Azure GLO Board Serverless Library

All Contributors

UrlShortener

A simple and easy to use and to deploy budget-friendly Url Shortener for everyone. It runs in Azure (Microsoft cloud) in your subscription.

If you don't own an Azure subscription already, you can create your free account today. It comes with 200$ credit, so you can experience almost everything without spending a dime. Create your free Azure account today

Features:

  • 1-Click deployment (currently only in V1).
  • Create Edit and Delete short URL.
  • Keep Statistics of your clicks.
  • Budget-friendly and 100% open-source.

Version 1

  • A local database (file) is used for authentification.

Version 2

  • Azure Active Directory AAD (Microsoft Identity) is used for authentification.

How To Deploy Version 1

To deploy YOUR version of Azure Url Shortener you could fork this repo, but if you are looking for the easy way just click on the "Deploy to Azure".

Deploy to Azure

To have all details and alternative deployment refer to the Deployment Details page.

Post Deployment Configuration

A good Url Shortener wouldn't be completed without a custom domain name. To know how to add it and other useful post-deployment configurations refer to the post-deployment-configuration page.

How To Deploy Version 2

Right now the deployment of the Version 2 is possible Headless (just the Azure Function) or paired with TinyBlazorAdmin. It's a static website written in C# webassembly and it's even more budget friendly then v1. However, we are still working at the automation of the deployment.

Until we have a 1-Click deployment you should follow the documented To have all details and alternative deployment refer to the Deployment Details page.

How to Update / Upgrade

You deployed the Azure Url Shortener and it's now running in your Azure Subscription, but you would like to have the new feature(s). Updating your current version is in fact really simple.

Note: Currently there is breaking changes between v1 and v2. It is possible to migrate without losing anything, it's just that the documentation is not done yet. See Issue #196 for more details on the progress.


Update the Azure Functions

Navigate to the Azure portal (azure.portal.com) and select the Azure Function instance, for this project.

From the left panel, click on the Deployment Center (1), then the Sync button(2). This will start a synchronization between GitHub and the App Service (aka Azure Function) local Git.

Steps to update the Azure Function doing a Git Sync

IF you are using the Admin Blazor Website, repeat the same operation but selecting the App Service with the name starting by "adm".


How To Use It

There are many different ways to manage your Url Shortener, from a direct HTTP call to a fancy website. See the complete list of admin frontends here, with the instructions to deploy and use them. There is also instructions or guidance if you would like to create a new one and collaborate to this project.

There is also a video that does a quick tour of the project.

YouTube thumbnail of the Az URL Shortener quick tour video


How It Works

If you are interested to learn more about what's under the hood, and get more details on each Azure Function, read the How it works page.


What's Next?

We are working on the version 2.0 (ETA Summer 2020). This version will:

  • Use Azure Active Directory (AAD)
  • Client side website (more budget friendly) see GitHub project: TinyBlazorAdmin for more details.
  • Statistics
  • Better Grid to display the URL

Contributing

If you find a bug or would like to add a feature, check out those resources:

Check out our Code of Conduct and Contributing docs. This project follows the all-contributors specification. Contributions of any kind welcome!

Contributors ✨

Thanks goes to these wonderful people (emoji key):


SurlyDev

🤔

Frank Boucher

💻 📹 🐛

AKER

🤔

Vincent Baaij

💻

kmm7

💻 🤔

fs366e2spm

🐛 🤔

Hugo Hedlund

💻

Nathan Fisk

📖

Erik Alsmyr

🐛 📖

Bernard Vander Beken

📖

IronManion

📖

Jason Hand

📖 🚇

This project follows the all-contributors specification. Contributions of any kind welcome!

This project was inspire by a project created by Jeremy Likness that you can find here jlik.me.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
c-sharp (11,578) 
hacktoberfest (4,234) 
serverless (617) 
azure (341) 
storage (240) 
url-shortener (37) 

Find Open Source By Browsing 7,000 Topics Across 59 Categories

Advertising 📦 10
All Projects
Application Programming Interfaces 📦 124
Applications 📦 192
Artificial Intelligence 📦 78
Blockchain 📦 73
Build Tools 📦 113
Cloud Computing 📦 80
Code Quality 📦 28
Collaboration 📦 32
Command Line Interface 📦 49
Community 📦 83
Companies 📦 60
Compilers 📦 63
Computer Science 📦 80
Configuration Management 📦 42
Content Management 📦 175
Control Flow 📦 213
Data Formats 📦 78
Data Processing 📦 276
Data Storage 📦 135
Economics 📦 64
Frameworks 📦 215
Games 📦 129
Graphics 📦 110
Hardware 📦 152
Integrated Development Environments 📦 49
Learning Resources 📦 166
Legal 📦 29
Libraries 📦 129
Lists Of Projects 📦 22
Machine Learning 📦 347
Mapping 📦 64
Marketing 📦 15
Mathematics 📦 55
Media 📦 239
Messaging 📦 98
Networking 📦 315
Operating Systems 📦 89
Operations 📦 121
Package Managers 📦 55
Programming Languages 📦 245
Runtime Environments 📦 100
Science 📦 42
Security 📦 396
Social Media 📦 27
Software Architecture 📦 72
Software Development 📦 72
Software Performance 📦 58
Software Quality 📦 133
Text Editors 📦 49
Text Processing 📦 136
User Interface 📦 330
User Interface Components 📦 514
Version Control 📦 30
Virtualization 📦 71
Web Browsers 📦 42
Web Servers 📦 26
Web User Interface 📦 210