This is the parent repository for the Entando Hub project which currently contains two deployable sub-projects
application
which has the MFEs and microservices for the Entando Hub applicationcontent
which has the non-compiled components such as pages, page templates, and fragments.
Move inside one of the two folders application
and content
, which contain the bundles.
You can build,deploy and install the bundles on Entando with commands of ent.
ent bundle pack
ent bundle publish
ent bundle deploy
ent bundle install
For more details check the readme of application
and content
.
This sections is useful to connect an existing Entando Hub.
From AppBuilder menu, you select Hub
. At the top right, select Select Registry
and New Registry
.
You can choose Name and configure the url endpoint.
- example endpoint value for localhost:
http://localhost:8081/appbuilder/api
- example endpoint value for production:
http://{{YOUR-HOSTNAME}}/entando-hub-application-{{BUNDLE-CODE}}/entando-hub-catalog-ms/appbuilder/api
You can deploy through ent using pre-built image from entando.
ent ecr deploy --repo=docker://registry.hub.docker.com/entando/entando-hub-application
ent ecr deploy --repo=docker://registry.hub.docker.com/entando/entando-hub-content
Install the bundle from AppBuilder GUI.
Set up permissions to configure the service:
- Login to your Keycloak instance as an admin.
- Give at least one user the ability to manage the Hub by granting the
eh-admin
role. Assign theeh-admin
role for thepn-{{BUNDLE-ID}}-{{PLUGIN-ID}}-entando-entando-hub-catalog-ms-server
client. - Give the generated plugin client permission to manage users:
- From the left sidebar, go to Clients and select client ID
pn-{{BUNDLE-ID}}-{{PLUGIN-ID}}-entando-entando-hub-catalog-ms-server
. - Click the
Service Account
tab at the top of the page and selectrealm-management
from theClient Roles
field. - Choose
realm-admin
fromAvailable Roles
. ClickAdd selected
. It should appear as anAssigned Role
.
Note: BUNDLE-ID
and PLUGIN-ID
are dynamic values that depend on the publishing url.
- v3.1 Introduces the ability to support private catalogs and converts the Hub codebase to the newer docker-based (v5) format. Entando 7.2 is required to make use of Hub private catalogs from within the AppBuilder
- Note: the git-based bundles (https://github.com/entando-samples/entando-hub-application-bundle.git and https://github.com/entando-samples/entando-hub-content-bundle.git) are now no longer maintained but still available for older Entando versions.
- v2.1 Includes a number of new features including the ability to add the source URL for each bundle, added support for Docker bundle URLs (new in Entando 7.1), an expanded description field, and a number of usability and security fixes.
- v1.x Can be installed in Entando 6.3.2 or higher and includes API-level integration with the Entando 7.0+ App Builder. See https://developer.entando.com/v7.1/tutorials/solution/entando-hub.html for detailed instructions on installing and using the Hub, including connecting an Entando App Builder to any Hub instance.