Skip to content

Commit a3ee229

Browse files
committed
Merge branch 'master' into dev
2 parents 32b9ab9 + 4b7b4fb commit a3ee229

25 files changed

+104
-23
lines changed

doc-obsolete/Development-Guide-Angular.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1089,9 +1089,9 @@ new tenant registration).
10891089

10901090
We are using [angular-cli](https://cli.angular.io/) for development &
10911091
deployment. Angular CLI has it's own build command that can be used to
1092-
build your application:
1092+
build your application. Below command uses Gulp and Angular CLI to build your application.
10931093

1094-
ng build --prod
1094+
npm run publish
10951095

10961096
This command uses **dist** folder as output. Just remember to change
10971097
**assets/appconfig.json** file with your own configuration.

doc-obsolete/Step-by-step-angular-publish-to-iis.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@ Check [Host ASP.NET Core on Windows with IIS](https://docs.microsoft.com/en-us/a
2929

3030
We are using angular-cli for development & deployment. Angular CLI has it's own build command that can be used to build your application:
3131

32-
- Run `ng build --prod`. This command uses dist folder as output.
32+
- Run `npm run publish`. This command uses dist folder as output.
3333
- Change `assets/appconfig.production.json` file with your own configuration.
3434
- After ng build command, dist folder contains all necessary files to create a web site under IIS. (For example: copy files from `\*.dist` to `C:\inetpub\wwwroot\angularwebsite`).
3535

doc-obsolete/Step-by-step-publish-to-azure-angular.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,14 +83,14 @@ Select "**azure-publish-demo-server**" and click "**OK**", then click "**Publish
8383
The details will be explained in the next lines. Here are the quick steps to publish the **AngularUI** to the Azure
8484

8585
- Run the `yarn` command to restore packages
86-
- Run the `ng build --prod`
86+
- Run the `npm run publish`
8787
- Copy the web.config file that is placed in **angular** folder root to dist folder
8888
- Configure the **angular/dist/assets/appconfig.json**
8989
- Send the required files to the Azure
9090

9191
### Prepare The Publish Folder
9292

93-
Run the `yarn` command to restore packages and run the `ng build --prod` to create publish folder that named **dist**.
93+
Run the `yarn` command to restore packages and run the `npm run publish` to create publish folder that named **dist**.
9494

9595
<img src="images/azure-publish-angular-publish-angular.png">
9696

docs/en/Change-Logs.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,19 @@ jQuery and ASP.NET Core + Angular versions beginning from v4.1. See
66

77
The change logs in this page are just a summary of major changes. Detailed release notes are shared on the GitHub repository (only available to the customers).
88

9+
## 8.8.0 (2020-05-22)
10+
11+
* Social login settings per tenant (Mvc project).
12+
* Azure Key Vault support.
13+
* Upgraded to ABP v5.8.
14+
* Enhancements and bug fixes.
15+
16+
## 8.7.0 (2020-05-07)
17+
18+
* Added Non-Modal CRUD pages generation to Power Tools.
19+
* Upgraded to ABP v5.7.
20+
* Enhancements and bug fixes.
21+
922
## 8.6.0 (2020-04-20)
1023

1124
* Upgraded to ABP v5.6.

docs/en/Deleting-A-Metronic-Theme-Mvc-Core.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ Metronic theme currently has 12 different themes and AspNet Zero includes them a
1212
* Go to **Areas -> AppAreaName-> Views **folder
1313
* Go to **Layout** folder
1414
* Open `_ThemeSelectionPanel.cshtml` and delete Theme2 related code parts
15+
* Delete ```Theme2/_Layout.cshtml``` file.
1516
* Go to **UICustomization** folder
1617
* Delete `_Theme2Settings.cshtml`
1718
* Open `Index.cshml` and delete Theme2 code parts

docs/en/Deployment-Angular-Publish-Azure.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -96,7 +96,7 @@ The details will be explained in the next lines. Here are the quick steps to pub
9696

9797
### Prepare The Publish Folder
9898

99-
Run the `yarn` command to restore packages and run the `ng build --prod` to create publish folder that named **dist**.
99+
Run the `yarn` command to restore packages and run the `npm run publish` to create publish folder that named **dist**.
100100

101101
<img src="images/azure-publish-angular-publish-angular.png">
102102

docs/en/Deployment-Angular-Publish-IIS.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,13 +25,15 @@ Publishing ASP.NET Zero Host project is no different to any other ASP.NET Core A
2525

2626
<img src="images/iis-core-publish-configure-app-pool.png">
2727

28+
The project contains a `web.config` file, its contents may be changed during development, please check the` web.config` file after publishing, especially the `ASPNETCORE_ENVIRONMENT` setting.
29+
2830
Check [Host ASP.NET Core on Windows with IIS](https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/index?view=aspnetcore-2.1) document for more detail.
2931

3032
## Angular Application Publishing
3133

3234
We are using angular-cli for development & deployment. Angular CLI has it's own build command that can be used to build your application:
3335

34-
- Run `ng build --prod`. This command uses dist folder as output.
36+
- Run `npm run publish`. This command uses dist folder as output.
3537
- Change `assets/appconfig.production.json` file with your own configuration.
3638
- After ng build command, dist folder contains all necessary files to create a web site under IIS. (For example: copy files from `\*.dist` to `C:\inetpub\wwwroot\angularwebsite`).
3739

docs/en/Deployment-Angular.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ For example: Move files in `.Host/wwwroot/dist` to `C:\inetpub\wwwroot\my-websit
99
We are using [angular-cli](https://cli.angular.io/) for development & deployment. Angular CLI has it's own build command that can be used to build your application:
1010

1111
```
12-
ng build --prod
12+
npm run publish
1313
```
1414

1515
This command uses **dist** folder as output. Just remember to change **assets/appconfig.json** file with your own configuration.

docs/en/Deployment-Mvc-Core-Azure.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ Following screen will be shown:
8383

8484
Select "**azure-publish-demo-server**" and click "**OK**", then click "**Publish**" button. **Web.Mvc** application is live now:
8585

86-
<img src="images/azure-publish-core-mvc-ui-admin.png">
86+
<img src="images/azure-publish-core-mvc-ui-admin-2.png">
8787

8888
## Publish Public Website to The Azure
8989

@@ -97,8 +97,6 @@ The details will be explained in the next lines. Here are the quick steps to pub
9797

9898
Run the **npm run build** command to create js and css bundles.
9999

100-
<img src="images/azure-publish-core-mvc-bundle-public.png">
101-
102100
### Configure the appsettings.production.json
103101

104102
Azure is using **appsettings.production.json** that is placed in the **Web.Public**, so this file should be configured like following:

docs/en/Deployment-Mvc-Core-IIS.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,8 @@ Publishing ASP.NET Zero Core MVC project is no different to any other ASP.NET Co
2424
<img src="images/iis-core-publish-configure-app-pool.png">
2525

2626

27+
The project contains a `web.config` file, its contents may be changed during development, please check the` web.config` file after publishing, especially the `ASPNETCORE_ENVIRONMENT` setting.
28+
2729
For instructions on how to install the ASP.NET Core Module, see [Install the .NET Core Hosting Bundle](https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/index?view=aspnetcore-2.1#install-the-net-core-hosting-bundle).
2830

2931
For more information see [Host ASP.NET Core on Windows with IIS](https://docs.microsoft.com/en-us/aspnet/core/host-and-deploy/iis/index?view=aspnetcore-2.1) document

docs/en/Developing-Step-By-Step-Angular-Creating-PhoneBook-Component.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -40,15 +40,15 @@ As we declared in **phonebook.component.ts** we should create a
4040
<div [@routerTransition]>
4141
<div class="kt-content kt-grid__item kt-grid__item--fluid kt-grid kt-grid--hor">
4242
<div class="kt-subheader kt-grid__item">
43-
<div class="kt-container ">
43+
<div [class]="containerClass">
4444
<div class="kt-subheader__main">
4545
<h3 class="kt-subheader__title">
4646
<span>{{"PhoneBook" | localize}}</span>
4747
</h3>
4848
</div>
4949
</div>
5050
</div>
51-
<div class="kt-container kt-grid__item kt-grid__item--fluid">
51+
<div [class]="containerClass + ' kt-grid__item kt-grid__item--fluid'"
5252
<div class="kt-portlet kt-portlet--mobile">
5353
<div class="kt-portlet__body kt-portlet__body--fit">
5454
<p>PHONE BOOK CONTENT COMES HERE!</p>
@@ -109,4 +109,4 @@ any changes made to any file in the application.
109109

110110
## Next
111111

112-
- [Creating Person Entity](Developing-Step-By-Step-Angular-Creating-Person-Entity)
112+
- [Creating Person Entity](Developing-Step-By-Step-Angular-Creating-Person-Entity)
Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# Development with Docker Containers for MVC
2+
3+
ASP.NET Zero **Web** solution has a **docker folder** which contains various docker projects for your application to debug for your preferences.
4+
5+
<img src="images/development-docker-mvc/docker-projects-folder-core-mvc.png" alt="docker-projects-folder-core-mvc" style="zoom:150%;" />
6+
7+
To get started with using docker for development, there are some prerequisites.
8+
9+
### 1. Setting up the infrastructure
10+
11+
Infrastructure contains **mssql-server-linux** as a replacement for your LocalDb and **redis** server for your applications.
12+
13+
In your `aspnet-core\docker\infrastructure\` folder, you will find **run-infrastructure.ps1** file which uses **docker-compose.infrastructure.yml** file to setup your infrastructure. Running the shell script should have a similar output like below.
14+
15+
<img src="images/development-docker-mvc/docker-infrastructure-run.png" alt="docker-infrastructure-run"/>
16+
17+
After running the script, powershell will be hanging (non interactive) for you to see if there is any error occurred while creating the containers. You can use **Ctrl + X** to exit tailing the database logging to make the powershell interactive again.
18+
19+
### 2. Setting up the self-signed certificate
20+
21+
Your applications need certificate to enable https. Normally Visual Studio creates this certificate for you when you run your application for the first time however sometimes it doesn't when docker is involved. To overcome the issue, we create our own self-signed certificate for development.
22+
23+
In your `aspnet-core\docker\certificate\` folder, you will find **create-certificate.ps1** file to create the certificate. After running the shell script, you should have a similar output like below.
24+
<img src="images/development-docker-mvc/docker-create-dev-certificate.png" alt="docker-create-dev-certificate"/>
25+
26+
### 3. Running the migrator
27+
28+
In your `aspnet-core\docker\migrator\` folder, you will find **run-migrator** file to apply migrations for your application. Running the shell script should have a similar output like below.
29+
30+
<img src="images/development-docker-mvc/docker-migrate.png" alt="docker-migrate"/>
31+
32+
33+
34+
## Running applications on containers
35+
36+
In your applications **.Web** solution under **docker folder**, set as startup project you want to debug. Visual studio will instantly begin building the container. **Building containers may take some time** for the first time since it will be downloading required base images.
37+
38+
Below you can see **docker-compose-mvc** debugging:
39+
40+
<img src="images/development-docker-mvc/docker-mvc-running.png" alt="docker-mvc-running" style="zoom:100%;" />
41+
42+
There are three docker solutions you can set as startup project to run;
43+
44+
1. **docker-compose-host:** Runs Web.Host project.
45+
2. **docker-compose-mvc:** Runs only Web.Mvc project.
46+
3. **docker-compose-public:** Runs Web.Mvc and Web.Public projects together.
47+
48+
Each docker-compose files have override.yml files to set the other environments like certification information, docker volumes or AspnetCore environment.
49+
50+
<img src="images/development-docker-mvc/docker-override-configuration.png" alt="docker-override-configuration" style="zoom:100%;" />
51+
52+
Configuration is separated between **docker development** and default **IIS development**.
53+
54+
If you want to change the default connection string when running on containers; you need to change the environment variable **ConnectionStrings__Default** in corresponding **docker-compose.yml** shown below:
55+
56+
<img src="images/development-docker-mvc/docker-cs-configuration.png" alt="docker-cs-configuration" style="zoom:100%;" />
57+
58+
This environment variable overrides the connection string which has been set in appsettings.json. This way you can use both development environments without mixing up the configurations.
59+
60+
In some cases, you may get **container conflict errors** when switching between docker projects; like debugging **docker-compose-mvc** first then start debugging **docker-compose-public** after stopping the first one.
61+
62+
<img src="images/development-docker-mvc/docker-container-conflict.png" alt="docker-cs-configuration" style="zoom:100%;" />
63+
64+
This occurs because the mvc container is still alive even if you stop debugging. To avoid container conflicts, you need to **Clean** the solution (right click to docker project and clean option) to remove the container completely before running the **docker-compose-public** which uses common containers like mvc container.

docs/en/Feature-Dynamic-Entity-Parameters-Custom-Input-Types-Angular.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
2-
31
# Create Custom Input Types
42

53
In this document we will create a custom input type step by step. Our input type is multi-select combobox input type.
@@ -132,4 +130,4 @@ In this document we will create a custom input type step by step. Our input type
132130

133131
All done. Your custom input type is ready to use in dynamic parameter. Create new dynamic parameter which uses that input type, add it to an entity. Then you can go to manage page and use it.
134132

135-
![custom-input-type-multi-select-combobox-mvc](images\custom-input-type-multi-select-combobox-angular.png)
133+
![custom-input-type-multi-select-combobox-mvc](images/custom-input-type-multi-select-combobox-angular.png)

docs/en/Feature-Dynamic-Entity-Parameters-Custom-Input-Types-Mvc.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,3 @@
1-
2-
31
# Create Custom Input Types
42

53
In this document we will create a custom input type step by step. Our input type is multi-select combobox input type.
@@ -35,7 +33,7 @@ In this document we will create a custom input type step by step. Our input type
3533

3634
4. Go to `*.Web.Mvc\wwwroot\view-resources\Areas\AppAreaName\Views\Common\IInputTypes\` folder
3735

38-
5. Create new javascript file named `MultiSelectComboboxInputType.js` and fill required functions.
36+
5. Create new JavaScript file named `MultiSelectComboboxInputType.js` and fill required functions.
3937

4038
```javascript
4139
var MultiSelectComboBoxInputType = (function () {
@@ -84,7 +82,7 @@ In this document we will create a custom input type step by step. Our input type
8482
init: init,
8583
getSelectedValues: getSelectedValues,
8684
getView: getView,
87-
hasValues: true,//is that input type need values to work. For example dropdown need values to select.
85+
hasValues: true, // is that input type need values to work. For example dropdown need values to select.
8886
afterViewInitialized: afterViewInitialized
8987
};
9088
};
@@ -131,6 +129,7 @@ In this document we will create a custom input type step by step. Our input type
131129
<td>The function that manager will trigger after view initialized.</td>
132130
</tr>
133131
</tbody>
132+
</table>
134133

135134
6. Create `MultiSelectComboBoxInputTypeProvider` that create new input type object for each request. Then add that provider to `abp.inputTypeProviders`
136135

@@ -148,4 +147,4 @@ In this document we will create a custom input type step by step. Our input type
148147

149148
All done. Your custom input type is ready to use in dynamic parameter. Create new dynamic parameter which uses that input type, add it to an entity. Then you can go to manage page and use it.
150149

151-
![custom-input-type-multi-select-combobox-mvc](images\custom-input-type-multi-select-combobox-mvc.png)
150+
![custom-input-type-multi-select-combobox-mvc](images/custom-input-type-multi-select-combobox-mvc.png)

docs/en/Features-Angular-Host-Dashboard.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
Host dashboard is used to show some statistics about tenants, editions
44
and income:
55

6-
<img src="images/host-dashboardv5.png" alt="Host dashboard" class="img-thumbnail"/>
6+
<img src="images/host-dashboardV5.png" alt="Host dashboard" class="img-thumbnail"/>
77

88
This is a fully implemented dashboard except two sample statistics (sample statistics 1 & 2) those are placeholders for your own statistics.
99

Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading

docs/en/nav-aspnet-core-mvc.json

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -513,6 +513,10 @@
513513
{
514514
"text": "Converting Create & Edit Modals to MVC Pages",
515515
"path": "Converting-Create-Edit-Modal-To-Page-Mvc-Core.md"
516+
},
517+
{
518+
"text": "Development with Docker Containers",
519+
"path": "Development-Mvc-Core-Docker.md"
516520
}
517521
]
518522
},

0 commit comments

Comments
 (0)