Skip to content

Latest commit

 

History

History
57 lines (39 loc) · 1.28 KB

README.md

File metadata and controls

57 lines (39 loc) · 1.28 KB

2022.ploneconf.org

Quick start

Requirements

  • Python 3.9
  • Node 16 / yarn
  • Docker

Install

git clone git@github.com:plone/ploneconf.org.git
cd ploneconf.org
make install
make create-site

Start

Start the Backend (http://localhost:8080/)

make start-backend

Start the Frontend (http://localhost:3000/)

make start-frontend

Structure

This monorepo is composed by two distinct codebases: api and frontend.

  • backend: API (Backend) Plone installation using pip (not buildout). Includes a policy package named ploneconf.core
  • frontend: React (Volto) package named ploneconf

Reasoning

  • Repo contains all codebase needed to run the 2022.ploneconf.org (excluding existing addons for Plone and React).
  • Github Workflows are triggered based on changes on each codebase (see .github/workflows)
  • Easier to create Docker images for each codebase
  • Showcase Plone installation/setup without buildout

Notes

If the site does not start correctly, it may be because of a race condition. As a temporary workaround, stop the back ends then start them up one at a time.

Useful commands:

  • docker stack ps plone
  • docker service scale plone_backend=0
  • docker service scale plone_backend=1
  • docker service scale plone_backend=2