The .NET Core blog system of edi.wang that runs on Microsoft Azure. Enabling most common blogging features including Posts, Comments, Categories, Archive, Tags, Pages and Friendlink.

The system design DOES NOT couple with Azure, but the blog works best on Azure. Every part of the system, like Authentication and Image Storage, can be configured to use non-Azure options.

This is the way https://edi.wang is deployed, by taking advantage of as many Azure services as possible, the blog can run very fast and secure with only ~$300 USD/month.

It is recommended to use stable code from Release rather than master branch.

This diagram shows a recommended full feature Azure deployment for Moonglade. It doesn't come out of the box. Although the ./Deployment/AzureAppServiceDeploy.ps1 can cover a part of it, you have to manually setup every other piece of it.

If you just want to quickly get it running on Azure without knowing every detail. You can have a minimal deployment that use Docker Container to run on App Service (Linux) by executing the quick start deployment script in PowerShell Core:

./Deployment/AzureAppServiceDeploy.ps1

Please edit the script file and replace these items with your own values:

# Replace with your own values
$subscriptionName = "Microsoft MVP"
$rsgName = "Moonglade-Test-RSG"
$regionName = "East Asia"
$webAppName = "moonglade-test-web"
$aspName = "moonglade-test-plan"
$storageAccountName = "moongladeteststorage"
$storageContainerName = "moongladetestimages"
$sqlServerName = "moongladetestsqlsvr"
$sqlServerUsername = "moonglade"
$sqlServerPassword = "DotNetM00n8!@d3"
$sqlDatabaseName = "moonglade-test-db"
$cdnProfileName = "moonglade-test-cdn"
[bool] $useLinuxPlanWithDocker = 1

Set $useLinuxPlanWithDocker to 1 will use Docker on Linux App Service plan, it will be a ready to run deployment. Set it to 0 will only deploy infrastructure without the application code, and leave the deployment in your control.

To quickly get it running on a new Linux machine without Docker, please follow the steps here.

Create an SQL Server 2019 LocalDB database. e.g. moonglade

Update the MoongladeDatabase with your database connection string in appsettings.Development.json or set environment variable: ConnectionStrings__MoongladeDatabase to your connection string.

Example

"MoongladeDatabase": "Server=(localdb)\\MSSQLLocalDB;Database=moonglade;Trusted_Connection=True;"

For Azure App Service, you can set the connection string in the Configuration blade.

Build and run ./src/Moonglade.sln

• Admin entrance: /admin
• Default Admin username: admin
• Default Admin password: admin123

This section discuss system settings in appsettings.[env].json. For blog settings, please use "/admin/settings" UI.

For production, it is strongly recommended to use Environment Variables over appsetting.json file.

• Register an App in Azure Active Directory
• Set Redirection URI to "https://yourdomain/signin-oidc" (For local debugging, also add URL to https://localhost:1055/signin-oidc)
• Check ID Tokens checkbox under 'Advanced settings'.
• Copy appId to set as AzureAd:ClientId in appsettings.[env].json file

"Authentication": {
  "Provider": "AzureAD",
  "AzureAd": {
    "Domain": "{YOUR-VALUE}",
    "TenantId": "{YOUR-VALUE}",
    "ClientId": "{YOUR-VALUE}",
  }
}

Set Authentication:Provider to "Local" and assign a pair of username and password.

Password is not encrypted, use it at your own risk.

"Authentication": {
  "Provider": "Local",
  "Local": {
    "Username": "admin",
    "Password": "admin123",
  }
}

AppSettings:ImageStorage controls how blog post images are stored.

You need to create an Azure Blob Storage with container level permission.

"Provider": "azurestorage"
"AzureStorageSettings": {
  "ConnectionString": "YOUR CONNECTION STRING",
  "ContainerName": "YOUR CONTAINER NAME"
}

When configured the image storage to use Azure Blob, you can take advantage of CDN for your image resources. Set GetImageByCDNRedirect to true, the blog will get images from client browser using a 302 redirect.

"CDNSettings": {
    "EnableCDNRedirect": true,
    "CDNEndpoint": "https://yourendpoint.azureedge.net/moonglade-images"
}

You can also choose File System for image storage, but this will make your site root not read-only, which would be a potential security issue. And it will be harder for you to backup or update the website.

"Provider": "filesystem",
"FileSystemSettings": {
  "Path": "${basedir}\\UploadedImages"
}

The Path can be relative or absolute. "$\{basedir\}" represents the website's current directory.

If you need email notification for new comments, new replies and pingbacks, you have to setup the Moonglade.Notification Azure Function first, and then set the values in appsettings.[env].json or in your runtime environment variables.

"Notification": {
  "Enabled": true,
  "AzureFunctionEndpoint": "{PROD-ENV-VARIABLE}"
}

• RSS
• Atom
• OPML
• Open Search
• Pingback
• Reader View
• APML - Not planned
• FOAF - Under triage
• BlogML - Under triage
• Trackback - Not planned
• RSD - Not planned
• MetaWeblog - Not planned

There are a few individuals already setup thier blogs using Moonglade on Azure (Global or China), Alibaba Cloud, Tencent Cloud, etc.

• Anduin Xue
• zchwei
• yycoding
• 51azure
• Zhuangkh
• HueiFeng
• Leslie Wang

Just Submit PR or issue if you want your blog to be listed here