phraseanet/phraseanet

Phraseanet

Tuesday, July 31, 2018
by romain
Repository
20 Watchers
104 Stars
409 Installations

PHP
0 Dependents
0 Suggesters
56 Forks
21 Open issues
46 Versions
0 % Grown

The README.md

Phraseanet 4.1 - Digital Asset Management application

, _(*1)

Main Features :

Several GUI : Prod, Admin, Thesaurus, Lightbox, Report,
Metadata Management (includes Thesaurus and DublinCore Mapping)
RESTful APIS
Elasticsearch search engine
Multiple resolution assets generation
Advanced Rights Management
Duplicates management
SSO
Thesaurus
Publications
Collaborative editing and approval process
Video tools
Rich ecosystem: Plugins for Wordpress, Drupal and Adobe Creative Suite., _(*2)

and much more, _(*3)

Phraseanet Prod , _(*4)

License :

Phraseanet is licensed under GPL-v3 license., _(*5)

Documentation :

https://docs.phraseanet.com/, _(*6)

For development with Phraseanet API, see https://docs.phraseanet.com/4.1/en/Devel/index.html, _(*7)

Installation and Quick Launch:

You can download a packaged version here:, _(*8)

https://www.phraseanet.com/en/download/, _(*9)

You can also git clone this repository for dev and/or test., _(*10)

In each case, Phraseanet includes Dockerfile for building images and Docker compose deployment., _(*11)

See below for more information about Prerequisites and how to personalize the stack deployed., _(*12)

But in fact, if you have Docker Prerequisites, Phraseanet can be deployed and installed with these 2 simple commands., _(*13)

In a terminal from the Phraseanet repository launch, _(*14)

docker compose build
docker compose up -d

After installation process, the default parameters allow you to reach the app on : http://localhost:8082 Default see Phraseanet credentials defined in .env file., _(*15)

PHRASEANET_ADMIN_ACCOUNT_EMAIL

PHRASEANET_ADMIN_ACCOUNT_PASSWORD

Note : This install will be made with default password for all services. Except for a test, This is VERY important to customize .env file and define your own password., _(*16)

For installation on your own mono-tenant or multi-tenant infrastructure (mysql, elasticsearch, redis, etc) stack, follow the install steps described at, _(*17)

https://docs.phraseanet.com/4.1/en/Admin/Install.html, _(*18)

We do not recommend using this method anymore., _(*19)

Need help implementing Phraseanet?

Ask the community: https://groups.google.com/g/phrasea-install-en, _(*20)

Get official support : https://www.alchemy.fr/en/rubrique/services/, _(*21)

Phraseanet with Docker:

Prerequisites

docker >=27.3.1
docker compose >= 2.30.3

In the stack Docker, Docker Compose included in this repo starts by default in test mode. All services are launched in a separate container and except "Phraseanet app" and "workers" containers, it can be replaced by an external service. This is especially recommended to use your SGBD (Mariadb or MySql) service for a production use. The SGBD is one of primary Datastore, running the container included in this stack in "Production" required some tuning regarding the volumes of your datas., _(*22)

Filer service is provided by the hosts., _(*23)

All port numbers are the default service given by the vendor and can be changed with ENV Variables except for the NFS., _(*24)

For dev and testing, the stack include also some Tools containers and can be launched by compositing the stack., _(*25)

eg :, _(*26)

Builder, _(*27)
Mailhog, _(*28)
Pma etc..., _(*29)

Refer to .env file and docker compose files or on documentation for stack compositing., _(*30)

https://docs.phraseanet.com/4.1/en/Admin/EnvironnementVariables.html, _(*31)

Phraseanet architectur , _(*32)

Note about elasticsearch container, check this link, _(*33)

https://www.elastic.co/guide/en/elasticsearch/reference/current/docker.html#docker-prod-prerequisites, _(*34)

What is docker? Read this:

https://www.docker.com/get-started, _(*35)

Host requirement:

Linux : https://hub.docker.com/search?q=&type=edition&offering=community&operating_system=linux, _(*36)

Macintosh : https://hub.docker.com/editions/community/docker-ce-desktop-mac, _(*37)

Windows : https://hub.docker.com/editions/community/docker-ce-desktop-windows, _(*38)

Note: All our images are Linux based, so with Macintosh and Windows hosts, the containers run in vm provided by Docker. For optimal performances, prefer a Linux host., _(*39)

Stack description and customization

We provide a Dockerfile for build images and several docker-compose... for deployment., _(*40)

Use COMPOSE_FILE and COMPOSE_PROFILES env variables for composing this deployment., _(*41)

By default COMPOSE_FILE and COMPOSE_PROFILES is set for deploying a test stack including containers., _(*42)

