Alfresco Community Admin Tools

[shazada]

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.

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 .

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

[fedorow]

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]

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]

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

[unibravo]

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]

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

environment:
   ACS_PROXY_URL: http://${acs.host}:8080/alfresco/

[Olivia69]

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