diff --git a/Directory.Packages.props b/Directory.Packages.props
index 3e8410e9c4..251b2cf00d 100644
--- a/Directory.Packages.props
+++ b/Directory.Packages.props
@@ -17,10 +17,10 @@
-
-
-
-
+
+
+
+
@@ -37,6 +37,10 @@
+
+
+
+
@@ -111,7 +115,7 @@
-
+
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
index 9c414e2f52..e48a677ee7 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
@@ -683,6 +683,8 @@
"DiscountRate": "Discount Rate",
"Menu:RedisManagement": "Redis Management",
"RedisManagement": "Redis Management",
- "Permission:RedisManagement": "Redis Management"
+ "Permission:RedisManagement": "Redis Management",
+ "UserCleanUp": "User Clean Up",
+ "Permission:UserCleanUp": "User Clean Up"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json
index 08e1687357..05e4959514 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json
@@ -535,7 +535,7 @@
"WhenShouldIRenewMyLicenseExplanation3": "{0} for Business and Enterprise Licenses;",
"WhenShouldIRenewMyLicenseExplanation4": "However, if you renew your license more than {0} days after the expiry date, the renewal price will be the same as the initial purchase price of the license, with no discounts applied to your renewal.",
"DoesTheSubscriptionRenewAutomaticallyExplanationAutoRenewal": "ABP Platform allows you to auto-renew your license. This is an optional free service. You can toggle this feature when you purchase a new license or later enable it from your organization management page. If you want to turn on or off the auto-renewal, visit the organization management page, go to the 'Payments Method' section and either check or uncheck the 'Automatic Renewal' checkbox. When you turn off the auto-renewal feature, it will be your responsibility to renew your license manually.",
- "TrialPlanExplanation": "Yes, to start your free trial, please contact marketing@volosoft.com. We also offer a 30-day money-back guarantee for the Team license, with no questions asked! You can request a full refund within the first 30 days of purchasing the license. For Business and Enterprise licenses, we provide a 60% refund if requested within 30 days of purchase. This policy is due to the inclusion of the full source code for all modules and themes in the Business and Enterprise licenses.",
+ "TrialPlanExplanation": "Yes, to start your free trial, please contact sales@volosoft.com. We also offer a 30-day money-back guarantee for the Team license, with no questions asked! You can request a full refund within the first 30 days of purchasing the license. For Business and Enterprise licenses, we provide a 60% refund if requested within 30 days of purchase. This policy is due to the inclusion of the full source code for all modules and themes in the Business and Enterprise licenses.",
"BlazoriseLicenseExplanation": "We have an agreement between Volosoft and Megabit, according to which the Blazorise license is bundled with the ABP Platform’s commercial licenses. Therefore, our paid users do not need to purchase an additional Blazorise license.",
"HowToUpgradeExplanation1": "When you create a new application using the ABP startup templates, all the modules and themes are used as NuGet and NPM packages. This setup allows for easy upgrades to newer versions of the packages.",
"HowToUpgradeExplanation2": "In addition to the standard NuGet/NPM upgrades, ABP CLI provides an update command that automatically finds and upgrades all ABP-related packages in your solution.",
@@ -1868,6 +1868,10 @@
"GenerateQuote" : "Generate Quote" ,
"GeneratePriceQuote": "Generate a Price Quote",
"Qa:QuestionPageTitle": "Support",
- "SelectedTrainingName" : "Trainings"
+ "SelectedTrainingName" : "Trainings",
+ "RcStableDifference": "What is the difference between the RC version and the stable version of ABP?",
+ "RcStableDifferenceExplanation1": "The RC (Release Candidate) version is a pre-release version that allows early access to upcoming features and updates in the ABP project. It is primarily intended for testing purposes and for developers who want to prepare for the upcoming stable release. While it undergoes internal testing, it may still contain unresolved issues and it is not recommended for use in the production environment.",
+ "RcStableDifferenceExplanation2": "The Stable version is tested and officially supported for production use. It ensures reliability and compatibility.",
+ "RcStableDifferenceExplanation3": "Use the RC version for testing and early adoption but use the Stable version for production deployment."
}
}
diff --git a/build/common.ps1 b/build/common.ps1
index 85f18edb21..51ab56d972 100644
--- a/build/common.ps1
+++ b/build/common.ps1
@@ -34,11 +34,13 @@ if ($full -eq "-f")
"../templates/module/aspnet-core",
"../templates/app/aspnet-core",
"../templates/console",
- "../templates/wpf",
"../templates/app-nolayers/aspnet-core",
"../abp_io/AbpIoLocalization",
"../source-code"
- )
+ )
+ if ($env:OS -eq "Windows_NT") {
+ $solutionPaths += "../templates/wpf"
+ }
}else{
Write-host ""
Write-host ":::::::::::::: !!! You are in development mode !!! ::::::::::::::" -ForegroundColor red -BackgroundColor yellow
diff --git a/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/POST.md b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/POST.md
new file mode 100644
index 0000000000..bb8bfdf4c7
--- /dev/null
+++ b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/POST.md
@@ -0,0 +1,147 @@
+# ABP Platform 9.1 RC Has Been Released
+
+We are happy to release [ABP](https://abp.io) version **9.1 RC** (Release Candidate). This blog post introduces the new features and important changes in this new version.
+
+Try this version and provide feedback for a more stable version of ABP v9.1! Thanks to you in advance.
+
+## Get Started with the 9.1 RC
+
+You can check the [Get Started page](https://abp.io/get-started) to see how to get started with ABP. You can either download [ABP Studio](https://abp.io/get-started#abp-studio-tab) (**recommended**, if you prefer a user-friendly GUI application - desktop application) or use the [ABP CLI](https://abp.io/docs/latest/cli).
+
+By default, ABP Studio uses stable versions to create solutions. Therefore, if you want to create a solution with a preview version, first you need to create a solution and then switch your solution to the preview version from the ABP Studio UI:
+
+
+
+## Migration Guide
+
+There are no breaking changes in this version that would affect your application. Only you might need to update some constant names due to the OpenIddict 6.0 upgrade, which is explained in the [OpenIddict 6.0 migration guide](https://abp.io/docs/9.1/release-info/migration-guides/openiddict5-to-6).
+
+## What's New with ABP v9.1?
+
+In this section, I will introduce some major features released in this version.
+Here is a brief list of titles explained in the next sections:
+
+* Upgraded to Angular 19
+* Upgraded to OpenIddict 6.0
+* New Blazor WASM Bundling System
+* Idle Session Warning
+* Lazy Expandable Feature for Documentation
+
+### Upgraded to Angular 19
+
+We've upgraded the Angular templates and packages to **Angular 19**. This upgrade brings the latest features and improvements from the Angular ecosystem to ABP-based applications, including better performance and development experience.
+
+### Upgraded to OpenIddict 6.0
+
+OpenIddict 6.0 has been released and we've upgraded the OpenIddict packages to version 6.0 in ABP 9.1. This brings enhanced security features and improved authentication capabilities. The migration is straightforward and mainly involves updating some constant names:
+
+- `OpenIddictConstants.Permissions.Endpoints.Logout` is now `OpenIddictConstants.Permissions.Endpoints.EndSession`
+- `OpenIddictConstants.Permissions.Endpoints.Device` is now `OpenIddictConstants.Permissions.Endpoints.DeviceAuthorization`
+
+If you're using IdentityModel packages directly, you'll need to upgrade them to the latest stable version (8.3.0). This update ensures your applications stay current with the latest security standards and best practices.
+
+> Please refer to the [OpenIddict 6.0 migration guide](https://abp.io/docs/9.1/release-info/migration-guides/openiddict5-to-6) for more information.
+
+### New Blazor WASM Bundling System
+
+We've implemented a new bundling system for Blazor WebAssembly applications that eliminates the need to manually run the `abp bundle` command. This system automatically handles JavaScript and CSS file bundling at runtime, significantly improving both development experience and application loading performance.
+
+**Key improvements include:**
+
+- Automatic bundling of JavaScript and CSS files without manual intervention
+- Dynamic file generation through the host application
+- Better integration with the ABP module system
+- Improved asset management through virtual file system
+
+The new system is particularly beneficial for modular applications, as it allows modules to contribute their assets automatically to the global bundles. This results in a more maintainable and efficient asset management system for Blazor WebAssembly applications.
+
+> Please refer to [this documentation](https://abp.io/docs/9.1/framework/ui/blazor/global-scripts-styles) for more information.
+
+### Idle Session Warning
+
+We've introduced a new idle session warning feature for the [Account (Pro) Module](https://abp.io/docs/latest/modules/account-pro) that helps manage user sessions more effectively. This security enhancement automatically monitors user activity and manages session timeouts in a user-friendly way.
+
+
+
+The feature can be easily configured through the administration interface, where administrators can:
+
+- Enable/disable the idle session timeout
+- Set custom timeout duration in minutes
+- Configure when users should be signed out
+
+When a user becomes inactive for the configured duration, they'll receive a warning dialog:
+
+
+
+**Key features and behaviors:**
+
+- Tracks real user activity (mouse movements, keyboard presses) across all tabs
+- Works on a per-browser session basis - affects all tabs of the same session
+- Maintains session if user is active in any tab of the application
+- Provides a countdown timer before automatic sign-out
+- Offers options to "Stay signed in" or "Sign out now"
+
+This feature significantly improves application security while maintaining a smooth user experience by preventing unexpected session expirations and data loss.
+
+### Lazy Expandable Feature for Documentation
+
+We've introduced a new lazy expandable feature to the documentation system that significantly improves navigation through large documentation sections. This enhancement addresses common challenges when dealing with extensive documentation hierarchies by introducing smart menu management.
+
+**Key benefits and features:**
+
+- **Cleaner Navigation:** The menu stays concise by hiding sub-items until they're needed, reducing visual clutter
+- **Better Performance:** Reduces the initial load of the navigation tree by loading sub-items on demand
+- **Improved Search Experience:** Makes filtering documentation items more efficient by showing only relevant top-level items
+- **Context-Aware Expansion:** Automatically expands relevant sections when viewing specific documentation pages
+
+The feature works by marking certain documentation sections as "lazy expandable" in the navigation configuration. When users navigate to a document within a lazy expandable section, the system automatically expands the relevant menu items while keeping other sections collapsed.
+
+This improvement is particularly valuable for complex documentation areas like tutorials, solution templates, and extensive module documentation, where having all navigation items visible at once could be overwhelming.
+
+An example of lazy expandable feature from the [ABP's BookStore Tutorial](https://abp.io/docs/latest/tutorials/book-store/part-01):
+
+```json
+ {
+ "text": "Book Store Application",
+ "isLazyExpandable": true,
+ "path": "tutorials/book-store",
+ "items": [
+ {
+ "text": "Overview",
+ "path": "tutorials/book-store",
+ "isIndex": true
+ },
+ //other items...
+ ]
+ }
+```
+
+
+
+### Others
+
+Some other highlights from this release:
+
+* Updated Iyzico NuGet packages to the latest version, which is used in the [ABP's Payment Module](https://abp.io/docs/latest/modules/payment#payment-module-pro).
+* Removed optional _secondaryIds_ from path. See: [#21307](https://github.com/abpframework/abp/pull/21307)
+* [CMS Kit Pro](https://abp.io/docs/latest/modules/cms-kit-pro): Added automatic deletion of comments when a blog post is deleted - comments are now automatically removed when their associated blog post is deleted.
+* Avoiding global blocking in distributed event handlers (See [#21716](https://github.com/abpframework/abp/pull/21716)).
+
+## Community News
+
+### New ABP Community Articles
+
+There are exciting articles contributed by the ABP community as always. I will highlight some of them here:
+
+* [Integrating ABP Modules in Your ASP.NET Core Web API Project. A Step-by-Step Guide](https://abp.io/community/articles/integrating-abp-modules-in-your-asp.net-core-web-api-project.-a-stepbystep-guide-jtbyosnr) by [Sajankumar Vijayan](https://abp.io/community/members/connect)
+* [ABP Framework: Background Jobs vs Background Workers](https://abp.io/community/articles/abp-framework-background-jobs-vs-background-workers-when-to-use-which-t98pzjv6) — When to Use Which? by [Alper Ebiçoğlu](https://twitter.com/alperebicoglu)
+* [The new Unit Test structure in ABP application](https://abp.io/community/articles/the-new-unit-test-structure-in-abp-application-4vvvp2oy) by [Liming Ma](https://github.com/maliming)
+* [How to Use OpenAI API with ABP Framework](https://abp.io/community/articles/how-to-use-openai-api-with-abp-framework-rsfvihla) by [Berkan Şaşmaz](https://github.com/berkansasmaz)
+
+Thanks to the ABP Community for all the content they have published. You can also [post your ABP-related (text or video) content](https://abp.io/community/posts/submit) to the ABP Community.
+
+## Conclusion
+
+This version comes with some new features and a lot of enhancements to the existing features. You can see the [Road Map](https://abp.io/docs/9.1/release-info/road-map) documentation to learn about the release schedule and planned features for the next releases. Please try ABP v9.1 RC and provide feedback to help us release a more stable version.
+
+Thanks for being a part of this community!
diff --git a/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/cover-image.png b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/cover-image.png
new file mode 100644
index 0000000000..0575db3f27
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/cover-image.png differ
diff --git a/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/idle-session-settings.png b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/idle-session-settings.png
new file mode 100644
index 0000000000..7cdb5df408
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/idle-session-settings.png differ
diff --git a/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/lazy-expandable.png b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/lazy-expandable.png
new file mode 100644
index 0000000000..0936bcb024
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/lazy-expandable.png differ
diff --git a/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/session-expiration-warning.png b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/session-expiration-warning.png
new file mode 100644
index 0000000000..1c4082874d
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/session-expiration-warning.png differ
diff --git a/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/studio-switch-to-preview.png b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/studio-switch-to-preview.png
new file mode 100644
index 0000000000..32f6d01edb
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-21 v9_1_Preview/studio-switch-to-preview.png differ
diff --git a/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/POST.md b/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/POST.md
new file mode 100644
index 0000000000..611d8cb41b
--- /dev/null
+++ b/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/POST.md
@@ -0,0 +1,46 @@
+# ABP Studio Now Supports MacOS Intel 🚀
+
+We are excited to announce that [ABP Studio, our cross-platform desktop application for ABP developers](https://abp.io/studio), now supports Intel-based Mac computers!
+
+This addition expands our platform compatibility, ensuring that developers using Intel-powered Macs can also benefit from the powerful features of ABP Studio.
+
+## What is ABP Studio?
+
+For those who aren't familiar, [ABP Studio](https://abp.io/studio) is a powerful desktop application that makes ABP development faster and easier. It offers:
+
+* Easy creation of new solutions (from simple applications to microservices)
+* Visual architecture management for modular-monolith and microservice solutions
+* Solution exploration tools for entities, services, and HTTP APIs
+* Simplified running, debugging and monitoring of multi-application or microservice solutions
+* Kubernetes cluster integration capabilities
+* and more...
+
+## Extended Platform Support
+
+ABP Studio has been proudly supporting multiple platforms, and we're excited to add MacOS Intel to the our list of supported architectures. You can now use ABP Studio on:
+
+* Windows x64
+* Windows ARM
+* MacOS Apple Silicon (M1/M2/M3)
+* MacOS Intel **(New!)**
+
+## Why This Matters
+
+This update is particularly important for developers who are using Intel-based Mac computers. Previously, ABP Studio was only available for Apple Silicon Macs (for MacOS), but we understand that many developers are still using Intel-based Macs. With this release, we're ensuring that all Mac users can access our development tools, regardless of their processor architecture.
+
+## Getting Started
+
+Installing ABP Studio on your Intel-based Mac is straightforward:
+
+1. Go to [abp.io/studio](https://abp.io/studio)
+2. Click on the download button and select "MacOS Intel" from the dropdown menu
+3. Once downloaded, open the installer package
+4. Follow the installation wizard to complete the setup
+
+
+
+## Conclusion
+
+As ABP team, we're always looking for ways to improve the developer experience. By supporting Intel-based Macs, we're ensuring that all Mac users can access our development tools, regardless of their processor architecture.
+
+Stay tuned for more updates and enhancements as we continue to optimize ABP Studio and please provide us with your invaluable feedback. Thanks in advance!
diff --git a/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/abp-studio-macos-intel.png b/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/abp-studio-macos-intel.png
new file mode 100644
index 0000000000..f5d5ca6987
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/abp-studio-macos-intel.png differ
diff --git a/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/cover-image.png b/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/cover-image.png
new file mode 100644
index 0000000000..80e0d0faf0
Binary files /dev/null and b/docs/en/Blog-Posts/2025-01-22 ABP_Now_Supports_MacOS_Intel/cover-image.png differ
diff --git a/docs/en/Community-Articles/2025-01-23-Fixing-OpenIddict-Certificate-Issues/Load-User-Profile.jpg b/docs/en/Community-Articles/2025-01-23-Fixing-OpenIddict-Certificate-Issues/Load-User-Profile.jpg
new file mode 100644
index 0000000000..85f736050f
Binary files /dev/null and b/docs/en/Community-Articles/2025-01-23-Fixing-OpenIddict-Certificate-Issues/Load-User-Profile.jpg differ
diff --git a/docs/en/Community-Articles/2025-01-23-Fixing-OpenIddict-Certificate-Issues/POST.md b/docs/en/Community-Articles/2025-01-23-Fixing-OpenIddict-Certificate-Issues/POST.md
new file mode 100644
index 0000000000..cea4bb82eb
--- /dev/null
+++ b/docs/en/Community-Articles/2025-01-23-Fixing-OpenIddict-Certificate-Issues/POST.md
@@ -0,0 +1,77 @@
+# Fixing OpenIddict Certificate Issues in IIS or Azure
+
+When deploying an ABP application with OpenIddict to IIS or Azure, you may encounter issues with loading PFX/PKCS12 certificates. This article explains how to properly configure certificate loading to ensure it works correctly in these environments.
+
+## The Problem
+
+When running under IIS or Azure, the application pool identity may not have sufficient permissions to access certificate private keys. This commonly results in errors such as:
+
+- `System.Security.Cryptography.CryptographicException: Access denied.`
+- `WindowsCryptographicException: Access is denied.`
+- `System.Security.Cryptography.CryptographicException: The system cannot find the file specified.`
+
+## The Solution
+
+### Using AddDevelopmentEncryptionAndSigningCertificate
+
+For development environments using `DevelopmentEncryptionAndSigningCertificate`, you must configure the application pool to load a user profile.
+
+> Note: We strongly recommend using `DevelopmentEncryptionAndSigningCertificate` only in development environments. For production, always create and use a separate certificate.
+
+
+
+### Using AddProductionEncryptionAndSigningCertificate
+
+The ABP OpenIddict module provides an `AddProductionEncryptionAndSigningCertificate` extension method. By default, the template project attempts to load an `openiddict.pfx` certificate in production environments.
+
+To ensure proper certificate loading in IIS or Azure, you need to specify appropriate `X509KeyStorageFlags` when calling this method:
+
+```csharp
+public override void PreConfigureServices(ServiceConfigurationContext context)
+{
+ var hostingEnvironment = context.Services.GetHostingEnvironment();
+
+ if (!hostingEnvironment.IsDevelopment())
+ {
+ PreConfigure(options =>
+ {
+ options.AddDevelopmentEncryptionAndSigningCertificate = false;
+ });
+
+ PreConfigure(serverBuilder =>
+ {
+ var flag = X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.EphemeralKeySet;
+ serverBuilder.AddProductionEncryptionAndSigningCertificate("openiddict.pfx", "YourCertificatePassword", flag);
+ });
+ }
+}
+```
+
+## Understanding X509KeyStorageFlags
+
+The configuration uses two important flags:
+
+* `X509KeyStorageFlags.MachineKeySet`: Specifies that the key belongs to the local computer key store, binding the key pair's lifecycle to the computer rather than a specific user.
+* `X509KeyStorageFlags.EphemeralKeySet`: Indicates that the key will be stored only in memory and not persisted to disk or key store, enhancing security for runtime-only certificate requirements.
+
+Using these flags in combination helps prevent permission-related issues in IIS and Azure environments.
+
+## Troubleshooting Guide
+
+If you continue to experience issues, verify the following:
+
+* Confirm that the certificate password is correct
+* Verify that the `openiddict.pfx` file exists in your deployment
+* Ensure the certificate is valid - you can generate a new one using:
+ ```bash
+ dotnet dev-certs https -v -ep openiddict.pfx -p YourCertificatePassword
+ ```
+* Check the stdout logs for related errors (See [how to get stdout-log](https://abp.io/docs/latest/solution-templates/layered-web-application/deployment/deployment-iis?UI=Blazor&DB=EF&Tiered=No#how-to-get-stdout-log))
+
+## References
+
+- [ABP OpenIddict Deployment](https://abp.io/docs/latest/solution-templates/layered-web-application/deployment/openiddict-deployment)
+- [ABP IIS Deployment](https://abp.io/docs/latest/solution-templates/layered-web-application/deployment/deployment-iis)
+- [ABP Azure Deployment](https://abp.io/docs/latest/solution-templates/layered-web-application/deployment/azure-deployment/azure-deployment)
+- [How to Generate a New Certificate](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-dev-certs#how-to-generate-a-new-certificate)
+- [Load User Profile in IIS](https://learn.microsoft.com/en-us/iis/manage/configuring-security/application-pool-identities#load-user-profile-for-an-application-pool)
diff --git a/docs/en/cli/index.md b/docs/en/cli/index.md
index 645c12a715..e9b4e5c42a 100644
--- a/docs/en/cli/index.md
+++ b/docs/en/cli/index.md
@@ -883,18 +883,13 @@ abp translate -c zh-Hans --online --deepl-auth-key
### login
-Some features of the CLI requires to be logged in to ABP Platform. To login with your username write:
+Some features of the CLI requires to be logged in to ABP Platform. The login command supports the following usage options:
```bash
-abp login # Allows you to enter your password hidden
-abp login -p # Specify the password as a parameter (password is visible)
-abp login --organization # If you have multiple organizations, you need set your active organization
-abp login -p -o # You can enter both your password and organization in the same command
-abp login --device # Use device login flow
+abp login # Opens a default browser to log in to ABP Platform via abp.io
+abp login --device # Use device login flow
```
-> When using the -p parameter, be careful as your password will be visible. It's useful for CI/CD automation pipelines.
-
A new login with an already active session overwrites the previous session.
### login-info
diff --git a/docs/en/docs-nav.json b/docs/en/docs-nav.json
index e7b7a4c3b7..8253b732df 100644
--- a/docs/en/docs-nav.json
+++ b/docs/en/docs-nav.json
@@ -2292,6 +2292,10 @@
{
"text": "Tenant impersonation & User impersonation",
"path": "modules/account/impersonation.md"
+ },
+ {
+ "text": "Idle Session Timeout",
+ "path": "modules/account/idle-session-timeout.md"
}
]
},
diff --git a/docs/en/framework/architecture/best-practices/mongodb-integration.md b/docs/en/framework/architecture/best-practices/mongodb-integration.md
index 1930984e2e..c39f6443a0 100644
--- a/docs/en/framework/architecture/best-practices/mongodb-integration.md
+++ b/docs/en/framework/architecture/best-practices/mongodb-integration.md
@@ -114,7 +114,7 @@ public async Task FindByNormalizedUserNameAsync(
bool includeDetails = true,
CancellationToken cancellationToken = default)
{
- return await (await GetMongoQueryableAsync())
+ return await (await GetQueryableAsync())
.FirstOrDefaultAsync(
u => u.NormalizedUserName == normalizedUserName,
GetCancellationToken(cancellationToken)
@@ -125,10 +125,10 @@ public async Task FindByNormalizedUserNameAsync(
`GetCancellationToken` fallbacks to the `ICancellationTokenProvider.Token` to obtain the cancellation token if it is not provided by the caller code.
* **Do** ignore the `includeDetails` parameters for the repository implementation since MongoDB loads the aggregate root as a whole (including sub collections) by default.
-* **Do** use the `GetMongoQueryableAsync()` method to obtain an `IQueryable` to perform queries wherever possible. Because;
- * `GetMongoQueryableAsync()` method automatically uses the `ApplyDataFilters` method to filter the data based on the current data filters (like soft delete and multi-tenancy).
+* **Do** use the `GetQueryableAsync()` method to obtain an `IQueryable` to perform queries wherever possible. Because;
+ * `GetQueryableAsync()` method automatically uses the `ApplyDataFilters` method to filter the data based on the current data filters (like soft delete and multi-tenancy).
* Using `IQueryable` makes the code as much as similar to the EF Core repository implementation and easy to write and read.
-* **Do** implement data filtering if it is not possible to use the `GetMongoQueryable()` method.
+* **Do** implement data filtering if it is not possible to use the `GetQueryableAsync()` method.
## Module Class
diff --git a/docs/en/framework/architecture/domain-driven-design/repositories.md b/docs/en/framework/architecture/domain-driven-design/repositories.md
index 9050e7d3c3..04848a59e8 100644
--- a/docs/en/framework/architecture/domain-driven-design/repositories.md
+++ b/docs/en/framework/architecture/domain-driven-design/repositories.md
@@ -393,19 +393,6 @@ This method is suggested;
* If you are developing an application and you **don't plan to change** EF Core in the future, or you can **tolerate** it if you need to change it later. We believe that's reasonable if you are developing a final application.
-#### MongoDB Case
-
-If you are using [MongoDB](../../data/mongodb), you need to add the [Volo.Abp.MongoDB](https://www.nuget.org/packages/Volo.Abp.MongoDB) NuGet package to your project. Even in this case, you can't directly use async LINQ extensions (like `ToListAsync`) because MongoDB doesn't provide async extension methods for `IQueryable`, but provides for `IMongoQueryable`. You need to cast the query to `IMongoQueryable` first to be able to use the async extension methods.
-
-**Example: Cast `IQueryable` to `IMongoQueryable` and use `ToListAsync()`**
-
-````csharp
-var queryable = await _personRepository.GetQueryableAsync();
-var people = ((IMongoQueryable) queryable
- .Where(p => p.Name.Contains(nameFilter)))
- .ToListAsync();
-````
-
### Option-2: Use the IRepository Async Extension Methods
ABP provides async extension methods for the repositories, just similar to async LINQ extension methods.
diff --git a/docs/en/guides/microservice-mongodb.md b/docs/en/guides/microservice-mongodb.md
index c9b63ecf4e..087668ba7a 100644
--- a/docs/en/guides/microservice-mongodb.md
+++ b/docs/en/guides/microservice-mongodb.md
@@ -97,9 +97,9 @@ Here we use `BookStore.ProductService` project as an example:
int skipCount = 0,
CancellationToken cancellationToken = default)
{
- var query = ApplyFilter(await GetMongoQueryableAsync(cancellationToken), filterText, name, priceMin, priceMax);
+ var query = ApplyFilter(await GetQueryableAsync(cancellationToken), filterText, name, priceMin, priceMax);
query = query.OrderBy(string.IsNullOrWhiteSpace(sorting) ? ProductConsts.GetDefaultSorting(false) : sorting);
- return await query.As>().PageBy>(skipCount, maxResultCount).ToListAsync(cancellationToken);
+ return await query.PageBy(skipCount, maxResultCount).ToListAsync(cancellationToken);
}
public async Task GetCountAsync(
@@ -109,8 +109,8 @@ Here we use `BookStore.ProductService` project as an example:
float? priceMax = null,
CancellationToken cancellationToken = default)
{
- var query = ApplyFilter(await GetMongoQueryableAsync(cancellationToken), filterText, name, priceMin, priceMax);
- return await query.As>().LongCountAsync(GetCancellationToken(cancellationToken));
+ var query = ApplyFilter(await GetQueryableAsync(cancellationToken), filterText, name, priceMin, priceMax);
+ return await query.LongCountAsync(GetCancellationToken(cancellationToken));
}
protected virtual IQueryable ApplyFilter(
diff --git a/docs/en/modules/account-pro.md b/docs/en/modules/account-pro.md
index 0dd960e97e..490abe4bba 100644
--- a/docs/en/modules/account-pro.md
+++ b/docs/en/modules/account-pro.md
@@ -358,4 +358,4 @@ This module doesn't define any additional distributed event. See the [standard d
* [Impersonation](./account/impersonation.md)
* [Linked Accounts](./account/linkedaccounts.md)
* [Session Management](./account/session-management.md)
-* [Idle Session Timeout](./account/idle-session-timeout.md)]
+* [Idle Session Timeout](./account/idle-session-timeout.md)
diff --git a/docs/en/release-info/migration-guides/MongoDB-Driver-2-to-3.md b/docs/en/release-info/migration-guides/MongoDB-Driver-2-to-3.md
new file mode 100644
index 0000000000..79c0d70573
--- /dev/null
+++ b/docs/en/release-info/migration-guides/MongoDB-Driver-2-to-3.md
@@ -0,0 +1,59 @@
+# Migrating from MongoDB Driver 2 to 3
+
+## Introduction
+
+The release of MongoDB Driver 3 includes numerous user-requested fixes and improvements that were deferred in previous versions due to backward compatibility concerns. It also features internal improvements to reduce technical debt and enhance maintainability. One major update is the removal of a significant portion of the public API (primarily from `MongoDB.Driver.Core`), which was not intended for public use. The removed APIs were marked as deprecated in version 2.30.0.
+
+Please refer to the [upgrade guide](https://www.mongodb.com/docs/drivers/csharp/current/upgrade/v3/) for a complete list of breaking changes and upgrade guidelines.
+
+## Repository Changes
+
+Some method signatures in the `MongoDbRepository` class have been updated because the `IMongoQueryable` has been removed. The specific changes are as follows:
+
+- The new `GetQueryableAsync` method has been added to return `IQueryable`.
+- The `GetMongoQueryable` and `GetMongoQueryableAsync` methods return `IQueryable` instead of `IMongoQueryable`,
+- The `GetMongoQueryable` and `GetMongoQueryableAsync` methods are marked as obsolete, You should use the new `GetQueryableAsync` method instead.
+
+Please update your application by searching for and replacing these method calls.
+
+> The return value of the `GetQueryableAsync` method is `IQueryable`, which can be used directly to perform queries, similar to EF Core. Remove all instances of `IMongoQueryable` in your project and replace them with `IQueryable`.
+
+**Previous code example:**
+
+```csharp
+var myEntity = await (await GetMongoQueryableAsync()).As>().FirstOrDefaultAsync(x => x.Id == id);
+```
+
+**Updated code example:**
+
+```csharp
+var myEntity = await GetQueryableAsync().FirstOrDefaultAsync(x => x.Id == id);
+```
+
+## Unit Test Changes
+
+Previously, we used the [EphemeralMongo](https://github.com/asimmon/ephemeral-mongo) library for unit testing. However, it does not support the latest version of [MongoDB.Driver 3.x](https://github.com/mongodb/mongo-go-driver). You should replace it with [MongoSandbox](https://github.com/wassim-k/MongoSandbox).
+
+In your unit test project files, replace the following:
+
+```xml
+
+
+
+
+```
+
+With:
+
+```xml
+
+
+
+
+```
+
+In your unit test classes, replace `using EphemeralMongo` with `using MongoSandbox`.
+
+## Official Upgrade Guide
+
+We recommend reviewing the [upgrade guide](https://www.mongodb.com/docs/drivers/csharp/current/upgrade/v3/) for MongoDB Driver 3 to ensure a smooth migration process.
diff --git a/docs/en/release-info/migration-guides/abp-9-1.md b/docs/en/release-info/migration-guides/abp-9-1.md
new file mode 100644
index 0000000000..0e80da824a
--- /dev/null
+++ b/docs/en/release-info/migration-guides/abp-9-1.md
@@ -0,0 +1,7 @@
+# ABP Version 9.1 Migration Guide
+
+This document is a guide for upgrading ABP v9.0 solutions to ABP v9.1. There are no breaking changes in this version that would affect your application.
+
+Only you might need to update some constant names due to the OpenIddict 6.0 upgrade, which is explained in the following migration guide:
+
+- [OpenIddict 5.x to 6.x Migration Guide](./openiddict5-to-6.md)
\ No newline at end of file
diff --git a/docs/en/release-info/migration-guides/index.md b/docs/en/release-info/migration-guides/index.md
index 27c6752338..821fbf5469 100644
--- a/docs/en/release-info/migration-guides/index.md
+++ b/docs/en/release-info/migration-guides/index.md
@@ -2,6 +2,7 @@
The following documents explain how to migrate your existing ABP applications. We write migration documents only if you need to take an action while upgrading your solution. Otherwise, you can easily upgrade your solution using the [abp update command](../upgrading.md).
+- [9.0 to 9.1](abp-9-1.md)
- [8.x to 9.0](abp-9-0.md)
- [8.x to 8.3](abp-8-3.md)
- [8.1 to 8.2](abp-8-2.md)
diff --git a/docs/en/samples/index.md b/docs/en/samples/index.md
index 8c8733408d..6aea3d3fa5 100644
--- a/docs/en/samples/index.md
+++ b/docs/en/samples/index.md
@@ -1,6 +1,6 @@
# ABP Samples
-Here, a list of official samples built with ABP.
+This document provides a list of samples built with ABP. Each sample is briefly explained below, along with its live demo (if available), source code, and tutorial links (where applicable).
## Event Hub
@@ -11,13 +11,13 @@ A reference application built with ABP. It implements the Domain Driven Design w
## eShopOnAbp
+> ⚠️ **Important Notice**
+> This project, "eShopOnAbp," is outdated. It served as a reference project for microservice architecture using the ABP Framework, but we now recommend using the [ABP Microservice Solution Template](https://abp.io/docs/latest/solution-templates/microservice) for new projects.
+
Reference microservice solution built with ABP and .NET.
* [Source code](https://github.com/abpframework/eShopOnAbp)
-> ⚠️ **Important Notice**
-> This project, "eShopOnAbp," is outdated. It served as a reference project for microservice architecture using the ABP Framework, but we now recommend using the [ABP Microservice Solution Template](https://abp.io/docs/latest/solution-templates/microservice) for new projects.
-
## CMS Kit Demo
A minimal example website built with the [CMS Kit module](../modules/cms-kit/index.md).
@@ -34,92 +34,48 @@ A middle-size CRM application built with ABP.
## Book Store
-A simple CRUD application to show basic principles of developing an application with ABP. The same sample was implemented with different technologies and different modules.
-
-### With Open Source Modules
-
-The following samples uses only the open source (free) modules.
+A simple CRUD application to show basic principles of developing an application with ABP. The same sample was implemented with different technologies and different modules:
* **Book Store: Razor Pages UI & Entity Framework Core**
* [Tutorial](../tutorials/book-store/part-01.md?UI=MVC&DB=EF)
* [Source code](https://github.com/abpframework/abp-samples/tree/master/BookStore-Mvc-EfCore)
+ * [Download source code (with PRO modules) *](https://abp.io/Account/Login?returnUrl=/api/download/samples/bookstore-mvc-ef)
* **Book Store: Blazor UI & Entity Framework Core**
* [Tutorial](../tutorials/book-store/part-01.md?UI=Blazor&DB=EF)
* [Source code](https://github.com/abpframework/abp-samples/tree/master/BookStore-Blazor-EfCore)
+ * [Download source code (with PRO modules) *](https://abp.io/Account/Login?returnUrl=/api/download/samples/bookstore-blazor-efcore)
* **Book Store: Angular UI & MongoDB**
* [Tutorial](../tutorials/book-store/part-01.md?UI=NG&DB=Mongo)
* [Source code](https://github.com/abpframework/abp-samples/tree/master/BookStore-Angular-MongoDb)
+ * [Download source code (with PRO modules) *](https://abp.io/Account/Login?returnUrl=/api/download/samples/bookstore-angular-mongodb)
* **Book Store: Modular application (Razor Pages UI & EF Core)**
* [Source code](https://github.com/abpframework/abp-samples/tree/master/BookStore-Modular)
-### With Pro Modules
+If you want to create the BookStore application and generate CRUD pages automatically with ABP Suite, please refer to the [Book Store Application (with ABP Suite) tutorial](../tutorials/book-store-with-abp-suite/part-01.md). Also, you can follow the [Mobile Application Development Tutorials](../tutorials/mobile/index.md), if you want to implement the CRUD operations for [MAUI](../tutorials/mobile/maui/index.md) & [React Native](../tutorials/mobile/react-native/index.md) mobile applications.
-The following samples uses the pro modules.
+> **Note:** _Downloading source codes (with PRO modules) \*_ require an active [ABP License](https://abp.io/pricing).
-- **Book Store: Razor Pages (MVC) UI & Entity Framework Core**
- - [Tutorial](../tutorials/book-store/part-01.md?UI=MVC&DB=EF)
- - [Download the source code](https://abp.io/Account/Login?returnUrl=/api/download/samples/bookstore-mvc-ef)
-- **Book Store: Blazor UI & Entity Framework Core**
- - [Tutorial](../tutorials/book-store/part-01.md?UI=Blazor&DB=EF)
- - [Download the source code](https://abp.io/Account/Login?returnUrl=/api/download/samples/bookstore-blazor-efcore)
-- **Book Store: Angular UI & MongoDB**
- - [Tutorial](../tutorials/book-store/part-01.md?UI=NG&DB=Mongo)
- - [Download the source code](https://abp.io/Account/Login?returnUrl=/api/download/samples/bookstore-angular-mongodb)
+## ModularCRM
+
+A modular monolith application that demonstrates how to create, compose, and communicate between application modules to build a modular web application:
+
+* **ModularCRM: Razor Pages UI & Entity Framework Core**
+ * [Tutorial](../tutorials/modular-crm/part-01.md?UI=MVC&DB=EF)
+ * [Source code](https://github.com/abpframework/abp-samples/tree/master/ModularCrm)
+
+## CloudCrm
+
+> This tutorial & sample application is suitable for those who have an [ABP Business or a higher license](https://abp.io/pricing).
+
+A microservice solution that shows how to start a new microservice solution, create services and communicate between these services. It's a reference tutorial to learn to use these services from a web application through an API gateway and automatically generate CRUD pages using the ABP Suite tool:
+
+* **CloudCRM: Razor Pages UI & Entity Framework Core**
+ * [Tutorial](../tutorials/microservice/part-01.md?UI=MVC&DB=EF)
+ * [Download source code](https://abp.io/api/download/samples/cloud-crm-mvc-ef)
## Other Samples
-* **Event Organizer**: A sample application to create events (meetups) and allow others to register the events. Developed using EF Core and Blazor UI.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/EventOrganizer)
- * [Article](https://abp.io/community/articles/creating-an-event-organizer-application-with-the-blazor-ui-wbe0sf2z)
-* **Entity Framework Migrations**: A solution to demonstrate how to split your application into multiple databases each database contains different modules.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/EfCoreMigrationDemo)
- * [EF Core database migrations document](../framework/data/entity-framework-core/migrations.md)
-* **SignalR Demo**: A simple chat application that allows to send and receive messages among authenticated users.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/SignalRDemo)
- * [SignalR Integration document](../framework/real-time/signalr.md)
-* **Real Time Messaging In A Distributed Architecture** (using SingalR & RabbitMQ)
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/SignalRTieredDemo)
- * [Article](https://abp.io/community/articles/real-time-messaging-in-a-distributed-architecture-using-abp-framework-singalr-rabbitmq-daf47e17)
-* **Dashboard Demo**: A simple application to show how to use the widget system for the ASP.NET Core MVC UI.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/DashboardDemo)
- * [Widget documentation](../framework/ui/mvc-razor-pages/widgets.md)
-* **RabbitMQ Event Bus Demo**: A solution consists of two applications communicating to each other via distributed events with RabbitMQ integration.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/RabbitMqEventBus)
- * [Distributed event bus document](../framework/infrastructure/event-bus/distributed)
- * [RabbitMQ distributed event bus integration document](../framework/infrastructure/event-bus/distributed/rabbitmq.md)
-* **Text Templates Demo**: Shows different use cases of the text templating system.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/TextTemplateDemo)
- * [Text templating documentation](../framework/infrastructure/text-templating)
-* **Stored Procedure Demo**: Demonstrates how to use stored procedures, database views and functions with best practices.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/StoredProcedureDemo)
-* **Passwordless Authentication**: Shows how to add a custom token provider to authenticate a user with a link, instead of entering a password.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/PasswordlessAuthentication)
- * [Article](https://abp.io/community/articles/implementing-passwordless-authentication-with-asp.net-core-identity-c25l8koj)
-* **Authentication Customization**: A solution to show how to customize the authentication for ASP.NET Core MVC / Razor Pages applications.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/Authentication-Customization)
- * Related articles:
- * [Azure Active Directory Authentication](https://abp.io/community/articles/how-to-use-the-azure-active-directory-authentication-for-mvc-razor-page-applications-4603b9cf)
- * [Customize the Login Page](https://abp.io/community/articles/how-to-customize-the-login-page-for-mvc-razor-page-applications-9a40f3cd)
- * [Customize the SignIn Manager](https://abp.io/community/articles/how-to-customize-the-signin-manager-3e858753)
-* **GRPC Demo**: Shows how to add a gRPC service to an ABP based web application and consume it from a console application.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/GrpcDemo)
-* **Telerik Blazor Integration**: Shows how to install and use Telerik Blazor components with ABP.
- * [Article](https://abp.io/community/articles/how-to-integrate-the-telerik-blazor-components-to-the-abp-blazor-ui-q8g31abb)
-* **Angular Material Integration**: Implemented the web application tutorial using the Angular Material library.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/AcmeBookStoreAngularMaterial)
- * [Article](https://abp.io/community/articles/using-angular-material-components-with-the-abp-framework-af8ft6t9)
-* **DevExtreme Angular Component Integration**: How to install and use DevExtreme components in the ABP Angular UI.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/DevExtreme-Angular)
- * [Article](https://abp.io/community/articles/using-devextreme-angular-components-with-the-abp-framework-x5nyvj3i)
-* **DevExtreme MVC / Razor Pages Component Integration**: How to install and use DevExtreme components in the ABP MVC / Razor Pages UI.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/DevExtreme-Mvc)
- * [Article](https://abp.io/community/articles/using-devextreme-components-with-the-abp-framework-zb8z7yqv)
-* **Syncfusion Blazor Integration**: Shows how to install and integrate Syncfusion UI the ABP Blazor UI.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/SyncfusionSample)
- * [Article](https://abp.io/community/articles/using-syncfusion-components-with-the-abp-framework-5ccvi8kc)
-* **Empty ASP.NET Core Application**: The most basic ASP.NET Core application with ABP installed.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/BasicAspNetCoreApplication)
- * [Documentation](../get-started/empty-aspnet-core-application.md)
-* **Using Elsa Workflow with ABP**: Shows how to use the Elsa Core workflow library within an ABP-based application.
- * [Source code](https://github.com/abpframework/abp-samples/tree/master/ElsaDemo)
- * [Article](https://abp.io/community/articles/using-elsa-workflow-with-the-abp-framework-773siqi9)
+ABP Platform provides many sample applications demonstrating various use cases and integrations. You can:
+
+* Browse all sample applications in the [abp-samples repository](https://github.com/abpframework/abp-samples).
+* Read detailed articles and tutorials in the [ABP Community](https://abp.io/community), which are shared by ABP Community & Contributors.
\ No newline at end of file
diff --git a/docs/en/solution-templates/layered-web-application/deployment/deployment-docker-compose.md b/docs/en/solution-templates/layered-web-application/deployment/deployment-docker-compose.md
index a9e106221b..fe2d226d53 100644
--- a/docs/en/solution-templates/layered-web-application/deployment/deployment-docker-compose.md
+++ b/docs/en/solution-templates/layered-web-application/deployment/deployment-docker-compose.md
@@ -15,7 +15,7 @@ This guide will guide you through how to build docker images for your applicatio
## Building Docker Images
-Each application contains a dockerfile called `Dockerfile.local` for building the docker image. As the naming implies, these Dockerfiles are not multi-stage Dockerfiles and require the project to be built in `Release` mode to create the image. Currently, if you are building your images using CI & CD pipeline, you either need to include the SDK to your pipeline before building the images or add your own [multi-stage dockerfiles](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/docker/building-net-docker-images?view=aspnetcore-7.0).
+Each application contains a dockerfile called `Dockerfile.local` for building the docker image. As the naming implies, these Dockerfiles are not multi-stage Dockerfiles and require the project to be built in `Release` mode to create the image. Currently, if you are building your images using CI & CD pipeline, you either need to include the SDK to your pipeline before building the images or add your own [multi-stage dockerfiles](https://learn.microsoft.com/en-us/aspnet/core/host-and-deploy/docker/building-net-docker-images?view=aspnetcore-9.0).
Since they are not multi-staged Dockerfiles, if you want to build the images individually, you can navigate to the related to-be-hosted application folder and run the following command:
@@ -31,7 +31,7 @@ docker build -f Dockerfile.local -t mycompanyname/myappname:version .
To manually build your application image.
-To ease the process, application templates provide a build script to build all the images with a single script under `etc/build` folder named `build-images-locally.ps1`.
+To ease the process, application templates provide a build script to build all the images with a single script under `etc/docker-compose` folder named `build-images-locally.ps1`.
Based on your application name, UI and type, a build image script will be generated.
{{ if UI == "MVC"}}
@@ -204,8 +204,8 @@ DbMigrator is a console application that is used to migrate the database of your
`Dockerfile.local` is provided under this project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
ENTRYPOINT ["dotnet", "BookStore.DbMigrator.dll"]
```
@@ -226,7 +226,7 @@ docker build -f Dockerfile.local -t acme/bookstore-db-migrator:latest . #Builds
In the **WebModule** under authentication configuration, there is an extra configuration for containerized environment support:
```csharp
-if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
+if (Convert.ToBoolean(configuration["AuthServer:IsOnK8s"]))
{
context.Services.Configure("oidc", options =>
{
@@ -268,13 +268,13 @@ if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
This is used when the **AuthServer is running on docker containers(or pods)** to configure the redirection URLs for the internal network and the web. The application must be redirected to real DNS (localhost in this case) when the `/authorize` and `/logout` requests over the browser but handle the token validation inside the isolated network without going out to the internet. `"AuthServer:MetaAddress"` appsetting should indicate the container/pod service name while the `AuthServer:Authority` should be pointing to real DNS for the browser to redirect.
-The `appsettings.json` file does not contain `AuthServer:IsContainerizedOnLocalhost` and `AuthServer:MetaAddress` settings since they are used for orchestrated deployment scenarios, you can see these settings are overridden by the `docker-compose.yml` file.
+The `appsettings.json` file does not contain `AuthServer:IsOnK8s` and `AuthServer:MetaAddress` settings since they are used for orchestrated deployment scenarios, you can see these settings are overridden by the `docker-compose.yml` file.
`Dockerfile.local` is provided under this project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
ENTRYPOINT ["dotnet", "Acme.BookStore.Web.dll"]
```
@@ -289,11 +289,11 @@ docker build -f Dockerfile.local -t acme/bookstore-web:latest . #Builds the imag
{{ end }} {{ if Tiered == "No" }}MVC/Razor Pages application is a server-side rendering application that contains both the OpenID-provider and the Http.Api endpoints within self; it will be a single application to deploy. `Dockerfile.local` is provided under this project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
-FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /src
RUN dotnet dev-certs https -v -ep authserver.pfx -p 2D7AA457-5D33-48D6-936F-C48E5EF468ED
@@ -318,36 +318,17 @@ if (!hostingEnvironment.IsDevelopment())
options.AddDevelopmentEncryptionAndSigningCertificate = false;
});
- PreConfigure(builder =>
+ PreConfigure(serverBuilder =>
{
- builder.AddSigningCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.AddEncryptionCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.SetIssuer(new Uri(configuration["AuthServer:Authority"]));
+ serverBuilder.AddProductionEncryptionAndSigningCertificate("openiddict.pfx", configuration["AuthServer:CertificatePassPhrase"]!);
+ serverBuilder.SetIssuer(new Uri(configuration["AuthServer:Authority"]!));
});
}
```
This configuration disables the *DevelopmentEncryptionAndSigningCertificate* and uses a self-signed certificate called `authserver.pfx`. for **signing and encrypting the tokens**. This certificate is created when the docker image is built using the `dotnet dev-certs` tooling. It is a sample-generated certificate, and it is **recommended** to update it for the production environment. You can check the [OpenIddict Encryption and signing credentials documentation](https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html) for different options and customization.
-The `GetSigningCertificate` method is a private method located under the same **WebModule**:
-
-```csharp
-private X509Certificate2 GetSigningCertificate(IWebHostEnvironment hostingEnv, IConfiguration configuration)
-{
- var fileName = "authserver.pfx";
- var passPhrase = "2D7AA457-5D33-48D6-936F-C48E5EF468ED";
- var file = Path.Combine(hostingEnv.ContentRootPath, fileName);
-
- if (!File.Exists(file))
- {
- throw new FileNotFoundException($"Signing Certificate couldn't found: {file}");
- }
-
- return new X509Certificate2(file, passPhrase);
-}
-```
-
-> You can always create any self-signed certificate using any other tooling outside the Dockerfile. You need to remember to set them as **embedded resource** since the `GetSigningCertificate` method will be checking this file physically.
+> You can always create any self-signed certificate using any other tooling outside the Dockerfile. You need to remember to set them as **embedded resource**.
If you don't want to use the `build-images-locally.ps1` to build the images or to build this image individually and manually, navigate to the **Web** folder and run:
@@ -369,7 +350,7 @@ docker build -f Dockerfile.local -t acme/bookstore-web:latest . #Builds the imag
In the **BlazorModule** under authentication configuration, there is an extra configuration for containerized environment support:
```csharp
-if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
+if (Convert.ToBoolean(configuration["AuthServer:IsOnK8s"]))
{
context.Services.Configure("oidc", options =>
{
@@ -411,13 +392,13 @@ if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
This is used when the **AuthServer is running on docker containers(or pods)** to configure the redirection URLs for the internal network and the web. The application must be redirected to real DNS (localhost in this case) when the `/authorize` and `/logout` requests over the browser but handle the token validation inside the isolated network without going out to the internet. `"AuthServer:MetaAddress"` appsetting should indicate the container/pod service name while the `AuthServer:Authority` should be pointing to real DNS for the browser to redirect.
-The `appsettings.json` file does not contain `AuthServer:IsContainerizedOnLocalhost` and `AuthServer:MetaAddress` settings since they are used for orchestrated deployment scenarios, you can see these settings are overridden by the `docker-compose.yml` file.
+The `appsettings.json` file does not contain `AuthServer:IsOnK8s` and `AuthServer:MetaAddress` settings since they are used for orchestrated deployment scenarios, you can see these settings are overridden by the `docker-compose.yml` file.
`Dockerfile.local` is provided under this project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
ENTRYPOINT ["dotnet", "Acme.BookStore.Blazor.dll"]
```
@@ -432,11 +413,11 @@ docker build -f Dockerfile.local -t acme/bookstore-blazor:latest . #Builds the i
{{ end }} {{ if Tiered == "No" }}Blazor Server application is a server-side rendering application that contains both the OpenID-provider and the Http.Api endpoints within self; it will be a single application to deploy. `Dockerfile.local` is provided under this project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
-FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /src
RUN dotnet dev-certs https -v -ep authserver.pfx -p 2D7AA457-5D33-48D6-936F-C48E5EF468ED
@@ -461,36 +442,17 @@ if (!hostingEnvironment.IsDevelopment())
options.AddDevelopmentEncryptionAndSigningCertificate = false;
});
- PreConfigure(builder =>
+ PreConfigure(serverBuilder =>
{
- builder.AddSigningCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.AddEncryptionCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.SetIssuer(new Uri(configuration["AuthServer:Authority"]));
+ serverBuilder.AddProductionEncryptionAndSigningCertificate("openiddict.pfx", configuration["AuthServer:CertificatePassPhrase"]!);
+ serverBuilder.SetIssuer(new Uri(configuration["AuthServer:Authority"]!));
});
}
```
This configuration disables the *DevelopmentEncryptionAndSigningCertificate* and uses a self-signed certificate called `authserver.pfx`. for **signing and encrypting the tokens**. This certificate is created when the docker image is built using the `dotnet dev-certs` tooling. It is a sample-generated certificate, and it is **recommended** to update it for the production environment. You can check the [OpenIddict Encryption and signing credentials documentation](https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html) for different options and customization.
-The `GetSigningCertificate` method is a private method located under the same **BlazorModule**:
-
-```csharp
-private X509Certificate2 GetSigningCertificate(IWebHostEnvironment hostingEnv, IConfiguration configuration)
-{
- var fileName = "authserver.pfx";
- var passPhrase = "2D7AA457-5D33-48D6-936F-C48E5EF468ED";
- var file = Path.Combine(hostingEnv.ContentRootPath, fileName);
-
- if (!File.Exists(file))
- {
- throw new FileNotFoundException($"Signing Certificate couldn't found: {file}");
- }
-
- return new X509Certificate2(file, passPhrase);
-}
-```
-
-> You can always create any self-signed certificate using any other tooling outside the dockerfile. You need to remember to set them as **embedded resource** since the `GetSigningCertificate` method will be checking this file physically.
+> You can always create any self-signed certificate using any other tooling outside the Dockerfile. You need to remember to set them as **embedded resource**.
If you don't want to use the `build-images-locally.ps1` to build the images or to build this image individually and manually, navigate to the **BlazorModule** folder and run:
@@ -562,7 +524,7 @@ server {
}
```
-This configuration allows returning the `dynamic-env.json` file as a static file, which ABP Angular application uses for environment variables in one of the first initial requests when rendering the page. **The `dynamic-env.json` file you need to override is located under `aspnet-core/etc/docker`** folder.
+This configuration allows returning the `dynamic-env.json` file as a static file, which ABP Angular application uses for environment variables in one of the first initial requests when rendering the page. **The `dynamic-env.json` file you need to override is located under `aspnet-core/etc/docker-compose`** folder.
{{ if Tiered == "No" }}
@@ -645,8 +607,8 @@ docker build -f Dockerfile.local -t acme/bookstore-angular:latest . #Builds the
The Blazor application uses [nginx:alpine-slim](https://hub.docker.com/layers/library/nginx/alpine-slim/images/sha256-0f859db466fda2c52f62b48d0602fb26867d98edbd62c26ae21414b3dea8d8f4?context=explore) base image to host the blazor application. You can modify the base image based on your preference in the `Dockerfile.local` which provided under the Blazor folder of your solution as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS build
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS build
+COPY bin/Release/net9.0/publish/ app/
FROM nginx:alpine-slim AS final
WORKDIR /usr/share/nginx/html
@@ -701,11 +663,11 @@ docker build -f Dockerfile.local -t acme/bookstore-blazor:latest . #Builds the i
This is the backend application that contains the openid-provider functionality as well. The `dockerfile.local` is located under the `Http.Api.Host` project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
-FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /src
RUN dotnet dev-certs https -v -ep authserver.pfx -p 2D7AA457-5D33-48D6-936F-C48E5EF468ED
@@ -730,36 +692,17 @@ if (!hostingEnvironment.IsDevelopment())
options.AddDevelopmentEncryptionAndSigningCertificate = false;
});
- PreConfigure(builder =>
+ PreConfigure(serverBuilder =>
{
- builder.AddSigningCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.AddEncryptionCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.SetIssuer(new Uri(configuration["AuthServer:Authority"]));
+ serverBuilder.AddProductionEncryptionAndSigningCertificate("openiddict.pfx", configuration["AuthServer:CertificatePassPhrase"]!);
+ serverBuilder.SetIssuer(new Uri(configuration["AuthServer:Authority"]!));
});
}
```
This configuration disables the *DevelopmentEncryptionAndSigningCertificate* and uses a self-signed certificate called `authserver.pfx`. for **signing and encrypting the tokens**. This certificate is created when the docker image is built using the `dotnet dev-certs` tooling. It is a sample-generated certificate, and it is **recommended** to update it for the production environment. You can check the [OpenIddict Encryption and signing credentials documentation](https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html) for different options and customization.
-The `GetSigningCertificate` method is a private method located under the same **HttpApiHostModule**:
-
-```csharp
-private X509Certificate2 GetSigningCertificate(IWebHostEnvironment hostingEnv, IConfiguration configuration)
-{
- var fileName = "authserver.pfx";
- var passPhrase = "2D7AA457-5D33-48D6-936F-C48E5EF468ED";
- var file = Path.Combine(hostingEnv.ContentRootPath, fileName);
-
- if (!File.Exists(file))
- {
- throw new FileNotFoundException($"Signing Certificate couldn't found: {file}");
- }
-
- return new X509Certificate2(file, passPhrase);
-}
-```
-
-> You can always create any self-signed certificate using any other tooling outside of the dockerfile. You need to keep in mind to set them as **embedded resource** since the `GetSigningCertificate` method will be checking this file physically.
+> You can always create any self-signed certificate using any other tooling outside the Dockerfile. You need to remember to set them as **embedded resource**.
If you don't want to use the `build-images-locally.ps1` to build the images or to build this image individually and manually, navigate to **Http.Api.Host** folder and run:
@@ -777,11 +720,11 @@ docker build -f Dockerfile.local -t acme/bookstore-api:latest . #Builds the imag
This is the backend application that contains the OpenID-provider functionality as well. The `dockerfile.local` is located under the `Http.Api.Host` project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
-FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /src
RUN dotnet dev-certs https -v -ep authserver.pfx -p 2D7AA457-5D33-48D6-936F-C48E5EF468ED
@@ -806,36 +749,17 @@ if (!hostingEnvironment.IsDevelopment())
options.AddDevelopmentEncryptionAndSigningCertificate = false;
});
- PreConfigure(builder =>
+ PreConfigure(serverBuilder =>
{
- builder.AddSigningCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.AddEncryptionCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.SetIssuer(new Uri(configuration["AuthServer:Authority"]));
+ serverBuilder.AddProductionEncryptionAndSigningCertificate("openiddict.pfx", configuration["AuthServer:CertificatePassPhrase"]!);
+ serverBuilder.SetIssuer(new Uri(configuration["AuthServer:Authority"]!));
});
}
```
-This configuration disables the *DevelopmentEncryptionAndSigningCertificate* and uses a self-signed certificate called `authserver.pfx`. for **signing and encrypting the tokens**. This certificate is created when the docker image is built using the `dotnet dev-certs` tooling. It is a sample-generated certificate, and it is **recommended** to update it for the production environment. You can check the [OpenIddict Encryption and signing credentials documentation](https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html) for different customization options.
-
-The `GetSigningCertificate` method is a private method located under the same **HttpApiHostModule**:
-
-```csharp
-private X509Certificate2 GetSigningCertificate(IWebHostEnvironment hostingEnv, IConfiguration configuration)
-{
- var fileName = "authserver.pfx";
- var passPhrase = "2D7AA457-5D33-48D6-936F-C48E5EF468ED";
- var file = Path.Combine(hostingEnv.ContentRootPath, fileName);
-
- if (!File.Exists(file))
- {
- throw new FileNotFoundException($"Signing Certificate couldn't found: {file}");
- }
-
- return new X509Certificate2(file, passPhrase);
-}
-```
+This configuration disables the *DevelopmentEncryptionAndSigningCertificate* and uses a self-signed certificate called `authserver.pfx`. for **signing and encrypting the tokens**. This certificate is created when the docker image is built using the `dotnet dev-certs` tooling. It is a sample-generated certificate, and it is **recommended** to update it for the production environment. You can check the [OpenIddict Encryption and signing credentials documentation](https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html) for different options and customization.
-> You can always create any self-signed certificate using any other tooling outside the dockerfile. You need to remember to set them as **embedded resource** since the `GetSigningCertificate` method will be checking this file physically.
+> You can always create any self-signed certificate using any other tooling outside the Dockerfile. You need to remember to set them as **embedded resource**.
If you don't want to use the `build-images-locally.ps1` to build the images or to build this image individually and manually, navigate to **Http.Api.Host** folder and run:
@@ -855,11 +779,11 @@ docker build -f Dockerfile.local -t acme/bookstore-api:latest . #Builds the imag
This is the openid-provider application, the authentication server, which should be individually hosted compared to non-tiered application templates. The `dockerfile.local` is located under the `AuthServer` project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
-FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
+FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build
WORKDIR /src
RUN dotnet dev-certs https -v -ep authserver.pfx -p 2D7AA457-5D33-48D6-936F-C48E5EF468ED
@@ -884,36 +808,17 @@ if (!hostingEnvironment.IsDevelopment())
options.AddDevelopmentEncryptionAndSigningCertificate = false;
});
- PreConfigure(builder =>
+ PreConfigure(serverBuilder =>
{
- builder.AddSigningCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.AddEncryptionCertificate(GetSigningCertificate(hostingEnvironment, configuration));
- builder.SetIssuer(new Uri(configuration["AuthServer:Authority"]));
+ serverBuilder.AddProductionEncryptionAndSigningCertificate("openiddict.pfx", configuration["AuthServer:CertificatePassPhrase"]!);
+ serverBuilder.SetIssuer(new Uri(configuration["AuthServer:Authority"]!));
});
}
```
This configuration disables the *DevelopmentEncryptionAndSigningCertificate* and uses a self-signed certificate called `authserver.pfx`. for **signing and encrypting the tokens**. This certificate is created when the docker image is built using the `dotnet dev-certs` tooling. It is a sample-generated certificate, and it is **recommended** to update it for the production environment. You can check the [OpenIddict Encryption and signing credentials documentation](https://documentation.openiddict.com/configuration/encryption-and-signing-credentials.html) for different options and customization.
-The `GetSigningCertificate` method is a private method located under the same **AuthServerModule**:
-
-```csharp
-private X509Certificate2 GetSigningCertificate(IWebHostEnvironment hostingEnv, IConfiguration configuration)
-{
- var fileName = "authserver.pfx";
- var passPhrase = "2D7AA457-5D33-48D6-936F-C48E5EF468ED";
- var file = Path.Combine(hostingEnv.ContentRootPath, fileName);
-
- if (!File.Exists(file))
- {
- throw new FileNotFoundException($"Signing Certificate couldn't found: {file}");
- }
-
- return new X509Certificate2(file, passPhrase);
-}
-```
-
-> You can always create any self-signed certificate using any other tooling outside the dockerfile. You need to remember to set them as **embedded resource** since the `GetSigningCertificate` method will be checking this file physically.
+> You can always create any self-signed certificate using any other tooling outside the Dockerfile. You need to remember to set them as **embedded resource**.
If you don't want to use the `build-images-locally.ps1` to build the images or to build this image individually and manually, navigate to the **AuthServer** folder and run:
@@ -927,8 +832,8 @@ docker build -f Dockerfile.local -t acme/bookstore-authserver:latest . #Builds t
This is the backend application that exposes the endpoints and swagger UI. It is not a multi-stage dockerfile; hence you need to have already built this application in **Release mode** to use this dockerfile. The `dockerfile.local` is located under the `Http.Api.Host` project as below;
```dockerfile
-FROM mcr.microsoft.com/dotnet/aspnet:7.0
-COPY bin/Release/net7.0/publish/ app/
+FROM mcr.microsoft.com/dotnet/aspnet:9.0
+COPY bin/Release/net9.0/publish/ app/
WORKDIR /app
ENTRYPOINT ["dotnet", "Acme.BookStore.HttpApi.Host.dll"]
```
@@ -944,7 +849,7 @@ docker build -f Dockerfile.local -t acme/bookstore-api:latest . #Builds the imag
## Running Docker-Compose on Localhost
-Under the `etc/docker` folder, you can find the `docker-compose.yml` to run your application. To ease the running process, the template provides `run-docker.ps1` (and `run-docker.sh`) scripts that handle the HTTPS certificate creation, which is used in environment variables;
+Under the `etc/docker-compose` folder, you can find the `docker-compose.yml` to run your application. To ease the running process, the template provides `run-docker.ps1` (and `run-docker.sh`) scripts that handle the HTTPS certificate creation, which is used in environment variables;
```powershell
$currentFolder = $PSScriptRoot
@@ -1203,7 +1108,7 @@ This is the angular application we deploy on http://localhost:4200 by default us
> Don't forget to rebuild the `acme/bookstore-angular:latest` image after updating the `nginx.conf` file.
-The bookstore-angular service mounts the `etc/docker/dynamic-env.json` file to change the existing dynamic-env.json file, which is copied during image creation, to change the environment variables on deployment time instead of re-creating the docker image after each environmental variable change. **Do not forget to override the `dynamic-env.json` located under the `aspnet-core/etc/docker`** folder.
+The bookstore-angular service mounts the `etc/docker-compose/dynamic-env.json` file to change the existing dynamic-env.json file, which is copied during image creation, to change the environment variables on deployment time instead of re-creating the docker image after each environmental variable change. **Do not forget to override the `dynamic-env.json` located under the `aspnet-core/etc/docker-compose`** folder.
> If you are not using Docker with WSL, you may have problems with the volume mount permissions. You need to grant docker to be able to use the local file system. See this [SO answer](https://stackoverflow.com/a/20652410) for more information.
@@ -1438,7 +1343,7 @@ bookstore-web:
- Kestrel__Certificates__Default__Password=91f91912-5ab0-49df-8166-23377efaf3cc
- App__SelfUrl=https://localhost:44353
- AuthServer__RequireHttpsMetadata=false {{ if Tiered == "Yes" }}
- - AuthServer__IsContainerizedOnLocalhost=true
+ - AuthServer__IsOnK8s=true
- AuthServer__Authority=https://localhost:44334/
- RemoteServices__Default__BaseUrl=http://bookstore-api
- RemoteServices__AbpAccountPublic__BaseUrl=http://bookstore-authserver
@@ -1464,7 +1369,7 @@ This is the MVC/Razor Page application docker service is using the `acme/booksto
The MVC/Razor Page is a server-side rendering application that uses the **hybrid flow**. This flow uses **browser** to login/logout process to the OpenID-provider but issues the **access_token from the back-channel** (server-side). To achieve this functionality, the module class has extra `OpenIdConnectOptions` to override some of the events:
```csharp
-if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
+if (Convert.ToBoolean(configuration["AuthServer:IsOnK8s"]))
{
context.Services.Configure("oidc", options =>
{
@@ -1511,7 +1416,7 @@ if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
{{ if Tiered == "Yes" }}
-- `AuthServer__IsContainerizedOnLocalhost` is the configuration to enable the **OpenIdConnectOptions** to provide a different endpoint for the MetaAddress of the OpenID-provider and intercepting the URLS for *authorization* and *logout* endpoints.
+- `AuthServer__IsOnK8s` is the configuration to enable the **OpenIdConnectOptions** to provide a different endpoint for the MetaAddress of the OpenID-provider and intercepting the URLS for *authorization* and *logout* endpoints.
- `AuthServer__MetaAddress` is the `.well-known/openid-configuration` endpoint for issuing access_token and internal token validation. It is the containerized `http://bookstore-authserver` by default.
@@ -1691,7 +1596,7 @@ bookstore-blazor:
- Kestrel__Certificates__Default__Password=91f91912-5ab0-49df-8166-23377efaf3cc
- App__SelfUrl=https://localhost:44314
- AuthServer__RequireHttpsMetadata=false {{ if Tiered == "Yes" }}
- - AuthServer__IsContainerizedOnLocalhost=true
+ - AuthServer__IsOnK8s=true
- AuthServer__Authority=https://localhost:44334/
- AuthServer__MetaAddress=http://bookstore-authserver
- RemoteServices__Default__BaseUrl=http://bookstore-api
@@ -1718,7 +1623,7 @@ This is the Blazor Server application Docker service is using the `acme/bookstor
The Blazor Server is a server-side rendering application that uses the **hybrid flow**. This flow uses **browser** to login/logout process to the OpenID-provider but issues the **access_token from the back-channel** (server-side). To achieve this functionality, the module class has extra `OpenIdConnectOptions` to override some of the events:
```csharp
-if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
+if (Convert.ToBoolean(configuration["AuthServer:IsOnK8s"]))
{
context.Services.Configure("oidc", options =>
{
@@ -1765,7 +1670,7 @@ if (Convert.ToBoolean(configuration["AuthServer:IsContainerizedOnLocalhost"]))
{{ if Tiered == "Yes" }}
-- `AuthServer__IsContainerizedOnLocalhost` is the configuration to enable the **OpenIdConnectOptions** to provide a different endpoint for the MetaAddress of the OpenID-provider and intercept the URLS for *authorization* and *logout* endpoints.
+- `AuthServer__IsOnK8s` is the configuration to enable the **OpenIdConnectOptions** to provide a different endpoint for the MetaAddress of the OpenID-provider and intercept the URLS for *authorization* and *logout* endpoints.
- `AuthServer__MetaAddress` is the `.well-known/openid-configuration` endpoint for issuing the access_token and internal token validation. It is the containerized `http://bookstore-authserver` by default.
diff --git a/docs/en/solution-templates/layered-web-application/solution-structure.md b/docs/en/solution-templates/layered-web-application/solution-structure.md
index 680df73a59..3afd1b1274 100644
--- a/docs/en/solution-templates/layered-web-application/solution-structure.md
+++ b/docs/en/solution-templates/layered-web-application/solution-structure.md
@@ -214,3 +214,7 @@ This project is an application that hosts the API of the solution. It has its ow
Just like the default structure, this project contains the User Interface (UI) of the application. It contains razor pages, JavaScript files, style files, images and so on...
This project contains an `appsettings.json` file, but this time it does not have a connection string because it never connects to the database. Instead, it mainly contains the endpoint of the remote API server and the authentication server.
+
+### Docker Compose
+
+The **docker-compose** configuration files in the `etc/docker-compose` folder is configured to run the solution with Docker. See [Docker Deployment using Docker Compose](deployment/deployment-docker-compose.md) for more information.
\ No newline at end of file
diff --git a/docs/en/studio/monitoring-applications.md b/docs/en/studio/monitoring-applications.md
index 645df15418..6d0c5523a3 100644
--- a/docs/en/studio/monitoring-applications.md
+++ b/docs/en/studio/monitoring-applications.md
@@ -48,7 +48,7 @@ public override void ConfigureServices(ServiceConfigurationContext context)
In this tab, you can view comprehensive overall information. You have the option to search by application name and filter by application state. To reset all filters, use the *Clear Filters* button. When you apply a filter header informations gonna refresh by filtered applications.
-- `Apps Running`: The number of applications running. It includes CLI and C# applications. In the example two C# microservice applications and one CLI application is running.
+- `Apps Running`: The number of applications running. It includes only C# applications. In the example, nine C# microservice applications are running.
- `Requests`: The number of HTTP requests received by all C# applications.
- `Events`: The number of [Distributed Event](../framework/infrastructure/event-bus/distributed) sent or received by all C# applications.
- `Exceptions`: The number of exceptions thrown by all C# applications.
diff --git a/docs/en/studio/release-notes.md b/docs/en/studio/release-notes.md
index 8555e19d18..94ec619a34 100644
--- a/docs/en/studio/release-notes.md
+++ b/docs/en/studio/release-notes.md
@@ -2,6 +2,20 @@
This document contains **brief release notes** for each ABP Studio release. Release notes only include **major features** and **visible enhancements**. Therefore, they don't include all the development done in the related version.
+## 0.9.22 (2025-01-22)
+
+* Allowed to display multiple installation notes.
+* Showed **Inner Exceptions** in the Solution Runner side-panel
+* Hidden logs when no selected application is present.
+* Added full docker compose to template.
+* Zipped microservice module template for better structuring the solution.
+* Upgraded templates to version `9.0.4`.
+
+## 0.9.21 (2025-01-09)
+
+* Showed a db test connection message while testing the database connection.
+* Fixed books sample's application service.
+
## 0.9.20 (2025-01-08)
* Upgraded templates to version `9.0.3`.
diff --git a/docs/en/studio/running-applications.md b/docs/en/studio/running-applications.md
index 9e266ef7a9..5392250153 100644
--- a/docs/en/studio/running-applications.md
+++ b/docs/en/studio/running-applications.md
@@ -230,3 +230,11 @@ CLI applications uses the [powershell](https://learn.microsoft.com/en-us/powersh
- `Remove`: This option allows you to delete the selected application.
> When CLI applications start chain icon won't be visible, because only C# applications can connect the ABP Studio.
+
+## Docker Compose
+
+You can manually run applications using [Docker Compose](https://docs.docker.com/compose/). This allows for easy setup and management of multi-container Docker applications. To get started, ensure you have Docker and Docker Compose installed on your machine.
+
+Refer to the [Deployment with Docker Compose](../solution-templates/layered-web-application/deployment/deployment-docker-compose.md) documentation for detailed instructions on how to configure and run your applications using `docker-compose`.
+
+> Note: The **Docker Compose** is not available in the ABP Studio interface.
\ No newline at end of file
diff --git a/docs/en/studio/version-mapping.md b/docs/en/studio/version-mapping.md
index 731e38a128..fe39fb7c67 100644
--- a/docs/en/studio/version-mapping.md
+++ b/docs/en/studio/version-mapping.md
@@ -4,7 +4,8 @@ This document provides a general overview of the relationship between various ve
| **ABP Studio Version** | **ABP Version of Startup Template** |
|------------------------|---------------------------|
-| 0.9.20 | 9.0.3 |
+| 0.9.22 | 9.0.4 |
+| 0.9.20 - 0.9.21 | 9.0.3 |
| 0.9.17 to 0.9.19 | 9.0.2 |
| 0.9.15 - 0.9.16 | 9.0.1 |
| 0.9.9 to 0.9.14 | 9.0.0 |
diff --git a/docs/en/tutorials/book-store/part-07.md b/docs/en/tutorials/book-store/part-07.md
index 0708ecfcb9..92108c4a35 100644
--- a/docs/en/tutorials/book-store/part-07.md
+++ b/docs/en/tutorials/book-store/part-07.md
@@ -180,7 +180,7 @@ public class MongoDbAuthorRepository
public async Task FindByNameAsync(string name)
{
- var queryable = await GetMongoQueryableAsync();
+ var queryable = await GetQueryableAsync();
return await queryable.FirstOrDefaultAsync(author => author.Name == name);
}
@@ -190,14 +190,13 @@ public class MongoDbAuthorRepository
string sorting,
string filter = null)
{
- var queryable = await GetMongoQueryableAsync();
+ var queryable = await GetQueryableAsync();
return await queryable
- .WhereIf>(
+ .WhereIf>(
!filter.IsNullOrWhiteSpace(),
author => author.Name.Contains(filter)
)
.OrderBy(sorting)
- .As>()
.Skip(skipCount)
.Take(maxResultCount)
.ToListAsync();
diff --git a/docs/en/tutorials/modular-crm/images/abp-studio-ordering-swagger-ui-in-browser.png b/docs/en/tutorials/modular-crm/images/abp-studio-ordering-swagger-ui-in-browser.png
index 1318691ae9..feb6627be7 100644
Binary files a/docs/en/tutorials/modular-crm/images/abp-studio-ordering-swagger-ui-in-browser.png and b/docs/en/tutorials/modular-crm/images/abp-studio-ordering-swagger-ui-in-browser.png differ
diff --git a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-order-execute.png b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-order-execute.png
index b0f384f15d..6d4f5320ee 100644
Binary files a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-order-execute.png and b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-order-execute.png differ
diff --git a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-execute.png b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-execute.png
index e07804e37d..c85348933a 100644
Binary files a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-execute.png and b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-execute.png differ
diff --git a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-try.png b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-try.png
index 52a99ce8fa..8229656886 100644
Binary files a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-try.png and b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-create-product-try.png differ
diff --git a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-in-browser.png b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-in-browser.png
index 1b5fec9205..d412e0c509 100644
Binary files a/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-in-browser.png and b/docs/en/tutorials/modular-crm/images/abp-studio-swagger-ui-in-browser.png differ
diff --git a/docs/en/tutorials/modular-crm/index.md b/docs/en/tutorials/modular-crm/index.md
index e4bf64fbd7..723425a230 100644
--- a/docs/en/tutorials/modular-crm/index.md
+++ b/docs/en/tutorials/modular-crm/index.md
@@ -29,8 +29,8 @@ This tutorial is organized as the following parts:
## Download the Source Code
-You can download the completed sample solution [here](https://github.com/abpframework/abp-samples/tree/master/ModularCRM).
+You can download the completed sample solution [here](https://github.com/abpframework/abp-samples/tree/master/ModularCrm).
## See Also
-* [Book Store: Web Application Development Tutorial](../book-store/index.md)
\ No newline at end of file
+* [Book Store: Web Application Development Tutorial](../book-store/index.md)
diff --git a/docs/en/tutorials/modular-crm/part-03.md b/docs/en/tutorials/modular-crm/part-03.md
index 3d8896d8a5..2dabfc54eb 100644
--- a/docs/en/tutorials/modular-crm/part-03.md
+++ b/docs/en/tutorials/modular-crm/part-03.md
@@ -387,7 +387,10 @@ Configure(options =>
options.ConventionalControllers.Create(typeof(ModularCrmModule).Assembly);
//ADD THE FOLLOWING LINE:
- options.ConventionalControllers.Create(typeof(ProductsApplicationModule).Assembly);
+ options.ConventionalControllers.Create(typeof(ProductsApplicationModule).Assembly, settings =>
+ {
+ settings.RootPath = "products";
+ });
});
````
@@ -409,7 +412,7 @@ Once you see the user interface of the web application, type `/swagger` at the e

-Expand the `/api/app/product` API and click the *Try it out* button as shown in the following figure:
+Expand the `/api/products/product` API and click the *Try it out* button as shown in the following figure:

diff --git a/docs/en/tutorials/modular-crm/part-05.md b/docs/en/tutorials/modular-crm/part-05.md
index a489548b65..59aa56f2f4 100644
--- a/docs/en/tutorials/modular-crm/part-05.md
+++ b/docs/en/tutorials/modular-crm/part-05.md
@@ -345,7 +345,9 @@ public class OrderAppService : OrderingAppService, IOrderAppService
}
````
-Open the `ModularCrmModule` class in the main application's solution (the `ModularCrm` solution), find the `ConfigureAutoApiControllers` method and add the following lines inside that method:
+### Exposing Application Services as HTTP API Controllers
+
+After implementing the application service, now we need to create HTTP API endpoints for the ordering module. For that purpose, open the `ModularCrmModule` class in the main application's solution (the `ModularCrm` solution), find the `ConfigureAutoApiControllers` method and add the following lines inside that method:
````csharp
private void ConfigureAutoApiControllers()
@@ -353,10 +355,16 @@ private void ConfigureAutoApiControllers()
Configure(options =>
{
options.ConventionalControllers.Create(typeof(ModularCrmModule).Assembly);
- options.ConventionalControllers.Create(typeof(ProductsApplicationModule).Assembly);
+ options.ConventionalControllers.Create(typeof(ProductsApplicationModule).Assembly, settings =>
+ {
+ settings.RootPath = "products";
+ });
//ADD THE FOLLOWING LINE:
- options.ConventionalControllers.Create(typeof(OrderingModule).Assembly);
+ options.ConventionalControllers.Create(typeof(OrderingModule).Assembly, settings =>
+ {
+ settings.RootPath = "orders";
+ });
});
}
````
@@ -373,7 +381,7 @@ Once you see the user interface of the web application, type `/swagger` at the e

-Expand the `/api/app/order` API and click the *Try it out* button. Then, create a few orders by filling in the request body and clicking the *Execute* button:
+Expand the `/api/orders/order` API and click the *Try it out* button. Then, create a few orders by filling in the request body and clicking the *Execute* button:

diff --git a/framework/src/Volo.Abp.Cli.Core/Volo/Abp/Cli/ProjectBuilding/Building/Steps/ChangeThemeStep.cs b/framework/src/Volo.Abp.Cli.Core/Volo/Abp/Cli/ProjectBuilding/Building/Steps/ChangeThemeStep.cs
index 92da7dce50..b55c9195f0 100644
--- a/framework/src/Volo.Abp.Cli.Core/Volo/Abp/Cli/ProjectBuilding/Building/Steps/ChangeThemeStep.cs
+++ b/framework/src/Volo.Abp.Cli.Core/Volo/Abp/Cli/ProjectBuilding/Building/Steps/ChangeThemeStep.cs
@@ -37,9 +37,9 @@ public class ChangeThemeStep : ProjectBuildPipelineStep
{
var defaultThemeName = context.BuildArgs.TemplateName is AppTemplate.TemplateName or AppNoLayersTemplate.TemplateName
? LeptonXLite : LeptonX;
-
+
new RemoveFilesStep($"/Themes/{defaultThemeName}").Execute(context);
-
+
ChangeThemeToBasicForMvcProjects(context, defaultThemeName);
ChangeThemeToBasicForBlazorProjects(context, defaultThemeName);
ChangeThemeToBasicForBlazorServerProjects(context, defaultThemeName);
@@ -622,6 +622,11 @@ public class ChangeThemeStep : ProjectBuildPipelineStep
return;
}
+ if (!file.Content.Contains("ThemeModule"))
+ {
+ return;
+ }
+
file.NormalizeLineEndings();
var lines = file.GetLines().ToList();
@@ -630,7 +635,7 @@ public class ChangeThemeStep : ProjectBuildPipelineStep
{
lines.AddFirst(@namespace);
}
-
+
file.SetLines(lines);
}
@@ -641,7 +646,7 @@ public class ChangeThemeStep : ProjectBuildPipelineStep
".Web", ".AuthServer", ".Web.Public", ".Web.Public.Host",
"" //for app-nolayers-mvc
};
-
+
if(!context.Symbols.Contains("tiered"))
{
projectNames.Add(".HttpApi.Host");
@@ -716,7 +721,7 @@ public class ChangeThemeStep : ProjectBuildPipelineStep
context,
$"_Host.cshtml",
$"{defaultThemeName}Theme.Components",
- "BasicTheme.Themes.Basic"
+ "BasicTheme.Themes.Basic"
);
ReplaceAllKeywords(
diff --git a/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEfCoreNavigationHelper.cs b/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEfCoreNavigationHelper.cs
index d56660be57..63ddc222bd 100644
--- a/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEfCoreNavigationHelper.cs
+++ b/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEfCoreNavigationHelper.cs
@@ -31,6 +31,14 @@ public class AbpEfCoreNavigationHelper : ITransientDependency
protected virtual void EntityEntryTrackedOrStateChanged(EntityEntry entityEntry)
{
+ if (entityEntry.State is EntityState.Unchanged or EntityState.Modified)
+ {
+ foreach (var entry in EntityEntries.Values.Where(x => x.NavigationEntries.Any()))
+ {
+ entry.UpdateNavigationEntries();
+ }
+ }
+
if (entityEntry.State != EntityState.Unchanged)
{
return;
@@ -189,6 +197,22 @@ public class AbpEfCoreNavigationHelper : ITransientDependency
return navigationEntryProperty != null && navigationEntryProperty.IsModified;
}
+ public virtual AbpNavigationEntry? GetNavigationEntry(EntityEntry entityEntry, int navigationEntryIndex)
+ {
+ var entryId = GetEntityEntryIdentity(entityEntry);
+ if (entryId == null)
+ {
+ return null;
+ }
+
+ if (!EntityEntries.TryGetValue(entryId, out var abpEntityEntry))
+ {
+ return null;
+ }
+
+ return abpEntityEntry.NavigationEntries.ElementAtOrDefault(navigationEntryIndex);
+ }
+
protected virtual string? GetEntityEntryIdentity(EntityEntry entityEntry)
{
if (entityEntry.Entity is IEntity entryEntity && entryEntity.GetKeys().Length == 1)
diff --git a/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEntityEntry.cs b/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEntityEntry.cs
index 0aef48e0d1..4b8a531db1 100644
--- a/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEntityEntry.cs
+++ b/framework/src/Volo.Abp.EntityFrameworkCore/Volo/Abp/EntityFrameworkCore/ChangeTrackers/AbpEntityEntry.cs
@@ -1,3 +1,4 @@
+using System.Collections;
using System.Collections.Generic;
using System.Linq;
using Microsoft.EntityFrameworkCore;
@@ -32,6 +33,49 @@ public class AbpEntityEntry
EntityEntry = entityEntry;
NavigationEntries = EntityEntry.Navigations.Select(x => new AbpNavigationEntry(x, x.Metadata.Name)).ToList();
}
+
+ public void UpdateNavigationEntries()
+ {
+ foreach (var navigationEntry in NavigationEntries)
+ {
+ if (IsModified ||
+ EntityEntry.State == EntityState.Modified ||
+ navigationEntry.IsModified ||
+ navigationEntry.NavigationEntry.IsModified)
+ {
+ continue;
+ }
+
+ var navigation = EntityEntry.Navigations.FirstOrDefault(n => n.Metadata.Name == navigationEntry.Name);
+
+ var currentValue = AbpNavigationEntry.GetOriginalValue(navigation?.CurrentValue);
+ if (currentValue == null)
+ {
+ continue;
+ }
+
+ switch (navigationEntry.OriginalValue)
+ {
+ case null:
+ navigationEntry.OriginalValue = currentValue;
+ break;
+ case IEnumerable originalValueCollection when currentValue is IEnumerable currentValueCollection:
+ {
+ var existingList = originalValueCollection.Cast