phraseanet_db_1                 
phraseanet_elasticsearch_1                                                              
phraseanet_gateway_1                                                            
phraseanet_mailhog_1                                  
phraseanet_phraseanet_1                                                                       
phraseanet_rabbitmq_1
phraseanet_redis_1                                                                                    
phraseanet_worker_1

At first launch of the stack, the Setup container plays install. It will restart until it can do this installation: waiting for readiness of all other containers. At each container starting , setup container reaplying also some PHRASEANET_* environement variable into Phraseanet configuration.yml file., _(*43)

default configuration is, _(*44)

COMPOSE_FILE=docker-compose.yml:docker-compose.datastores.yml:docker-compose.tools.yml
COMPOSE_PROFILES=app,gateway-classic,db,pma,elasticsearch,redis,redis-session,rabbitmq,workers,mailhog,setup

You should review the default env variables defined in .env file. Use export method to override these values, _(*45)

i.e:, _(*46)

export PHRASEANET_DOCKER_TAG=latest
export INSTALL_ACCOUNT_EMAIL=foo@bar.com
export INSTALL_ACCOUNT_PASSWORD=$3cr3t!
export PHRASEANET_APP_PORT=8082

If you want persit this change you can also save your change in a files named env.local or .env.local, _(*47)

These files are git ignored and permit stack customization without git conflict., _(*48)

If you are not interested in the development of Phraseanet, you can ignore everything in .env after the DEV Purpose part., _(*49)

stack Management

This script wrapping standard oprations for the stack, using standard docker compose cmd and take in account .env and env.local | .env.local files., _(*51)

This script is useful if you are using the database container within the stack., _(*52)

Using a env.local method for custom .env values

It may be easier to deal with a local file to manage our env variables., _(*54)

You can add your env.local at the root of this project and define a command function in your ~/.bashrc or ~/.zshrc:, _(*55)

#######################################
# Docker compose helper:
#   Locate first defined environment
#   file and inject variables found in
#   docker compose command.
# Arguments:
#   command (string)
# Usage example:
#   dc up -d
#######################################

function dc() {
  for envFile in {".env.local","env.local"}; do
    if [ -f ${envFile} ]; then
      docker compose --env-file=.env --env-file=${envFile} $@
      return
    fi
  done

  docker compose $@
}

Note that helper function only works with "docker compose" ., _(*56)

Phraseanet Docker Images

You have two choices, _(*57)

Use the prebuild image from dockerhub, see DockerHub section bellow for more information.

set env var
PHRASEANET_DOCKER_REGISTRY, _(*58)

i.e:, _(*59)

# Registry from where you pull Docker images
PHRASEANET_DOCKER_REGISTRY=alchemyfr

and launch, _(*60)

docker compose pull, _(*61)

Pulling images from Docker Hub takes ~ 3 minutes, depending on your bandwith, _(*62)

Build local images

launch, _(*63)

docker compose build, _(*64)

The first build takes ~ 30 minutes on host without any Docker building cache, depending on your bandwith and the host capacity., _(*65)

Running the application

docker compose up -d

The default parameters allow you to reach the app with : http://localhost:8082, _(*66)

Phraseanet images from Docker Hub

Retrieve on Docker Hub prebuilt images for Phraseanet., _(*67)

https://hub.docker.com/r/alchemyfr/phraseanet-fpm

https://hub.docker.com/r/alchemyfr/phraseanet-worker

https://hub.docker.com/r/alchemyfr/phraseanet-nginx

https://hub.docker.com/repository/docker/alchemyfr/phraseanet-db

https://hub.docker.com/repository/docker/alchemyfr/phraseanet-elasticsearch

Tag organization on Docker Hub

latest : latest stable version, _(*68)

4.1.2 : Phraseanet version 4.1.2, _(*69)

4.1.1 : Phraseanet version 4.1.1, _(*70)

Etc, _(*71)

nightly : Development version, the latest version with successful automated tests. Built and published every night, _(*72)

Development mode

The development mode uses the docker-compose-override.yml file, so you need to set COMPOSE_FILE and COMPOSE_PROFILE env, _(*73)

COMPOSE_FILE=docker-compose.yml:docker-compose.datastores.yml:docker-compose.tools.yml:docker-compose.override.yml
COMPOSE_PROFILES=app,gateway-classic,db,pma,elasticsearch,redis,rabbitmq,workers,mailhog,builder

You can run it with:, _(*74)

docker compose up -d

The environment is not ready yet: you have to fetch all dependencies., _(*75)

This can be made easily from the builder container:, _(*76)

docker compose run --rm -u app builder make install install_composer_dev

Please note that the phraseanet image does not contain nor composer neither node tools. This allows the final image to be light. If you need to use dev tools, ensure you are running the builder image!, _(*77)

Developer shell

You can also obtain a shell access in builder container:, _(*78)

docker compose run --rm builder /bin/bash
# or
docker compose run --rm builder /bin/zsh

In this container you will have the same libraries (PHP, Node, composer, ...) that are used to build images. Also you have utils for development like telnet, ping, ssh, git, ... Your $HOME/.ssh directory is also mounted to builder's home with your ssh agent., _(*79)

Using Xdebug

Xdebug is enabled by default with the docker-compose.override.yml You can disable it by setting:, _(*80)

export XDEBUG_ENABLED=0

Remote host is fixed because of the subnet network from compose., _(*81)

You need to configure file mapping in your IDE. For PhpStorm, you can follow this example:, _(*82)

PhpStorm mapping , _(*83)

Configure the Absolute path on the server to /var/alchemy/Phraseanet at the project root path (i.e. ~/projects/Phraseanet)., _(*84)

Xdebug on MacOS

You have to set the following env:, _(*85)

XDEBUG_REMOTE_HOST=host.docker.internal

Don't forget to recreate your container (docker compose up -d phraseanet), _(*86)

Build images with plugins

Plugins can be installed during build if you set the PHRASEANET_PLUGINS env var as follows:, _(*87)

PHRASEANET_PLUGINS="https://github.com/alchemy-fr/Phraseanet-plugin-expose.git"

# You can optionally precise the branch to install
# If not precised, the main branch will be pulled
PHRASEANET_PLUGINS="git@github.com:alchemy-fr/Phraseanet-plugin-webgallery.git(custom-branch)"

# Plugins are separated by semicolons
PHRASEANET_PLUGINS="git@github.com:foo/bar.git(branch-1);git@github.com:baz/42.git"

Prefer the HTTPS URL for public repositories, you will not be required to provide your SSH key., _(*88)

If you install private plugins, make sure you export your SSH private key content in order to allow docker build to access the GIT repository: Also ensure you're using the SSH URL form (i.e: git@github.com:alchemy-fr/repo.git)., _(*89)

export PHRASEANET_SSH_PRIVATE_KEY=$(cat ~/.ssh/id_rsa)
# or if your private key is protected by a passphrase:
export PHRASEANET_SSH_PRIVATE_KEY=$(openssl rsa -in ~/.ssh/id_rsa -out /tmp/id_rsa_raw && cat /tmp/id_rsa_raw && rm /tmp/id_rsa_raw)

Running workers

docker compose -f docker-compose.yml run --rm worker <command>

Where <command> can be:, _(*90)

bin/console worker:execute -m 2 (default)
bin/console task-manager:scheduler:run
...

Try Phraseanet with Pre installed VM (deprecated)

You can also download a testing pre installed Virtual Machine in OVA format here :, _(*91)

https://www.phraseanet.com/download/, _(*92)

The Versions

31/07 2018

4.0.x-dev

4.0.9999999.9999999-dev

Phraseanet

library phraseanet

Phraseanet

phraseanet/phraseanet

The README.md

Phraseanet 4.1 - Digital Asset Management application

Main Features :

License :

Documentation :

Installation and Quick Launch:

Need help implementing Phraseanet?

Phraseanet with Docker:

Prerequisites

What is docker? Read this:

Host requirement:

Stack description and customization

stack Management

Using a env.local method for custom .env values

Phraseanet Docker Images

Use the prebuild image from dockerhub, see DockerHub section bellow for more information.

Build local images

Running the application

Phraseanet images from Docker Hub

Tag organization on Docker Hub

Development mode

Developer shell

Using Xdebug

Xdebug on MacOS

Build images with plugins

Running workers

Try Phraseanet with Pre installed VM (deprecated)

The Versions

4.0.x-dev

The Requires

The Development Requires

dev-master

The Requires

The Development Requires

dev-4.0.3-beta

The Requires

The Development Requires

3.8.x-dev

The Requires

The Development Requires

dev-PHRAS-2010_circle-crash_master

The Requires

The Development Requires

dev-revert-2457-PHRAS-1847_backbone_error

The Requires

The Development Requires

dev-fix-composer-dependencies

The Requires

The Development Requires

dev-fix-provisionning-master

The Requires

The Development Requires

4.0.2

The Requires

The Development Requires

dev-update-composer

The Requires

The Development Requires

4.0.1

The Requires

The Development Requires

4.0.0

The Requires

The Development Requires

dev-revert-2259-PHRAS-1319_dump_locale

The Requires

The Development Requires

dev-feature/update-subdef-form-with-pressets

The Requires

The Development Requires

dev-AutoCompletion-4.0

The Requires

The Development Requires

dev-feature/improve-setup-app

The Requires

The Development Requires

dev-feature/improved-es-setup