alfresco-content-app icon indicating copy to clipboard operation
alfresco-content-app copied to clipboard

Documentation for ADW does not indicate the need for BASE_URL in .env

Open binduwavell opened this issue 2 years ago • 5 comments

For both ADW 2.8.0 and 2.9.0 there is no documentation that indicates you must provide a value for BASE_URL. In our case we are not using APS, so in theory this should not be required.

At least the docs should be updated. Or possibly a better solution would be to update the proxy.*conf.js files to use APP_CONFIG_BPM_HOST in the event BASE_URL is not provided. At least I think these need to effectively be the same?

binduwavell avatar Jun 21 '22 20:06 binduwavell

I should add that this is required during development and not once you package/deploy.

binduwavell avatar Jun 22 '22 15:06 binduwavell

@binduwavell Thanks for the feedback. Can you also please add links to the ADW docs that you are using ? ( cc @oliveralfresco2018 @aborroy)

In case it helps, you could also look at the ACS Deployment docker-compose for a very basic / vanilla setup, eg.

Alfresco Content App

  • https://github.com/Alfresco/acs-deployment/blob/master/docker-compose/community-docker-compose.yml#L114-L118

Alfresco Digital Workspace

  • https://github.com/Alfresco/acs-deployment/blob/master/docker-compose/docker-compose.yml#L148-L154

Also, hopefully you've seen this recent blog from @aborroy

  • https://hub.alfresco.com/t5/application-development/extending-the-alfresco-digital-workspace-adw/ba-p/312843

montgolfiere avatar Jun 23 '22 14:06 montgolfiere

Thank you @montgolfiere for the reply. The docs I'm referencing are those included in the ADW source zip file I downloaded from the Alfresco Nexus server.

There are docs in both content-ce and content-ee and some various README files.

I had not seen Angel's post on ADW (I did see the post on ACA a month or two ago). I published something similar to the beginning of his ADW post a couple days before him: https://www.ziaconsulting.com/technology/alfresco-technology/getting-started-with-alfresco-digital-workspace-development/ :)

FYI, I've created a basic extension, figured out how to overlay it on the provided ADW-2.9.0 container and have it deployed (in Dev) at a customer.

binduwavell avatar Jun 25 '22 00:06 binduwavell

Additionally, this blog may help: https://hub.alfresco.com/t5/application-development/extending-the-alfresco-digital-workspace-adw/bc-p/313096

aborroy avatar Jul 11 '22 08:07 aborroy

Thanks @aborroy this looks like the same article referenced by @montgolfiere above.

binduwavell avatar Jul 12 '22 19:07 binduwavell