install docker

choose community edition CE https://docs.docker.com/engine/installation/

example install docker ubuntu https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/

Post-installation steps for Linux https://docs.docker.com/engine/installation/linux/linux-postinstall/

install docker-compose

https://docs.docker.com/compose/install/

WIP

auto install ubuntu

• options stop container

  docker stop $(docker ps -a -q)

• options delete container

  docker rm $(docker ps -a -q)

• options delete images

  docker rmi -f $(docker images -q)

• docker prune

  docker system prune

• auto install : docker , docker-compose and communecter

  wget -O - https://gist.githubusercontent.com/aboire/4c83ff97026b1a4fabaada09950b2fc8/raw/install.sh| bash

• updating the user's permissions to edit files

  cd ~/pixelhumain-docker
  sudo chown -R ${USER:=$(/usr/bin/id -run)}:$USER code/
  sudo chown -R ${USER:=$(/usr/bin/id -run)}:$USER code/pixelhumain/
  sudo chown -R ${USER:=$(/usr/bin/id -run)}:$USER code/modules/
  sudo chown -R ${USER:=$(/usr/bin/id -run)}:$USER code/log/

  Initial setup

• 0 Clone this repository

  git clone https://gitlab.adullact.net/pixelhumain/docker pixelhumain-docker

• 1 Put your source file in the code directory:

  • see https://gitlab.adullact.net/pixelhumain/pixelhumain/blob/master/README.md
  • use the docker image provided below
  • Your VCS / IDE / ...

• 2 Start the containers using:

  docker-compose -f docker-compose.yml up

• 3 Access to the test service through http://127.0.0.1:5080/

• 4 Access to communecter through http://127.0.0.1:5080/

• 5 You can modify your sources code with your prefered editor in the code directory

Layout overview

|-- code
    |-- modules
        |-- co2
        |-- communecter
        |-- citizenToolKit
        |-- api
        |-- network
        |-- [...]
    |-- pixelhumain
        |-- ph
        |-- [...]
|-- docker-install
    |-- install-conf
    |-- [...]
|-- docker-front
[...]

Basic setup and data with the docker image

For an initial setup you'll need to init MongoDB, configurations, etc (see communecter install guide for more details) An easy to use image with an install script is provided through the docker imager « ph » and can be used with this command

docker-compose -f docker-compose.yml -f docker-compose.install.yml run ph cotools --install

The install script fetch every modules in the pixelhumain guide, create directories and populate some data like cities, ...

Updating Dockers images

Useful commands:

Warning windows/mac : use -no-build.yml file (images build > docker hub)

Start services

docker-compose -f docker-compose.yml up

Shutdown gracefuly services

docker-compose -f docker-compose.yml down

Re-build images after modifications of docker files

docker-compose -f docker-compose.yml build
#docker-compose -f docker-compose.yml -f docker-compose.install.yml build ph

Install base sources codes and populates some data

docker-compose -f docker-compose.yml -f docker-compose.install.yml run ph cotools --install

Update base sources codes

docker-compose -f docker-compose.yml -f docker-compose.install.yml run ph cotools --update

Update data

docker-compose -f docker-compose.yml -f docker-compose.install.yml run ph cotools --update-data

Validate your user after registration without sending email

docker-compose -f docker-compose.yml -f docker-compose.install.yml run ph cotools --emailvalid=email@example.com 

See log from nginx

/code/log