Frontend installation
baguilar edited this page 5 years ago

Botpro's frontend docker-compose installation

This installation process is meant to be run for a production environment as default. Development environment should be set up differently.

Pre-requirements

  • A server running a recent linux distribution. You can get one at digitalocean (https://digitalocean.com)
  • The backend should already be installed and running.
  • docker installed and configured.
  • docker-compose installed and configured.
  • Access to the private registry located at hub.botprotec.com. That can be only requested by an agreement and licensing of use.
  • SMPT server information for notifications. The server needs to have TLS.
  • A valid email account for default email user
  • The version_tag you want to use. The version_tag coincides on the latest commit in Backend and Frontend repository. For example a4f0c2912849e2bd089201b53b7f631969133fd9 for backend and bac4d0b4479e3d9f917cf385fa43f17b2ffc0f9a for frontend.

Installation process

  1. Clone this repository.

    git clone https://gogs.innovare.es/BotPro/docker-install.git
    
  2. Login into private registry hub.botprotec.com

    sudo docker login hub.botprotec.com
    
  3. Start the backend services. The variables used are just meant as example. You need to provide your own. The default values for botpro production environment are located in the following document: https://gogs.innovare.es/BotPro/Frontend/wiki/Production+deployment

    cd docker-install/frontend
    sudo BACKEND_URL="https://example-backend.botprotec.com" \
    VERSION_TAG=bac4d0b4479e3d9f917cf385fa43f17b2ffc0f9a} \
    WEB_PORT_FRONTEND=8081 \
    docker-compose up -d
    

Variables

  • BACKEND_URL: sets the URL where the backend will be consumed.
  • VERSION_TAG: This is the image version to use. It corresponds to the commit value in the backend repository (https://gogs.innovare.es/BotPro/Frontend).
  • WEB_PORT: This is the port to use for exposing the backend HTTP service.

Service description

Description of services running with Backend docker-compose.yml

  1. frontend: image based on nodejs, hub.botprotec.com/botpro/botpro-frontend