eShopOnAbp/etc

Pre-requirements

• Docker Desktop with Kubernetes enabled

• Install NGINX ingress for k8s

  OR

  Install NGINX ingress using helm

helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update

helm upgrade --install --version=4.0.19 ingress-nginx ingress-nginx/ingress-nginx

• Install Helm for running helm charts

How to run?

• Add entries to the hosts file (in Windows: C:\Windows\System32\drivers\etc\hosts, in linux and macos: /etc/hosts ):

127.0.0.1 eshop-st-web
127.0.0.1 eshop-st-public-web
127.0.0.1 eshop-st-authserver
127.0.0.1 eshop-st-identity
127.0.0.1 eshop-st-administration
127.0.0.1 eshop-st-basket
127.0.0.1 eshop-st-catalog
127.0.0.1 eshop-st-ordering
127.0.0.1 eshop-st-cmskit
127.0.0.1 eshop-st-payment
127.0.0.1 eshop-st-gateway-web
127.0.0.1 eshop-st-gateway-web-public

Once Helm is set up properly, add the repo as follows:

helm repo add eshoponabp https://abpframework.github.io/abp-charts/

You can then run helm search repo eshoponabp to see the charts.

 helm install eshop-st eshoponabp/eshoponabp

OR

• Run build-images.ps1 or build-images.sh in the build directory.
• Run deploy-staging.ps1 or deploy-staging.sh in the helm-chart directory. It is deployed with the eshop namespace.
• You may wait ~30 seconds on first run for preparing the database.
• Browse https://eshop-st-public-web for public and https://eshop-st-web for web application
• Username: admin, password: 1q2w3E*.

Running on HTTPS

You can also run the staging solution on your local kubernetes kluster with https. There are various ways to create self-signed certificate.

Installing mkcert

This guide will use mkcert to create self-signed certificates.

Follow the installation guide to install mkcert.

Creating mkcert Root CA

Use the command to create root (local) certificate authority for your certificates:

mkcert -install

Note: all the certificates created by mkcert certificate creation will be trusted by local machine

Run mkcert

Create certificate for the eshopOnAbp domains using the mkcert command below:

mkcert "eshop-st-web" "eshop-st-public-web" "eshop-st-authserver" "eshop-st-identity" "eshop-st-administration" "eshop-st-basket" "eshop-st-catalog" "eshop-st-ordering" "eshop-st-cmskit" "eshop-st-payment" "eshop-st-gateway-web" "eshop-st-gateway-web-public"

At the end of the output you will see something like

The certificate is at "./eshop-st-web+10.pem" and the key at "./eshop-st-web+10-key.pem"

Copy the cert name and key name below to create tls secret

kubectl create namespace eshop
kubectl create secret tls -n eshop eshop-wildcard-tls --cert=./eshop-st-web+10.pem  --key=./eshop-st-web+10-key.pem