Browse Source

Merge pull request #20926 from abpframework/issue-.20924

Fix Document Error  issue-20924
pull/20927/head
SALİH ÖZKARA 2 years ago
committed by GitHub
parent
commit
b7d4a7c08d
No known key found for this signature in database GPG Key ID: B5690EEEBB952194
  1. 32
      docs/en/guides/ms-multi-tenant-domain-resolving.md

32
docs/en/guides/ms-multi-tenant-domain-resolving.md

@ -270,6 +270,7 @@ Your request from the browser to the subdomain will be accepted by the ingress-c
Update your charts ingress.yaml files. Ex for **administration-ingress.yaml**: Update your charts ingress.yaml files. Ex for **administration-ingress.yaml**:
{%{
```yaml ```yaml
spec: spec:
tls: tls:
@ -303,6 +304,7 @@ spec:
port: port:
number: 80 number: 80
``` ```
}%}
**Update all the application, gateway and microservice ingress.yaml files.** Eventually, when deploy the application, you will be seeing: **Update all the application, gateway and microservice ingress.yaml files.** Eventually, when deploy the application, you will be seeing:
![updated-ingress](../images/updated-ingress.png) ![updated-ingress](../images/updated-ingress.png)
@ -311,6 +313,7 @@ spec:
Navigate to applications, gateways and microservices' **x-deployment.yaml** file and override the newly introduced `TenantDomain` key: Navigate to applications, gateways and microservices' **x-deployment.yaml** file and override the newly introduced `TenantDomain` key:
{%{
```yaml ```yaml
... Removed for brevity ... Removed for brevity
- name: "TenantDomain" # Add this key - name: "TenantDomain" # Add this key
@ -319,11 +322,13 @@ Navigate to applications, gateways and microservices' **x-deployment.yaml** file
value: "{{ .Values.config.authServer.authority }}" value: "{{ .Values.config.authServer.authority }}"
... ...
``` ```
}%}
> **Update all the application, gateway and microservice deployment.yaml files.** > **Update all the application, gateway and microservice deployment.yaml files.**
**For AuthServer, also add the WildCardDomains that is used to handle subdomain *redirect* and *post_logout redirect* URIs to the authserver-deployment.yaml file:** **For AuthServer, also add the WildCardDomains that is used to handle subdomain *redirect* and *post_logout redirect* URIs to the authserver-deployment.yaml file:**
{%{
```yaml ```yaml
... Removed for brevity ... Removed for brevity
- name: "TenantDomain" - name: "TenantDomain"
@ -348,6 +353,7 @@ Navigate to applications, gateways and microservices' **x-deployment.yaml** file
value: "{{ .Values.wildCardDomains.productService }}" value: "{{ .Values.wildCardDomains.productService }}"
... ...
``` ```
}%}
Afterwards, update the **values.yaml** file for all the sub-charts (administration, authserver etc): Afterwards, update the **values.yaml** file for all the sub-charts (administration, authserver etc):
@ -383,7 +389,7 @@ wildCardDomains:
After updating the **deployment.yaml** and **values.yaml** files of all the application, gateway and microservices' navigate to the **mystore chart values.yaml** file located under the k8s/Mystore/values.yaml that overrides all the sub-charts: After updating the **deployment.yaml** and **values.yaml** files of all the application, gateway and microservices' navigate to the **mystore chart values.yaml** file located under the k8s/Mystore/values.yaml that overrides all the sub-charts:
**AuthServer:** **AuthServer:**
{%{
```yaml ```yaml
# auth-server sub-chart override # auth-server sub-chart override
authserver: authserver:
@ -402,11 +408,13 @@ authserver:
saasService: "https://{0}.saas.mystore.dev" saasService: "https://{0}.saas.mystore.dev"
productService: "https://{0}.product.mystore.dev" productService: "https://{0}.product.mystore.dev"
``` ```
}%}
You may also get CORS error when authenticating SwaggerUI of your gateways or microservices. Add Override the AuthServer CORS values with the subdomain to solve this problem: You may also get CORS error when authenticating SwaggerUI of your gateways or microservices. Add Override the AuthServer CORS values with the subdomain to solve this problem:
**identityService:** **identityService:**
{%{
```yaml ```yaml
# identity-service sub-chart override # identity-service sub-chart override
identity: identity:
@ -416,9 +424,10 @@ identity:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.identity.mystore.dev" tenantDomain: "https://{0}.identity.mystore.dev"
``` ```
}%}
**administrationService:** **administrationService:**
{%{
```yaml ```yaml
# administration-service sub-chart override # administration-service sub-chart override
administration: administration:
@ -428,9 +437,11 @@ administration:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.administration.mystore.dev" tenantDomain: "https://{0}.administration.mystore.dev"
``` ```
}%}
**saasService:** **saasService:**
{%{
```yaml ```yaml
# saas-service sub-chart override # saas-service sub-chart override
saas: saas:
@ -440,9 +451,9 @@ saas:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.saas.mystore.dev" tenantDomain: "https://{0}.saas.mystore.dev"
``` ```
}%}
**productService:** **productService:**
{%{
```yaml ```yaml
# product-service sub-chart override # product-service sub-chart override
product: product:
@ -452,9 +463,10 @@ product:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.product.mystore.dev" tenantDomain: "https://{0}.product.mystore.dev"
``` ```
}%}
**gateway-web:** **gateway-web:**
{%{
```yaml ```yaml
# saas-service sub-chart override # saas-service sub-chart override
gateway-web: gateway-web:
@ -464,9 +476,10 @@ gateway-web:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.gateway-web.mystore.dev" tenantDomain: "https://{0}.gateway-web.mystore.dev"
``` ```
}%}
**gateway-web-public:** **gateway-web-public:**
{%{
```yaml ```yaml
# gateway-web-public sub-chart override # gateway-web-public sub-chart override
gateway-web-public: gateway-web-public:
@ -476,9 +489,10 @@ gateway-web-public:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.gateway-public.mystore.dev" tenantDomain: "https://{0}.gateway-public.mystore.dev"
``` ```
}%}
**publicweb:** **publicweb:**
{%{
```yaml ```yaml
# Public Web application sub-chart override # Public Web application sub-chart override
publicweb: publicweb:
@ -489,9 +503,10 @@ publicweb:
... Removed for brevity ... Removed for brevity
tenantDomain: "https://{0}.mystore.dev" tenantDomain: "https://{0}.mystore.dev"
``` ```
}%}
**angular:** **angular:**
{%{
```yaml ```yaml
# Angular back-office application sub-chart override # Angular back-office application sub-chart override
angular: angular:
@ -505,6 +520,7 @@ angular:
strictDiscoveryDocumentValidation: false strictDiscoveryDocumentValidation: false
skipIssuerCheck: true skipIssuerCheck: true
``` ```
}%}
> If you are using Web or BlazorServer application for back-office, it is similar configuration with the public-web application > If you are using Web or BlazorServer application for back-office, it is similar configuration with the public-web application

Loading…
Cancel
Save