cancel
Showing results for 
Search instead for 
Did you mean: 
shazada
Star Contributor
Star Contributor

So it's been long due that we from Contezza that we've created this blog/post around our Admin Tools. This tool is used at our customers and this will become full Open Source.

This is maybe a response to the blog from Alfresco regarding the Control Center:

https://hub.alfresco.com/t5/alfresco-content-services-blog/new-alfresco-admin-app-for-acs-and-aps-en...

We had an app to manager users & groups within sites (for quite some time) and then we started to add stuff, like:

  • Documentation download
  • Angular/ADF Extension information
  • License information
  • Platform modules
  • Manage sites
    • Create Sites
    • View Users & Groups
    • Add Users & Groups
  • Manage Users & Groups
    • View Users & Groups
    • Add Users & Groups within Groups
    • Create Users or Groups ==> is still in Development
  • Manage Space Templates
  • Javascript Console ==> needs platform with the js-console amp/lib installed
  • Node Browser

How can you start it?
As base you could use the compose file from Alfresco github https://github.com/Alfresco/acs-deployment/blob/master/docker-compose/docker-compose.yml

I'm not 100% sure how this works with de NGINX proxy which Alfresco uses, but the app below can be reached with url
http://localhost:4006/

 admin-tools:
  image: harbor.contezza.nl/public/admin-tools:1.0.0
  environment:
   ACS_PROXY_URL: http://${acs.host}:8080/alfresco/
  ports:
   - 4006:8080
  networks:
   dev_network:
    aliases:
     - admin-tools

Screenshot how it looks like.

imageimageimage

Spoiler
If you need to use the Javascript Console features, then you'll need to have a platform with an Alfresco 6.2.x or highter with a Javascript-console version 0.7 or higher (built by the code) https://github.com/share-extras/js-console

TODO

  • Go to github with our code ==> probably OOTB or Share-Extras
    • We have a mono-repository now, so will need to split the code
  • We use a lot of internal libraries which aren't available in our Nexus or NPMJS
    • These need to be built seperately and published
  • We'll need to publish the module also as a war/jar so one can include it in tomcat so no Docker image is needed or when someone just want's to include this module directly in the backend platform

A great shout out to our Developers at Contezza, Wasyl, Rick, Tjerk, Diego, Nume who are too shy to create a blog ==> hence I'm doing it Smiley Tongue.

Code will be published here:
https://github.com/OrderOfTheBee/admin-tools

6 Comments
fedorow
Elite Collaborator
Elite Collaborator

Great! I want to put it behind the proxy, but './' url already in use.

How to change base-href and deploy-url? Does container understand BASE_PATH argument or some thing?

shazada
Star Contributor
Star Contributor

Yes the Dockerfile and entrypoint.sh are similar to the alfresco-content-app.

BASEPATH can be used similar.

if [[ $BASEPATH ]]; then
  replace="\/"
  encoded=${BASEPATH//\//$replace}
  sed -i s%href=\"/\"%href=\""$encoded"\"%g /tmp/index.html && \
  cat /tmp/index.html > ./index.html
fi
shazada
Star Contributor
Star Contributor

We've manually pushed some code to https://github.com/OrderOfTheBee/admin-tools

Atleast the dockerfile and entrypoint are here including some stuff on extending Alfresco-Content-App

More will come in the coming weeks when we sort out the rest of the issues Smiley Happy

unibravo
Confirmed Champ
Confirmed Champ

Dear Shazada, thank you very much for this app.

I downloaded but not working on Docker.

Docker log:

2022/10/10 00:10:47 [emerg] 25#25: invalid URL prefix in /etc/nginx/nginx.conf:37
nginx: [emerg] invalid URL prefix in /etc/nginx/nginx.conf:37

shazada
Star Contributor
Star Contributor

@unibravoyou haven't provided the alfresco url to the image.

environment:
   ACS_PROXY_URL: http://${acs.host}:8080/alfresco/
Olivia69
Champ in-the-making
Champ in-the-making

By default, an administrator user comes with the Alfresco bundle with the username admin and the password admin.