Document Properties
Kbid
294Y34
Last Modified
27-Jun-2023
Added to KB
16-Jun-2020
Public Access
Everyone
Status
Online
Doc Type
Support Articles
Product
Intershop Progressive Web App
Support Article - Deployment of a PWA Demo Server in Production Mode

Introduction

Info

This support article is valid from PWA 0.20.0.

This article describes how to deploy an Intershop Progressive Web Application (PWA) for a demo server in production mode.

The production mode uses browser-side rendering with on-demand server-side pre-rendering (Angular Universal).

For more details about this option, see Intershop Progressive Web App - Deployment Scenarios.

References

Deployment Steps

  1. Check the system requirements for the PWA - see Overview - Intershop Progressive Web App System Requirements.
  2. Download the corresponding PWA version from https://github.com/intershop/intershop-pwa/releases.

    Example
    wget https://github.com/intershop/intershop-pwa/archive/0.27.0.zip
  3. Unzip the file.

    Example
    unzip 0.27.0.zip 

    PWA <0.22.0: The directory name must not contain any dots.

  4. Change to the PWA directory.

    Example
    cd intershop-pwa-0.27.0
  5. Adapt the configuration file src/environments/environment.prod.ts. Set the property icmBaseURL to the corresponding ICM 7.10 system.

    import { ENVIRONMENT_DEFAULTS, Environment } from './environment.model';
    
    export const environment: Environment = {
      ...ENVIRONMENT_DEFAULTS,
      production: true,
      serviceWorker: false,
    
      /* INTERSHOP COMMERCE MANAGEMENT REST API CONFIGURATION */
      icmBaseURL: 'https://intershoppwa.azurewebsites.net',
    };

    Enabling service workers is not possible without using nginx. The Intershop PWA will not function as intended if you do.

  6. Build a PWA docker image.

    docker build -t <pwa_image_name> .
  7. Deploy and start the PWA docker container.

    docker run -d -p <port>:4200 --name <container_name> <pwa_image_name>

    To enable SSL the parameter -e SSL=1 must be added to the docker run command and the configuration parameter icmBaseURL must contain HTTPS.

    Example
    docker run -d -p 4200:4200 -e SSL=1 --name pwa pwa_0.27.0

    Helpful docker commands for container maintenance

    • Stop a docker container: docker stop <container_name|id>
    • Start a docker container: docker start <container_name|id>
    • Remove a docker container: docker rm <container_name|id>
    • List all running docker containers: docker container ls
    • List all created docker containers: docker ps -a -s
    • Display the log output of a running docker container: docker logs <container_name|id>
  8. To access the PWA, open a web browser with the IP of the server and the configured port - example:  https://10.0.56.157:4200

Disclaimer
The information provided in the Knowledge Base may not be applicable to all systems and situations. Intershop Communications will not be liable to any party for any direct or indirect damages resulting from the use of the Customer Support section of the Intershop Corporate Web site, including, without limitation, any lost profits, business interruption, loss of programs or other data on your information handling system.
The Intershop Knowledge Portal uses only technically necessary cookies. We do not track visitors or have visitors tracked by 3rd parties. Please find further information on privacy in the Intershop Privacy Policy and Legal Notice.
Home
Knowledge Base
Product Releases
Log on to continue
This Knowledge Base document is reserved for registered customers.
Log on with your Intershop Entra ID to continue.
Write an email to supportadmin@intershop.de if you experience login issues,
or if you want to register as customer.