| main | dev |
|---|---|
PoshNotify is a serverless PowerShell application powered by Azure Functions that sends slack messages letting channels know when new things are happening with PowerShell.
PoshNotify is a real world, functional serverless PowerShell application. It is powered by Azure Functions and exists to notify slack channel members of various PowerShell news events.
This repository is linked with an Azure DevOps pipeline and deploys real-world Azure resources. However, it's primary purpose is to serve as a practical and referenceable example for deploying PowerShell Azure Functions.
This is not THE way, this is ONE way
There are not a lot of published practical examples today for deploying Azure PowerShell functions via a CI/CD process. If you are looking to accomplish this you can explore this project to see how I tackled various tasks. To date, there aren't established best practices on this type of effort. So if you have a suggestion to improve, feel free to pop an issue and discuss!
What can you learn by looking over this project?
- How to deploy Azure PowerShell Functions using Azure DevOps
- How to build a custom PowerShell module during the CI/CD process that is intended for use inside your Azure Functions
- How to have your PowerShell functions leverage public modules on the PSGallery
- How to deploy Azure resources using Bicep
- How to store various secrets (such as Storage Access Keys) in Azure Key Vault during the bicep deployment process
- How to assign permissions to enable your Azure PowerShell Functions to do things like:
- Get secrets from Azure Key Vault (slack webhook, SA connection strings)
- Write information to blob storage
- Write and read to Azure Table Storage
- Generate Application Insights information
- How to run Azure DevOps on a self hosted pool
- How to format an Azure DevOps yaml file
- How to use PowerShell in an Azure DevOps pipeline deployment
- How to use Pester 5 in an Azure DevOps pipeline
- How to publish test results for beautiful graphs in Azure DevOps
- How to publish code coverage for beautiful graphs in Azure DevOps
- How to deploy a separate Dev and Prod stack using Azure DevOps
- How to properly build and structure Azure PowerShell Functions
Jake Morrison - https://techthoughts.info/
The PowerShell module inside this project was created using Catesta.
Looking for a serverless PowerShell example on AWS instead? Check out PSGalleryExplorer
This project is licensed under the MIT License.