devdeer.Templates.Solution 10.2.0

devdeer.Templates.Solutio

Disclaimer

If you want to use this package you should be aware of some principles and practices we at DEVDEER use. So be aware that this is not backed by a public repository. The purpose here is to give out customers easy access to our logic. Nevertheless you are welcome to use this lib if it provides any advantages.

Summary

This nuget package can be used to initialize a dotnet solution with API and one UI project for web. The solution will also include all additional assets for IaC using Bicep. We are following our own interpretation of the Microsoft CAF. The source control for this solution template is pre-defined as being Azure DevOps with Git.

Description

TBD

Installation

The solution template package can be found at nuget.org. To perform the installation the dotnet cli is required.

dotnet new install devdeer.Templates.Solution

The valid versions can be found on the nuget package site.

Usage

First you can inform yourself about the available options using

dotnet new devdeer-sln -h

dotnet new devdeer-sln `
    -c YOUR_COMPANY_NAME `
    -p YOUR_PROJECT_NAME `
    -csk YOUR_COMPANY_SHORT_KEY `
    -ten YOUR_TENANT_ID `
    -dom YOUR_TENANT_DOMAIN `
    -devid YOUR_AZURE_DEVELOPER_GROUP_ID
    -devname YOUR_AZURE_DEVELOPER_GROUP_NAME `
    -rmgid YOUR_ROOT_MANAGEMENT_GROUP_ID `
    -mgid YOUR_MANAGEMENT_GROUP_ID `
    -mgsub YOUR_MANAGEMENT_SUBSCRIPTION_ID `
    -agname YOUR_ACTION_GROUP_NAME `
    -sub YOUR_SUBSCRIPTION_ID `
    -ado YOUR_DEVOPS_ORG_NAME `
    -net 10 `
    -node '20-lts' `
    -o OUTPUT_DIR

• YOUR-COMPANY-NAME: The name of your company/organization.
• YOUR-PROJECT-NAME: The name of your solution.
• YOUR-COMPANY-SHORT-KEY: The abbreviation of your company/organization.
• YOUR-TENANT-ID: The unique identifier of the Azure tenant to use.
• YOUR_TENANT_DOMAIN: The default domain of the Azure tenant.
• YOUR_AZURE_DEVELOPER_GROUP_ID: (optional) The ID of the Entra ID security group that represents developers for this project.
• YOUR_AZURE_DEVELOPER_GROUP_NAME: (optional) The corresponding name of YOUR_AZURE_DEVELOPER_GROUP_ID.
• YOUR_ROOT_MANAGEMENT_GROUP_ID: (optional) The id of the management group that represents your tenant root.
• YOUR_MANAGEMENT_GROUP_ID: (optional) The id of the management group that is nearest to your landing zone.
• YOUR_MANAGEMENT_SUBSCRIPTION_ID: (optional) The subscription id of your landing zone.
• YOUR_ACTION_GROUP_NAME: The name of the action group to use in Azure.
• YOUR-SUBSCRIPTION-ID: (optional) The Azure subscription to use.
• YOUR_DEVOPS_ORG_NAME: (optional) The unique name of your Azure DevOps organization.
• OUTPUT_DIR: (optional) The output directory.

Cleanup

If you want to cleanup your Azure tenant after you tried out this template you have to:

• Delete the resource groups (the one for the stage resources and the shared one).
• Purge the Azure App Configuration.
• Delete the group AZ-PROJECT_NAME-DbAdmins.
• Delete the app registrations PROJECT_NAME Core Api STAGE_NAME and PROJECT_NAME UI STAGE_NAME.
• Purge the deleted app registrations.

About DEVDEER

DEVDEER is a company from Magdeburg, Germany which is specialized in consulting, project management and development. We are very focussed on Microsoft Azure as a platform to run our products and solutions in the cloud. So all of our backend components usually runs in this environment and is developed using .NET. In the frontend area we are using react and a huge bunch of packages to build our UIs.

You can find us online: