inteligr8/alfresco-sdk
1
0
Fork 0
mirror of https://github.com/Alfresco/alfresco-sdk.git synced 2025-05-12 17:05:08 +00:00
Code Issues Packages Projects Releases Wiki Activity
alfresco-sdk/docs/projects-usage.md
Jose Luis Osorno 0f500fab25 Documentation - Projects usage
2019-01-10 15:58:24 +01:00

2.7 KiB
Raw Blame History

Working with generated projects

After generating your project, using one of the Alfresco SDK 4.0 Maven archetypes, it is important to know how to build/run/test these projects.

The Alfresco Platform 6 deployment architecture is highly based on container technologies, specifically in Docker. Due to that, the projects generated using the Alfresco SDK 4.0 archetypes set up their local environment making an intensive use of Docker and Docker compose technologies.

If you're not familiar to these technologies, it is highly recommended visiting the Docker documentation website. This site offers a great quantity of training resources about Docker and Docker compose.

Run script

All the projects generated using the Alfresco SDK 4.0 archetypes provide an utility script to work with the project. This script is run.sh for Unix systems and run.bat for Windows systems.

The execution of this script must be followed by a parameter that dictates the task to be executed in the project. The list of available tasks is:

Task Description
build_start Build the whole project, recreate the ACS and Share docker images, start the dockerised environment composed by ACS, Share, ASS and PostgreSQL and tail the logs of all the containers.
start Start the dockerised environment without building the project and tail the logs of all the containers.
stop Stop the dockerised environment.
purge Stop the dockerised container and delete all the persistent data (docker volumes).
tail Tail the logs of all the containers.
reload_share Build the Share module, recreate the Share docker image and restart the Share container (not available in the Alfresco Platform JAR archetype).
reload_acs Build the ACS module, recreate the ACS docker image and restart the ACS container (only available in the All-In-One archetype).
build_test Build the whole project, recreate the ACS and Share docker images, start the dockerised environment, execute the integration tests from the integration-tests module and stop the environment.
test Execute the integration tests (the environment must be already started).

This utility script uses mvn, docker and docker-compose commands, so make sure you have properly installed Maven, Docker and Docker compose and you have configured them properly to be accessible in the path.

In the case of Maven, it is not necessary that the mvn executable is in the path if you've properly configured the environment variable M2_HOME. The script looks for the M2_HOME environment variable to build the path to the mvn executable.