jeffchristman / psruleforazure

PSRule for Azure Quick Start

This repository contains a sample code you can use to quickly start using PSRule for Azure. To learn more about PSRule for Azure, see https://aka.ms/ps-rule-azure.

What's included?

This repository includes:

• Azure Templates — Starter Azure Resource Manager (ARM) templates and parameter files.
  • Use the files in the template/ folder if you are using ARM templates to deploy resources.
• Azure Bicep — Starter Azure Bicep deployments and test files.
  • Use the files in the bicep/ folder if you are using Bicep deployments and modules to deploy resources.
• GitHub Actions — Starter workflow for checking Azure Infrastructure as Code (IaC).
  • Use the files in the .github/workflows/ to check your Azure IaC with GitHub Actions.
  • The ms-analyze.yaml file can be ignore or removed as this will not execute outside this repository.
• Azure Pipelines — Starter pipeline for checking Azure Infrastructure as Code (IaC).
  • Use the files in the .pipelines/ to check your Azure IaC with Azure Pipelines.
• Custom rules — Example custom rules that enforce organization specific requirements.
  • Use the files in the .ps-rule/ folder to configure custom rules.
• PSRule options — Example options for using PSRule for Azure.
  • PSRule options are configures within ps-rule.yaml.
  • Options include suppressing rules, configuring input/ output, and any rules modules.

What to expect?

This repository shows valid uses of PSRule for Azure, both pass and failure cases. Inspect the following files for instructions to test PSRule for Azure rules by creating a failure.

• bicep/deployments/contoso/landing-zones/subscription-1/rg-app-001/dev.bicepparam
• bicep/deployments/contoso/landing-zones/subscription-1/rg-app-002/deploy.bicep
• template/deployments/contoso/landing-zones/subscription-1/rg-app-001/sttemplateapp001.parameters.json

Support

This project uses GitHub Issues to track bugs and feature requests. Please search the existing issues before filing new issues to avoid duplicates.

• For new issues, file your bug or feature request as a new issue.
• For help, discussion, and support questions about using this project, join or start a discussion.

Support for this project/ product is limited to the resources listed above.

Contributing

This project welcomes contributions and suggestions. If you are ready to contribute, please visit the contribution guide.

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Maintainers

• Bernie White
• Sam Bell

License

This project is licensed under the MIT License.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.