https://github.com/caseywatson/automatedhcmsetup
https://github.com/caseywatson/automatedhcmsetup
Last synced: 4 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/caseywatson/automatedhcmsetup
- Owner: caseywatson
- License: mit
- Created: 2020-12-04T20:18:19.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-12-29T07:06:34.000Z (over 5 years ago)
- Last Synced: 2025-10-19T13:39:34.527Z (8 months ago)
- Language: Shell
- Size: 25.4 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Azure hybrid connection automated setup
> Code is as-is, no warranties, etc.
The script automates the provisioning of a new Azure [hybrid connection](https://docs.microsoft.com/en-us/azure/app-service/app-service-hybrid-connections) including —
* Creation of a [service bus relay](https://docs.microsoft.com/en-us/azure/azure-relay/relay-what-is-it) namespace and hybrid connection.
* Configuration of an existing Azure web app to use the newly created connection.
## Usage
1. Navigate to the [Azure portal](https://portal.azure.com).
2. Open the [cloud shell](https://docs.microsoft.com/en-us/azure/cloud-shell/quickstart).
* When prompted, be sure to select __Bash__, not __Powershell__.
3. Clone this repository within the cloud shell.
* `git clone https://github.com/caseywatson/AutomatedHcmSetup.git`
4. Navigate to the cloned repository's directory.
* `cd AutomatedHcmSetup`
5. Allow the script to be executed.
* `chmod +x ./create-hc.sh`
6. Run the script. Refer to the table below for more information on using script parameters.
* `./create-hc.sh -g -w -n -e `
| Parameter | Flag | Description |
| --------- | ---- | ----------- |
| __Resource group name__ | `-g` | The name of the resource group in which the relay and connection will be deployed. This must be the same resource group that the web app (`-w`) is deployed to. |
| __Web app name__ | `-w` | The name of the Azure web app that the hybrid connection should be assigned to. This web app must already exist in the resource group provided through the __resource group name__ (`-g`) parameter. |
| __Connection name__ | `-n` | The name of the hybrid connection. All related resources created by this script will be prefixed with this identifier. |
| __Connection endpoint__ | `-e` | The hybrid connection endpoint (including host name and port) as defined in [this article](https://docs.microsoft.com/en-us/azure/app-service/app-service-hybrid-connections#how-it-works). |
> __Tip__: Want to run this script as part of an automated pipeline? Include the `-q` flag to run this script quietly. The only script output will be the HCM connection string which can be redirected to a file or collected as part of an automated deployment tool like [Azure Pipelines](https://azure.microsoft.com/en-us/services/devops/pipelines/). _Happy Holidays, Manish._ 🎁😉