# AZURE API EXTRAS
W.I.P. Azure stuff to make my life easier.
## INSTALLATION
`pip install azure-extras`
## CONFIGURATION
Copy [azure.example.ini](./azure.example.ini) to `$HOME/.azure.ini`, adding
your subscription and tenant details along the way.
This location can be customised with the `--config` flag at runtime.
**TODO:** Use Azure CLI credentials
## KUDU API CLI FRONTEND
https://github.com/projectkudu/kudu
``` text
usage: az-kudu [-h] [-a NAME] [-C PATH] [-r NAME]
(-c COMMAND | -e SLUG | -z PATH | -Z SOURCE DESTINATION)
[-p PATH] [-v]
CLI Kudu API Frontend
optional arguments:
-h, --help show this help message and exit
-a NAME, --app NAME azure app service name
-C PATH, --config PATH
path to azure configuration file
-r NAME, --rg NAME azure resource group
-c COMMAND, --cmd COMMAND
command to run (use quotes for multi-word commands)
-e SLUG, --endpoint SLUG
api endpoint slug
-z PATH, --deploy_zip PATH
upload a zip to the server
-Z SOURCE DESTINATION, --download_zip SOURCE DESTINATION
download a zip of a remote path
-p PATH, --cwd PATH server current working directory
-v increase verbosity
```
## APP SERVICE HEALTH CHECK
Workaround until
[this](https://github.com/projectkudu/kudu/wiki/Health-Check-(Preview)#overview)
is implemented in [terraform](https://github.com/terraform-providers/terraform-provider-azurerm/issues/5147)
``` text
usage: az-chkhealth [-h] [-a NAME [NAME ...]] [-r NAME] [-A ENABLE/DISABLE]
[-C PATH] [-v]
Enable or disable Health Check in Azure App Services
optional arguments:
-h, --help show this help message and exit
-a NAME [NAME ...], --app_services NAME [NAME ...]
list of azure app services
-r NAME, --resource_group NAME
azure resource group
-A ENABLE/DISABLE, --action ENABLE/DISABLE
action to carry out - enable or disable.
-C PATH, --config PATH
path to azure configuration file
-v increase verbosity
```
## APP SERVICES CONTROLLER
``` text
usage: az-asctl [-h] [-a NAME [NAME ...]] [-r NAME] [-A START/STOP] [-C PATH]
[-v]
Start or stop Azure App Services and their slots
optional arguments:
-h, --help show this help message and exit
-a NAME [NAME ...], --app_services NAME [NAME ...]
list of azure app services
-r NAME, --resource_group NAME
azure resource group
-A START/STOP, --action START/STOP
action to carry out - enable or disable.
-C PATH, --config PATH
path to azure configuration file
-v increase verbosity
```
## STREAM ANALYTICS JOBS CONTROLLER
``` text
usage: az-sajctl [-h] [-C PATH] [-r NAME] [-j JOBS [JOBS ...]] [-a START/STOP]
[-v]
Start or stop Stream Analytics Jobs
optional arguments:
-h, --help show this help message and exit
-C PATH, --config PATH
path to azure configuration file
-r NAME, --resource_group NAME
azure resource group
-j JOBS [JOBS ...], --stream_analytics_jobs JOBS [JOBS ...]
list of azure stream analytics jobs
-a START/STOP, --action START/STOP
action to carry out - start or stop.
-v increase verbosity
```
