From bfcbfdd19d18dcca4b85f0b4b0472c802f4e1022 Mon Sep 17 00:00:00 2001 From: jyunmitch Date: Fri, 29 Sep 2023 14:14:00 -0500 Subject: [PATCH] ENDOC-752-privatehub-api --- vuepress/docs/next/docs/getting-started/ent-bundle.md | 7 +++++-- vuepress/docs/next/tutorials/solution/entando-hub.md | 2 ++ vuepress/docs/v7.3/docs/getting-started/ent-bundle.md | 5 ++++- vuepress/docs/v7.3/tutorials/solution/entando-hub.md | 2 ++ 4 files changed, 13 insertions(+), 3 deletions(-) diff --git a/vuepress/docs/next/docs/getting-started/ent-bundle.md b/vuepress/docs/next/docs/getting-started/ent-bundle.md index e95333e002..a962b031f2 100644 --- a/vuepress/docs/next/docs/getting-started/ent-bundle.md +++ b/vuepress/docs/next/docs/getting-started/ent-bundle.md @@ -55,14 +55,17 @@ See the [Build and Publish a Simple Bundle](../../tutorials/create/pb/publish-si |:--|:-- |`ent bundle init [name]` | Initialize a new empty project with the default structure and files | |`ent bundle init [name] --from-hub`| Initialize a bundle from the Entando Cloud Hub | -|`ent bundle init [name] --from-hub --hub-url=[url]` | Initialize a bundle from a custom Entando Hub | +|`ent bundle init [name] --from-hub --hub-url=[url]` | Initialize a bundle from an enterprise Entando Hub | +|`ent bundle init [name] --from-hub --hub-url=[url] --hub-api-key=[]` | Initialize a bundle from a private Entando Hub with an API key| #### Init Command Details - Bundle names may only contain lowercase letters, numbers, periods(.) and dashes(-). They cannot start or end with periods or dashes. -- `--from-hub`: This option leverages an existing bundle from an Entando Hub to jumpstart your project. The ent bundle tool will pull the package and rebuild the structure, after which it can be customized locally. +- `--from-hub`: This option leverages an existing bundle from an Entando Hub to jumpstart your project. The `ent bundle` tool will pull the package and rebuild the structure, which can then be customized locally. - `--hub-url`: Use this option to specify a custom Entando Hub, else ent defaults to the Entando Cloud Hub +- `--hub-api-key`: This flag supplies the [Hub API key](../../tutorials/solution/entando-hub.md#create-a-private-catalog) to access a bundle from a private enterprise Entando Hub to copy it locally. + ### Micro Frontend and Microservice | Command| Descriptions |:--|:-- diff --git a/vuepress/docs/next/tutorials/solution/entando-hub.md b/vuepress/docs/next/tutorials/solution/entando-hub.md index 0d0eda3a07..cda8bb1566 100644 --- a/vuepress/docs/next/tutorials/solution/entando-hub.md +++ b/vuepress/docs/next/tutorials/solution/entando-hub.md @@ -118,6 +118,8 @@ API access to private catalogs requires the use of an API key instead of user cr 2. From the Hub UI homepage, click on the gear icon right of the `Add +` button and select `API Key Management`. 3. Click `Generate API Key`, enter a name, and confirm with the blue generate button. Save the key for future reference. +The API key is required to access the bundles and PBCs in a private Entando Hub catalog. Bundles can be initialized directly from there using the [ent bundle init command](../../docs/getting-started/ent-bundle.md#initialization) or by adding the registry in your App Builder and deploying it from that catalog as described below. + ### Add a Catalog as a Registry in your App Builder Any enterprise Hub instance can be accessed from the Entando App Builder of another Entando Application. diff --git a/vuepress/docs/v7.3/docs/getting-started/ent-bundle.md b/vuepress/docs/v7.3/docs/getting-started/ent-bundle.md index e95333e002..85e36f8c91 100644 --- a/vuepress/docs/v7.3/docs/getting-started/ent-bundle.md +++ b/vuepress/docs/v7.3/docs/getting-started/ent-bundle.md @@ -56,13 +56,16 @@ See the [Build and Publish a Simple Bundle](../../tutorials/create/pb/publish-si |`ent bundle init [name]` | Initialize a new empty project with the default structure and files | |`ent bundle init [name] --from-hub`| Initialize a bundle from the Entando Cloud Hub | |`ent bundle init [name] --from-hub --hub-url=[url]` | Initialize a bundle from a custom Entando Hub | +|`ent bundle init [name] --from-hub --hub-url=[url] --hub-api-key=[]` | Initialize a bundle from a private Entando Hub with an API key| #### Init Command Details - Bundle names may only contain lowercase letters, numbers, periods(.) and dashes(-). They cannot start or end with periods or dashes. -- `--from-hub`: This option leverages an existing bundle from an Entando Hub to jumpstart your project. The ent bundle tool will pull the package and rebuild the structure, after which it can be customized locally. +- `--from-hub`: This option leverages an existing bundle from an Entando Hub to jumpstart your project. The `ent bundle` tool will pull the package and rebuild the structure, which can then be customized locally. - `--hub-url`: Use this option to specify a custom Entando Hub, else ent defaults to the Entando Cloud Hub +- `--hub-api-key`: This flag supplies the [Hub API key](../../tutorials/solution/entando-hub.md#create-a-private-catalog) to access a bundle from a private enterprise Entando Hub to copy it locally. + ### Micro Frontend and Microservice | Command| Descriptions |:--|:-- diff --git a/vuepress/docs/v7.3/tutorials/solution/entando-hub.md b/vuepress/docs/v7.3/tutorials/solution/entando-hub.md index 0d0eda3a07..85a041a6f3 100644 --- a/vuepress/docs/v7.3/tutorials/solution/entando-hub.md +++ b/vuepress/docs/v7.3/tutorials/solution/entando-hub.md @@ -118,6 +118,8 @@ API access to private catalogs requires the use of an API key instead of user cr 2. From the Hub UI homepage, click on the gear icon right of the `Add +` button and select `API Key Management`. 3. Click `Generate API Key`, enter a name, and confirm with the blue generate button. Save the key for future reference. +The API key is required to access the bundles and PBCs in a private Entando Hub catalog. Bundles can be initialized directly from there using the [ent bundle init command](../../docs/getting-started/ent-bundle.md#initialization) or by adding the registry in your App Builder and deploying it from that catalog as described below. + ### Add a Catalog as a Registry in your App Builder Any enterprise Hub instance can be accessed from the Entando App Builder of another Entando Application.