Adobe I/O CLI Plugin for interactions with AEM Rapid Development Environments.
- Adobe I/O CLI
- Node.js version compatibility:
- 16.x -- 16.13.0 or higher.
- 18.x -- 18.0.0 or higher.
- Use with odd Node versions is not recommended.
$ aio plugins:install @adobe/aio-cli-plugin-aem-rde
$ aio plugins:update
The plugin needs to be configured to point to an existing RDE environment as follows:
$ aio config:set cloudmanager_orgid <org-id>
$ aio config:set cloudmanager_programid <program-id>
$ aio config:set cloudmanager_environmentid <env-id>
Note: If you are planning to work with multiple environments, we highly recommend you to use the flag
-l
or--local
together with theconfig:set
so that you will store the configuration in the local directory (i.e. the config is only effective in the current directory). For details on different config locations refer to aio-lib-core-config's README.
If you want to enable this experimental feature, run the following command:
$ aio config set -l -j aem-rde.experimental-features '["aem:rde:inspect"]'
This command creates a local configuration file .aio
that contains the information to activate the experimental feature.
When calling the commands under the inspect
topic the plugin needs additional configurations.
- Go to Skyline Developer Console of your environment:
https://dev-console-ns-team-aem-cm-stg-n0000.ethos00-stage-va7.dev.adobeaemcloud.com/#release-cm-p00000-e000000
or use theaio cloudmanager:environment:open-developer-console
command - Go to Integrations tab.
- Go to Local token sub-tab and click on Get Local Development Token button.
- Copy the accessToken:
eyJhbGciOiJSUzI1NiIsIng1dSI.....
- Go to terminal and do the following:
$ aio aem rde inspect setup <paste access token here>
- Run
aio login
- Run
aio aem:rde
for general help. - Run
aio aem:rde:install --help
for help about a specific command. - Run
aio aem:rde:status
to see if the configured environment can be accessed.
Only if inspect
topic is enabled.
- Run
aio aem:rde:inspect --help
to see if the inspect command can be accessed. - Run
aio aem:rde:inspect:logs
to see if the authorization with the set token works.
- Run
npm run test
This both runs the mocha-based unit tests as well as produces a test report table at the end.
A more detailed test report can be found in the coverage/index.html
file.
- Clone this repository to a folder.
- Run
npm install
in the folder. - Run
aio plugins:link .
inside your folder.
Primarily for scripting application purposes, the following exit codes are used:
- 1 - A generic (non-catch) error has occurred
- 2 - A configuration error has occurred
- 3 - A validation error with the supplied flags or arguments has occurred
- 4 - A deployment error has occurred
- 5 - An internal error that might be fixed with a retry has occurred
- 40 - An error emanating from the deployment not being fully performed has occurred. This error might be interpretable by some users as ok if that's a middle step they need to go through