An open API service indexing awesome lists of open source software.

https://github.com/plone/ploneconf.org

Site for the 2022 Plone Conference
https://github.com/plone/ploneconf.org

plone volto volto-addon

Last synced: about 2 months ago
JSON representation

Site for the 2022 Plone Conference

Awesome Lists containing this project

README

          

# 2022.ploneconf.org

## Quick start

### Requirements

- Python 3.9
- Node 16 / yarn
- Docker

### Install

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

### Start

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

```shell
make start-backend
```

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

```shell
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`