mirror of
https://github.com/Alfresco/acs-community-packaging.git
synced 2026-09-16 18:13:21 +00:00
104 lines
4.6 KiB
Markdown
104 lines
4.6 KiB
Markdown
# Development Tomcat Environment
|
|
|
|
|
|
It is possible to use Docker containers to test your code, but it is normally more convenient to simply run the
|
|
repository webapp (`alfresco.war`) in a tomcat instance.
|
|
|
|
## Build -repo projects
|
|
Build the `alfresco-community-repo` (if you have not done so already), so that your changes are in the enterprise alfresco.war file.
|
|
~~~
|
|
cd alfresco-community-repo
|
|
mvn clean install -PcommunityDocker -DskipTests=true -Dversion.edition=Community
|
|
cd ..
|
|
|
|
cd alfresco-enterprise-repo
|
|
mvn clean install -PenterpriseDocker -DskipTests=true -Dmaven.javadoc.skip=true
|
|
cd ..
|
|
~~~
|
|
|
|
## Docker test environment
|
|
The repository code will need to talk to other ACS components, such as a databases, message queue and transformers.
|
|
The simplest way to create these, is to use the `docker-compose.yml` file in the `dev` directory.
|
|
~~~
|
|
cd acs-community-packaging
|
|
docker-compose -f dev/docker-compose.yml up -d
|
|
~~~
|
|
|
|
## Alfresco Global Properties and Log4j
|
|
Set any alfresco-global.properties or log4j properties you may need in the following files. They will be copied
|
|
to the `dev/dev-acs-amps-overlay/target` directory. Other customisations may also be placed in the `extension` directory.
|
|
~~~
|
|
dev/dev-tomcat/src/main/tomcat/shared/classes/alfresco/extension/custom-log4j.properties
|
|
dev/dev-tomcat/src/main/tomcat/shared/classes/alfresco-global.properties
|
|
~~~
|
|
|
|
## Tomcat
|
|
Create the development tomcat environment, apply AMPs on top of the repository code, and
|
|
run tomcat. The `run` profile is what starts tomcat. The `withShare` applies
|
|
the Share services AMP and adds the `share.war` to tomcat.
|
|
Once started, you will be able to access Share on `http://localhost:8080/share` and various repository
|
|
endpoints via `http://localhost:8080/alfresco/`. `entT` is an alias for the
|
|
following command and `entTDebug` will allow a debugger to be attached.
|
|
~~~
|
|
$ # The alias entT is the same as the following mvn command. entTDebug may also be used.
|
|
$ mvn clean install -Prun,withShare
|
|
[INFO] ------------------------------------------------------------------------
|
|
[INFO] Reactor Build Order:
|
|
[INFO]
|
|
[INFO] Alfresco Content Services Community Packaging [pom]
|
|
[INFO] Alfresco Content Services Community Distribution zip [jar]
|
|
[INFO] Alfresco Content Services Public API Javadoc [pom]
|
|
[INFO] ACS Community Docker Image Builder for Alfresco Community [pom]
|
|
[INFO] Scanning for projects...
|
|
[INFO] --------------------------------[ pom ]---------------------------------
|
|
...
|
|
INFO: Starting ProtocolHandler ["http-bio-8080"]
|
|
~~~
|
|
|
|
If you kill the tomcat instance (^C) and wish to restart it, use the following command
|
|
or the `entO` alias, or `entODebug` to attach a debuger.
|
|
~~~
|
|
$ mvn install -Prun,withShare -rf dev-acs-amps-overlay
|
|
~~~
|
|
|
|
|
|
## Clean up
|
|
When finished, kill the tomcat instance and stop the Docker instances. You will normally also
|
|
remove the Docker containers, as you will need a clean database if you are going to issue
|
|
another `mvn clean install` command.
|
|
~~~
|
|
$ ^C
|
|
... Stopped 'sysAdmin' subsystem, ID: [sysAdmin, default]
|
|
|
|
$ docker-compose -f dev/docker-compose.yml stop
|
|
Stopping dev_transform-core-aio_1 ... done
|
|
Stopping dev_transform-router_1 ... done
|
|
Stopping dev_solr6_1 ... done
|
|
Stopping dev_postgres_1 ... done
|
|
Stopping dev_activemq_1 ... done
|
|
Stopping dev_shared-file-store_1 ... done
|
|
|
|
$ docker-compose -f dev/docker-compose.yml rm
|
|
Going to remove dev_transform-core-aio_1, dev_transform-router_1, dev_solr6_1, dev_postgres_1, dev_activemq_1, dev_shared-file-store_1
|
|
Are you sure? [yN] y
|
|
Removing dev_transform-core-aio_1 ... done
|
|
Removing dev_transform-router_1 ... done
|
|
Removing dev_solr6_1 ... done
|
|
Removing dev_postgres_1 ... done
|
|
Removing dev_activemq_1 ... done
|
|
Removing dev_shared-file-store_1 ... done
|
|
~~~
|
|
|
|
If you have not removed the containers, it is possible to restart the tomcat instance with
|
|
a `mvn install` (no `clean`), but this may result in failures if there are incompatibilities
|
|
between the code, database and content in `dev/dev-acs-amps-overlay/target/dev-instance/runtime/alf_data`.
|
|
Any changes made to alfresco-global properties or log4j will not be picked up, unless you
|
|
directly edit `dev/dev-acs-amps-overlay/target/dev-instance/tomcat/shared/classes/alfresco/extension/custom-log4j.properties`
|
|
and `dev/dev-acs-amps-overlay/target/dev-instance/tomcat/shared/classes/alfresco-global.properties`, but they will be thrown away
|
|
on the next `mvn clean`.
|
|
|
|
## Aliases
|
|
You may also find the aliases specified in the following file useful, as they may save you some typing.
|
|
~~~
|
|
$ source acs-community-packaging/dev/aliases
|
|
~~~ |