Contents

• GUILLOTINA_CMS
  • Prepare Docker env
  • Quick Start
  • Start Docker Background
  • Build dev image (a.k.a. ./bin/buildout)
  • Run dev (a.k.a. ./bin/instance fg)
  • Add CMS container
  • Using Executioner (optional)
  • Running Volto
  • Cleanup DB
  • Optional addons
  • With Extras

GUILLOTINA_CMS

WIP: This package is a work in progress to provide CMS on guillotina

Bundle of cms functionality for guillotina

Prepare Docker env

MacOS:

screen ~/Library/Containers/com.docker.docker/Data/vms/0/tty
sysctl -w vm.max_map_count=262144
(to exit Ctrl + a + d)

Quick Start

There's in place a convenience Makefile that setups all the basic enviroment required for Guillotina CMS to work:

make

It will install the default venv, pull and launch the docker containers, and setup the default objects in the DB for the CMS to work. If you do this, you can pass on the next steps. Follow the next steps in case you want to have more control over how the environment is set up.

You can always run:

make initdb

to delete the DB. You can run:

make deletedb

to reset and remove the default container.

Start Docker Background

Start it (with postgres)

docker-compose create
docker-compose -f docker-compose.yaml up postgres redis

Build dev image (a.k.a. ./bin/buildout)

To install with docker:

docker-compose build guillotina

To install with virtualenv (python 3.7)

virtualenv .
source bin/activate
pip install -r requirements.txt
pip install -e .[test]

Run dev (a.k.a. ./bin/instance fg)

Run docker dev container (with cockroach)

docker-compose run --service-ports guillotina

Run docker dev container (with postgres)

docker-compose -f docker-compose.yaml run --service-ports guillotina

Run on virtualenv (with postgres)

g -c config.yaml

Add CMS container

Add CMS containers:

curl -X POST --user root:root http://localhost:8081/db -d '{"@type": "Container", "id": "web", "title": "Plone Site"}'
curl -X POST --user root:root http://localhost:8081/db/web/@addons -d '{"id": "cms"}'

Using Executioner (optional)

If you want to access and browse the guillotina tree you can use the Angular Front:

http://localhost:8081/+admin

Running Volto

First, install Volo: https://github.com/plone/volto

Then edit "src/config/index.js" to change the default Plone backend parameter RAZZLE_API_PATH:

apiPath: process.env.RAZZLE_API_PATH || 'http://localhost:8081/db/web

then start the server in development mode:

$ yarn start

or alternativelly, setup the environment variable to modify it:

$ RAZZLE_API_PATH=http://localhost:8081/db/web yarn start

Then go to http://localhost:3000 to see the Volto frontend running on Guillotina!

You can log into Volto with username "root" and password "root".

If you are interested in start a Volto project instead of developing Volto, you can follow the instructions in:

https://docs.voltocms.com/01-getting-started/01-install/#install-volto

Cleanup DB

Cleanup postgres env:

docker-compose -f docker-compose.yaml rm -s -v postgres

Optional addons

• guillotina_linkintegrity

(with link integrity you'll also need redis)

With Extras

Install guillotina_cms with pip install guillotina_cms[extras]

Which enabled elasticsearch full text search, pubsub and link integrity support.

Run docker with elasticsearch and redis:

docker-compose -f docker-compose.yaml rm -s -v redis postgres elasticsearch

Uncomment guillotina_elasticsearch from applications list in config.yaml:

- guillotina_elasticsearch
- guillotina_linkintegrity