Entornos de desarrollo rápido rapid-development-environments

Para implementar cambios, los entornos de desarrollo de nube actuales requieren el uso de un proceso que emplea amplias reglas de calidad y seguridad de código denominadas canalización CI/CD. Para situaciones en las que se necesitan cambios rápidos e iterativos, Adobe ha introducido entornos de desarrollo rápido (RDE, por sus siglas en inglés).

Los RDE permiten a los desarrolladores implementar y revisar los cambios rápidamente, minimizando la cantidad de tiempo necesario para probar las funciones que han demostrado funcionar en un entorno de desarrollo local.

Una vez que los cambios se han probado en un RDE, pueden implementarse en un entorno de desarrollo de nube normal a través de la canalización de Cloud Manager.

Puede ver vídeos adicionales que muestran cómo configurarlo, cómo utilizarlo y el ciclo de vida de desarrollo mediante RDE.

Introducción introduction

Los RDE se pueden utilizar para configuraciones de código, contenido y Apache o Dispatcher. A diferencia de los entornos de desarrollo de nube normales, los desarrolladores pueden utilizar herramientas de línea de comandos locales para sincronizar el código creado localmente en un RDE.

Cada programa está aprovisionado con un RDE. Si hay cuentas de zona protegida, hibernan después de unas horas de no uso.

Una vez creados, los RDE se establecen en la última versión de Adobe Experience Manager (AEM) disponible. Un restablecimiento de RDE, que se puede realizar con Cloud Manager, ciclos el RDE y lo establece en la última versión de AEM disponible.

Normalmente, un solo desarrollador utiliza un RDE en un momento determinado para probar y depurar una función específica. Cuando se completa la sesión de desarrollo, el RDE se puede restablecer a un estado predeterminado para el siguiente uso.

Los RDE adicionales pueden tener licencia para programas de Producción (que no sean de zonas protegidas).

Habilitar RDE en un programa enabling-rde-in-a-program

La pantalla Información general ahora muestra su nuevo entorno en la tarjeta Entornos.

Una vez creados, los RDE se establecen en la versión de AEM más reciente disponible. Un restablecimiento de RDE, que también se puede realizar con Cloud Manager, ciclo el RDE y lo establece en la última versión de AEM disponible.

Para obtener más información sobre cómo usar Cloud Manager para crear entornos, administrar quién tiene acceso a ellos y asignar dominios personalizados, consulte Programas y tipos de programas en la documentación de Cloud Manager.

Instale las herramientas de línea de comandos de RDE installing-the-rde-command-line-tools

Después de agregar un RDE para el programa mediante Cloud Manager, puede interactuar con él configurando las herramientas de línea de comandos como se describe en los pasos siguientes:

Configuración interactiva installing-the-rde-command-line-tools-interactive

El comando setup pregunta si la configuración proporcionada debe almacenarse local o globalmente.

Setup the CLI configuration necessary to use the RDE commands.
? Do you want to store the information you enter in this setup procedure locally? (y/N)

Elija no para

Elija yes para hacer lo siguiente:

Una vez seleccionada la configuración local o global, el comando setup intenta leer el ID de su organización de inicio de sesión actual y, a continuación, leer los programas de la organización. Si no se encuentra la organización, puede introducirla manualmente junto con algunas directrices.

Selected only organization: XYXYXYXYXYXYXYXXYY
retrieving programs of your organization ...

Una vez recuperados los programas, el usuario puede seleccionar de la lista y también escribir para filtrar. Cuando se selecciona el programa, se muestra una lista de entornos RDE para elegir. Si solo hay un programa, o solo un entorno RDE disponible, o ambos, se selecciona automáticamente.

Para ver el contexto del entorno actual, ejecute lo siguiente:

aio aem rde setup --show

El comando responde con un resultado similar al siguiente:

Current configuration: cm-p1-e1: programName - environmentName (organization: ...@AdobeOrg)

Procedimiento de configuración manual en un entorno no interactivo manual-setup

En entornos en los que ningún usuario puede ejecutar el comando setup de forma interactiva (como CI/CD o secuencias de comandos), se requiere la configuración manual. Puede establecer los parámetros de organización, programa y entorno siguiendo los pasos a continuación.

Utilizar RDE al desarrollar una nueva función using-rde-while-developing-a-new-feature

Adobe recomienda el siguiente flujo de trabajo para desarrollar una nueva función:

Usar RDE para depurar una función existente use-rde-to-debug-an-existing-feature

El flujo de trabajo es similar al desarrollo de una nueva función. La diferencia es que el código sincronizado con RDE refleja la etiqueta Git de lo que se insertó en el entorno en el que se produjo el problema. Este flujo de trabajo ayuda a garantizar la coherencia al investigar o reproducir el problema. Además, puede resultar útil implementar contenido que coincida con el entorno de flujo ascendente. Este enfoque se puede lograr mediante la exportación e importación de paquetes de contenido.

Varios desarrolladores que colaboran en el mismo RDE multiple-developers-collaborating-on-the-same-rde

Un RDE admite un solo proyecto a la vez. Dado que el código se sincroniza desde un entorno de desarrollo local al entorno de RDE, es más natural que un desarrollador lo utilice por su cuenta en un momento determinado.

Sin embargo, con una coordinación cuidadosa, es posible que más de un desarrollador valide una función específica o depure un problema específico. La clave es que cada desarrollador mantenga sus proyectos locales sincronizados para que los demás desarrolladores absorban los cambios de código realizados por un desarrollador en particular. De lo contrario, un desarrollador podría sobrescribir inadvertidamente el código del otro. La estrategia recomendada es que cada desarrollador confirme sus cambios en una rama de Git compartida antes de sincronizarse con RDE, de modo que los demás desarrolladores extraigan los cambios antes de realizar sus propios cambios.

Herramientas de línea de comandos de RDE Comandos rde-cli-commands

Ayuda/Información general help

Indicadores globales global-flags

Implementar en RDE deploying-to-rde

En esta sección se explica cómo utilizar la CLI de RDE para implementar, instalar o actualizar varios recursos. Estos recursos incluyen lo siguiente:

El patrón de uso general es aio aem:rde:install <artifact>.

Puede encontrar algunos ejemplos a continuación:

Implementación de un paquete de contenido deploy-content-package

aio aem:rde:install sample.demo.ui.apps.all-1.0.0-SNAPSHOT.zip

La respuesta para una implementación correcta es similar a la siguiente:

...
#1: deploy completed for content-package sample.demo.ui.apps.all-1.0.0-SNAPSHOT.zip on author,publish - done by 9E072FC75D54FE1A2B49431C@AdobeID at 2022-09-13T11:32:06.229Z

Opcionalmente, puede hacer referencia a un repositorio remoto:

aio aem:rde:install -t content-package "https://repo1.maven.org/maven2/com/adobe/aem/guides/aem-guides-wknd.all/2.1.0/aem-guides-wknd.all-2.1.0.zip"

De manera predeterminada, los artefactos se implementan en los niveles de creación y publicación, pero el indicador -s se puede usar para dirigirse a un nivel específico.

Se puede implementar cualquier paquete de AEM, como paquetes con código, contenido o un paquete contenedor (también denominado paquete "todo").

Implementar una configuración OSGI deploy-OSGI-config

aio aem:rde:install com.adobe.granite.demo.MyServlet.cfg.json

Donde la respuesta para una implementación correcta es similar a la siguiente:

...
#2: deploy completed for osgi-config com.adobe.granite.demo.MyServlet.cfg.json on author,publish - done by 9E0725C05D54FE1A0B49431C@AdobeID at 2022-09-13T11:54:36.390Z

Implementación de un paquete deploy-bundle

Para implementar un paquete, utilice:

aio aem:rde:install ~/.m2/repository/org/apache/felix/org.apache.felix.gogo.jline/1.1.8/org.apache.felix.gogo.jline-1.1.8.jar

Donde la respuesta para una implementación correcta es similar a la siguiente:

...
#3: deploy staged for osgi-bundle org.apache.felix.gogo.jline-1.1.8.jar on author,publish - done by 9E0725C05D53BE1A0B49431C@AdobeID at 2022-09-14T07:54:28.882Z

Implementación de un archivo de contenido deploy-content-file

Para implementar un archivo de contenido, utilice:

aio aem:rde:install world.txt -p /apps/hello.txt

Donde la respuesta para una implementación correcta es similar a la siguiente:

..
#4: deploy completed for content-file world.txt on author,publish - done by 9E0729C05C54FE1A0B49431C@AdobeID at 2022-09-14T07:49:30.644Z

Implementar una configuración de Apache/Dispatcher deploy-apache-config

Toda la estructura de carpetas debe estar en forma de archivo zip para este tipo de configuración.

Desde el módulo dispatcher de un proyecto de AEM, puede comprimir la configuración de Dispatcher ejecutando el siguiente comando de Maven:

mvn clean package

O utilizando el siguiente comando zip del directorio src del módulo dispatcher:

zip -y -r dispatcher.zip .

A continuación, implemente la configuración mediante este comando:

aio aem:rde:install target/aem-guides-wknd.dispatcher.cloud-X.X.X-SNAPSHOT.zip

Una implementación correcta genera una respuesta similar a la siguiente:

..
#5 deploy completed for dispatcher-config dispatcher.zip on author,publish - done by 9E0735C05T54FE1A0B49431C@AdobeID at 2022-10-03T10:26:31.286Z
Logs:
  Cloud manager validator 2.0.49
  2022/10/03 10:26:37 No issues found
  Syntax OK

El código implementado en RDE no se somete a una canalización de Cloud Manager y a sus puertas de calidad asociadas. Sin embargo, el código pasa por algún análisis, que informa de los errores, como se muestra en el ejemplo de código siguiente:

$ aio aem:rde:install ~/.m2/repository/org/apache/felix/org.apache.felix.gogo.jline/1.1.8/org.apache.felix.gogo.jline-1.1.8.jar
...
#19: deploy staged for osgi-bundle org.apache.felix.gogo.jline-1.1.8.jar on author,publish - done by 9E0725C05D74FR1A0B49431C@AdobeID at 2022-09-14T07:54:28.882Z
Logs:
The analyser found the following errors for author :
[requirements-capabilities] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Artifact com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8 requires [org.apache.felix.gogo.jline/1.1.8] org.apache.felix.gogo; filter:="(&(org.apache.felix.gogo=command.implementation)(version>=1.0.0)(!(version>=2.0.0)))"; effective:=active in start level 20 but no artifact is providing a matching capability in this start level.
[api-regions-exportsimports] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Bundle org.apache.felix.gogo.jline:1.1.8 is importing package(s) [org.jline.builtins, org.jline.utils, org.apache.felix.service.command, org.apache.felix.service.threadio, org.jline.terminal, org.jline.reader, org.apache.felix.gogo.runtime, org.jline.reader.impl] in start level 20 but no bundle is exporting these for that start level.
The analyser found the following errors for publish :
[requirements-capabilities] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Artifact com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8 requires [org.apache.felix.gogo.jline/1.1.8] org.apache.felix.gogo; filter:="(&(org.apache.felix.gogo=command.implementation)(version>=1.0.0)(!(version>=2.0.0)))"; effective:=active in start level 20 but no artifact is providing a matching capability in this start level.
[api-regions-exportsimports] com.adobe.aem.temp:org.apache.felix.gogo.jline:1.1.8: Bundle org.apache.felix.gogo.jline:1.1.8 is importing package(s) [org.jline.builtins, org.jline.utils, org.apache.felix.service.command, org.apache.felix.service.threadio, org.jline.terminal, org.jline.reader, org.apache.felix.gogo.runtime, org.jline.reader.impl] in start level 20 but no bundle is exporting these for that start level.

El ejemplo de código anterior ilustra el comportamiento si un paquete no se resuelve. En cuyo caso, se "almacena en zona intermedia" y solo se instala si sus requisitos (importaciones que faltan, en este caso) se satisfacen mediante la instalación de otro código.

Implementar la configuración relacionada con la canalización de configuración (configuraciones yaml) deploy-config-pipeline

Las configuraciones específicas del entorno (uno o más archivos yaml) descritas en el artículo Uso de canalizaciones de configuración se pueden implementar de la siguiente manera:

aio aem:rde:install -t env-config ./my-config-folder
Donde my-config-folder es la carpeta principal que contiene las configuraciones de yaml.

También es posible instalar un archivo zip que contenga el árbol de carpetas de configuración:

aio aem:rde:install -t env-config config.zip

Tenga en cuenta que la matriz envTypes del archivo yaml incluye el valor rde, como en el ejemplo siguiente:

kind: "CDN"
version: "1"
metadata:
  envTypes: ["rde"]

Implementar código front-end basado en temas de sitio y plantillas de sitio deploying-themes-to-rde

Los RDE admiten código front-end generado con temas del sitio y plantillas de sitio. En lugar de usar la canalización front-end de Cloud Manager como otros tipos de entorno, los RDE implementan paquetes front-end usando una directiva de línea de comandos.

Como de costumbre, cree su paquete front-end utilizando npm:

npm run build

Genera una carpeta dist/, de modo que la carpeta del paquete front-end contiene un archivo package.json y una carpeta dist:

ls ./path-to-frontend-pkg-folder/
...
dist
package.json

Ahora está listo para implementar el paquete front-end en RDE señalando la carpeta de paquetes front-end de la siguiente manera:

aio aem:rde:install -t frontend ./path-to-frontend-pkg-folder/
...
#1: deploy completed for frontend frontend-pipeline.zip on author,publish - done by ... at 2024-01-18T15:33:22.898Z
Logs:
> Deployed artifact wknd-1.0.0-1705592008-26e7ec1a
> with workspace hash 692021864642a20d6d298044a927d66c0d9cf2adf42d4cca0c800a378ac3f8d3

También puede comprimir el archivo package.json y la carpeta dist e implementar ese archivo zip:

zip -r frontend-pkg.zip ./path-to-frontend-pkg-folder/dist ./path-to-frontend-pkg-folder/package.json

aio aem:rde:install -t frontend frontend-pkg.zip
...
#1: deploy completed for frontend frontend-pipeline.zip on author,publish - done by ... at 2024-01-18T15:33:22.898Z
Logs:
> Deployed artifact wknd-1.0.0-1705592008-26e7ec1a
> with workspace hash 692021864642a20d6d298044a927d66c0d9cf2adf42d4cca0c800a378ac3f8d3

Comprobar el estado de RDE checking-rde-status

Puede utilizar la CLI de RDE para comprobar si el entorno está listo para implementarse en, ya que las implementaciones se han realizado mediante el complemento de RDE.

Ejecutar lo siguiente:

aio aem:rde:status

Devuelve lo siguiente:

Info for cm-p12345-e987654
Environment: Ready
- Bundles Author:
 com.adobe.granite.sample.demo-1.0.0.SNAPSHOT
- Bundles Publish:
 com.adobe.granite.sample.demo-1.0.0.SNAPSHOT
- Configurations Author:
 com.adobe.granite.demo.MyServlet
- Configurations Publish:
 com.adobe.granite.demo.MyServlet

Si el comando devuelve una nota sobre la implementación de instancias, aún puede continuar y realizar la siguiente actualización, pero es posible que la última aún no esté visible en la instancia.

Mostrar historial de implementación show-deployment-history

Puede comprobar el historial de implementaciones realizadas en RDE ejecutando:

aio aem:rde:history

Que devuelve una respuesta en forma de:

#1: deploy completed for content-package aem-guides-wknd.all-2.1.0.zip on author,publish - done by 029039A55D4DE16A0A494025@AdobeID at 2022-09-12T14:41:55.393Z

Eliminar de RDE deleting-from-rde

Puede utilizar la herramienta CLI para eliminar configuraciones y paquetes que haya implementado anteriormente en RDE. Utilice el comando status para obtener una lista de lo que se puede eliminar, que incluye bsn para paquetes y pid para configuraciones a las que se hará referencia en el comando eliminar.

Por ejemplo, si se ha instalado com.adobe.granite.demo.MyServlet.cfg.json, bsn es solo com.adobe.granite.demo.MyServlet, sin el sufijo cfg.json.

No se admite la eliminación de paquetes de contenido o archivos de contenido. Para eliminarlos, restablezca el RDE, que lo devuelve a un estado predeterminado.

Consulte el ejemplo siguiente para obtener más información:

aio aem:rde:delete com.adobe.granite.csrf.impl.CSRFFilter
#13: delete completed for osgi-config com.adobe.granite.csrf.impl.CSRFFilter on author - done by karl at 2022-09-12T22:01:01.955Z
#14: delete completed for osgi-config com.adobe.granite.csrf.impl.CSRFFilter on publish - done by karl at 2022-09-12T22:01:12.979Z

Para obtener más información y demostración, vea el tutorial en vídeo cómo usar comandos RDE (10:01).

Implementar en un RDE desde proveedores de Git externos deploy-to-rde

Cloud Manager admite la implementación de código en RDE directamente desde proveedores de Git externos al usar la configuración Traer su propio Git (BYOG).

La implementación en RDE desde un repositorio Git externo requiere lo siguiente:

Notas de uso

Funcionamiento

Registros rde-logging

Al igual que otros tipos de entornos, los niveles de registro se pueden establecer modificando las configuraciones de OSGi, aunque, como se ha descrito anteriormente, el modelo de implementación para RDE implica una línea de comandos en lugar de una implementación de Cloud Manager. Consulte la documentación de registro para obtener más información sobre cómo ver, descargar e interpretar los registros.

La CLI de RDE también tiene su propio comando de registro que se utiliza para configurar rápidamente qué clases y paquetes se registran, y en qué nivel de registro. Estas configuraciones pueden verse como efímeras, ya que no modifican las propiedades OSGI en el control de versiones. Esta función se centra en rastrear registros en tiempo real, en lugar de buscar registros del pasado distante.

El siguiente ejemplo ilustra cómo rastrear el nivel de creación, con un paquete establecido en un nivel de registro de depuración y dos paquetes (separados por espacios) establecidos en un nivel de depuración de información. La salida que incluye un paquete auth está resaltada.

aio aem:rde:logs --target=author --debug=org.apache.sling --info=org.apache.sling.commons.threads.impl org.apache.sling.jcr.resource.internal.helper.jcr -H .auth.

aio aem:rde:reset

Consulte aio aem:rde:logs --help para ver el conjunto completo de opciones de línea de comandos.

Las funciones incluyen lo siguiente:

Tenga en cuenta que los registros se almacenan en la memoria en el RDE y estos registros se reciclan y, por lo tanto, se descartan si no se siguen o si la red es demasiado lenta.

Restablecer el RDE reset-rde

Al restablecer el editor de texto enriquecido, se eliminan todos los códigos personalizados, las configuraciones y el contenido de las instancias de autor y publicación. Restablecer el RDE es útil cuando ha terminado de probar una función y desea devolver el entorno a un estado predeterminado antes de probar otra.

Un restablecimiento establece el RDE en la última versión de AEM disponible.

Puede restablecer el RDE usando Cloud Manager o la línea de comandos. El restablecimiento tarda unos minutos y todo el contenido y el código existentes se eliminan del editor de código.

Restablezca el RDE utilizando la línea de comandos reset-the-rde-command-line

Puede restablecer el RDE y devolverlo a un estado predeterminado ejecutando lo siguiente:

aio aem:rde:reset

Este proceso suele tardar unos minutos y genera un informe de Environment reset. si se realiza correctamente o de Failed to reset the environment. si hay errores. Para obtener un resultado estructurado, consulte el capítulo sobre el resultado --json que aparece a continuación.

Utilice el comando status para comprobar si el entorno está listo de nuevo.

Restablecer el RDE en Cloud Manager reset-the-rde-cloud-manager

Puede utilizar Cloud Manager para restablecer su RDE siguiendo los pasos siguientes:

Una vez que se inicia el restablecimiento de RDE, normalmente se tardan unos minutos en completar y restaurar el entorno a su estado predeterminado. Puede ver el estado de restablecimiento en cualquier momento en la columna Estado de la tarjeta o ventana de Entornos.

También puede restablecer el RDE usando el botón de puntos suspensivos directamente desde la tarjeta Entornos en la página Información general.

Para obtener más información sobre cómo usar Cloud Manager para administrar sus entornos, consulte la documentación de Cloud Manager.

Comandos compatibles con la salida JSON json-commands

La mayoría de los comandos admiten el indicador global --json, que suprime la salida de la consola y devuelve un json válido para procesarlo en los scripts. A continuación se muestran algunos comandos admitidos, con ejemplos de la salida json.

Estado status

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "Modification in progress | Deployment in progress | Upload in progress | Ready (instances are currently deploying) | Ready",
  "author": {
    "osgiBundles": [],
    "osgiConfigs": []
  },
  "publish": {
    "osgiBundles": [],
    "osgiConfigs": []
  }
}

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "Ready",
  "author": {
    "osgiBundles": [
      {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "updateId": "80",
        "service": "author",
        "type": "osgi-bundle",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        }
      }
    ],
    "osgiConfigs": [
      {
        "id": "publish_osgi-config_com.adobe.granite.demo.MyServlet",
        "updateId": "80",
        "service": "publish",
        "type": "osgi-config",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "configPid": "com.adobe.granite.demo.MyServlet"
        }
      }
    ]
  },
  "publish": {
    "osgiBundles": [
      {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "updateId": "80",
        "service": "author",
        "type": "osgi-bundle",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        }
      }
    ],
    "osgiConfigs": [
      {
        "id": "publish_osgi-config_com.adobe.granite.demo.MyServlet",
        "updateId": "80",
        "service": "publish",
        "type": "osgi-config",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "configPid": "com.adobe.granite.demo.MyServlet"
        }
      }
    ]
  }
}

Instalar install

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "items": [
    {
      "updateId": "4",
      "info": "deploy",
      "action": "deploy",
      "metadata": {
        "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip"
      },
      "services": [
        "author",
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:30:44.578Z",
        "processed": "2024-05-21T12:31:07.886468Z"
      },
      "user": "userId",
      "type": "content-package",
      "hash": "2ad73507",
      "logs": [
        "No logs available for this update."
      ]
    }
  ]
}

Eliminar delete

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "items": [
    {
      "updateId": "84",
      "info": "delete author_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "author"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T11:49:16.889Z",
        "processed": "2024-05-21T11:49:18.188420Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "author",
        "type": "osgi-bundle",
        "updateId": "83"
      },
      "hash": "636f6d2e",
      "logs": [
        "No logs available for this update."
      ]
    },
    {
      "updateId": "85",
      "info": "delete publish_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T11:49:23.857Z",
        "processed": "2024-05-21T11:49:25.237930Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "publish_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "publish",
        "type": "osgi-bundle",
        "updateId": "83"
      },
      "hash": "636f6d2e",
      "logs": [
        "No logs available for this update."
      ]
    }
  ]
}

Historia history

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "Ready",
  "items": [
    {
      "updateId": "112",
      "info": "delete publish_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:53:07.934Z",
        "processed": "2024-05-21T12:53:09.118766Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "publish_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "publish",
        "type": "osgi-bundle",
        "updateId": "110"
      },
      "hash": "636f6d2e"
    },
    {
      "updateId": "111",
      "info": "delete author_osgi-bundle_com.adobe.granite.hotdev.demo",
      "action": "delete",
      "metadata": {},
      "services": [
        "author"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:53:00.824Z",
        "processed": "2024-05-21T12:53:02.101560Z"
      },
      "user": "userId",
      "type": "osgi-bundle",
      "deletedArtifact": {
        "id": "author_osgi-bundle_com.adobe.granite.hotdev.demo",
        "metadata": {
          "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip",
          "bundleSymbolicName": "com.adobe.granite.hotdev.demo",
          "bundleName": "HotDev Bundle",
          "bundleVersion": "1.0.0.SNAPSHOT"
        },
        "service": "author",
        "type": "osgi-bundle",
        "updateId": "110"
      },
      "hash": "636f6d2e"
    },
    {
      "updateId": "110",
      "info": "deploy",
      "action": "deploy",
      "metadata": {
        "name": "hotdev.demo.ui.apps.all-1.0.0-SNAPSHOT.zip"
      },
      "services": [
        "author",
        "publish"
      ],
      "status": "completed",
      "timestamps": {
        "received": "2024-05-21T12:52:12.123Z",
        "processed": "2024-05-21T12:52:31.026147Z"
      },
      "user": "userId",
      "type": "content-package",
      "hash": "2ad73507"
    }
  ]
}

Restablecer reset

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "resetting"
}

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "reset"
}

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "reset_failed"
}

Reiniciar restart

{
  "programId": "myProgram",
  "environmentId": "myEnv",
  "status": "restarted"
}

Modos de ejecución runmodes

La configuración OSGI específica de RDE se puede aplicar utilizando sufijos en el nombre de la carpeta, como en los ejemplos siguientes:

Consulte la documentación sobre el modo de ejecución para obtener información general sobre los modos de ejecución.

Los RDE son distintos de otros entornos en los que el contenido se puede instalar en una carpeta install.rde (o install.author.rde o install.publish.rde) en /apps. Esta capacidad le permite enviar contenido a Git y enviarlo al editor de texto enriquecido (RDE) mediante las herramientas de la línea de comandos.

Rellenar con contenido populating-content

Cuando se restablece un RDE, se elimina todo el contenido y, por lo tanto, si lo desea, se debe realizar una acción explícita para añadir contenido. Como práctica recomendada, considere la posibilidad de combinar un conjunto de contenido para utilizarlo como contenido de prueba para validar o depurar funciones en el editor de experiencias visuales. Existen varias estrategias posibles para rellenar el RDE con ese contenido:

Se encuentra limitado a 1 GB al sincronizar paquetes de contenido.

¿En qué se diferencian los RDE de los entornos de desarrollo en la nube? how-are-rds-different-from-cloud-development-environments

Aunque el RDE es similar en muchos aspectos a un entorno de desarrollo en la nube, existen algunas diferencias arquitectónicas menores que permiten una sincronización rápida del código. El mecanismo para obtener código en RDE es diferente: para RDE, se sincroniza código de un entorno de desarrollo local, mientras que para los entornos de desarrollo en la nube, se implementa código a través de Cloud Manager.

Por estos motivos, se recomienda que después de validar el código en un entorno RDE, implemente el código en un entorno de desarrollo de nube mediante la canalización que no sea de producción. Finalmente, pruebe el código antes de implementarlo con la canalización de producción.

Tenga en cuenta también las siguientes consideraciones:

¿Cuántos RDE necesito? how-many-rds-do-i-need

Hay disponible un RDE para cada solución con licencia y Adobe también ofrece RDE adicionales, con licencia para programas de Producción (que no sean de zonas protegidas).

El número de RDE necesarios depende de la composición y los procesos de una organización. El modelo más flexible es donde una organización compra un RDE dedicado para cada uno de sus desarrolladores de AEM Cloud Service. En este modelo, cada desarrollador puede probar su código en RDE sin coordinarse con otros integrantes del equipo para saber si hay un entorno RDE disponible.

En el otro extremo, un equipo con un solo RDE puede confiar en la coordinación interna para decidir qué desarrollador utiliza el entorno en un momento determinado. Este método funciona bien cuando un desarrollador alcanza un hito en la funcionalidad y necesita validar su trabajo en un entorno de nube con la flexibilidad de realizar cambios rápidos.

Un modelo intermedio es aquel en el que una organización compra varios RDE, de modo que existe una mayor probabilidad de que esté disponible un RDE no utilizado. Una estrategia podría ser asignar un RDE por equipo de depuración o función principal. Se pueden utilizar procesos internos para coordinar el uso de los entornos.

¿En qué se diferencia un AEM Forms Cloud Service RDE de otros entornos? how-are-forms-rds-different-from-cloud-development-environments

Los desarrolladores de Forms pueden utilizar el entorno de desarrollo rápido Cloud Service de AEM Forms para desarrollar Forms adaptable, flujos de trabajo y personalizaciones rápidas, como la personalización de componentes principales, integraciones con sistemas de terceros y mucho más. El entorno de desarrollo rápido (RDE) de AEM Forms Cloud Service no es compatible con las API de comunicación. Tampoco es compatible con las funciones y capacidades que requieren el documento de registro, como la generación de un documento de registro al enviar un formulario adaptable. Las siguientes funciones de AEM Forms no están disponibles en un entorno de desarrollo rápido (RDE):

Tutorial de RDE

Para obtener más información sobre RDE en AEM as a Cloud Service, vea el tutorial en vídeo que muestra cómo configurarlo, cómo utilizarlo y el ciclo de vida de desarrollo (01:25).

Solución de problemas troubleshooting

Solucionar problemas de RDE (#rde-troublehooting)

Cómo obtener la última versión de AEM para un RDE existente get-latest-aem-version

Una vez creados, los RDE se establecen en la última versión de Adobe Experience Manager (AEM) disponible. Un restablecimiento de RDE, que se puede realizar mediante Cloud Manager o el comando aio aem:rde:reset, ciclos el RDE y lo establece en la última versión de AEM disponible.

Solucionar problemas del complemento aio RDE aio-rde-plugin-troubleshooting

Errores relacionados con permisos insuficientes insufficient-permissions

Para usar el complemento RDE, es necesario que seas miembro del perfil de producto de Desarrollador - Cloud Service de Cloud Manager. Consulte Asignar integrantes del equipo a perfiles de producto de Cloud Manager - Asignar el perfil de producto del desarrollador para obtener más información.

También puede confirmar que tiene esta función de desarrollador si inicia sesión en la consola de desarrollador ejecutando el siguiente comando:

aio cloudmanager:environment:open-developer-console

aio plugins:install @adobe/aio-cli-plugin-cloudmanager

Compruebe que el inicio de sesión se haya completado correctamente ejecutando lo siguiente:

aio cloudmanager:list-programs

Este proceso enumera todos los programas de la organización configurada y confirma que tiene asignada la función correcta.

Usar contexto obsoleto aio-cli-plugin-cloudmanager aio-rde-plugin-troubleshooting-deprecatedcontext

Debido al historial de aio-cli-plugin-aem-rde, el nombre de contexto aio-cli-plugin-cloudmanager se utilizó durante algún tiempo. El complemento RDE ahora utiliza el método IMS para administrar la información de contexto, lo que le permite almacenar el contexto de forma global o local. También puede configurar un contexto predeterminado para que se aplique automáticamente a todas las llamadas de AIO. El contexto predeterminado configurado se almacena localmente y permite a los desarrolladores realizar un seguimiento y utilizar contextos individuales y su información dentro de una carpeta. Para obtener más información, lea el ejemplo anterior para configurar un contexto local.

Los desarrolladores que usan ambos complementos, aio-cli-plugin-cloudmanager y aio-cli-plugin-aem-rde y desean mantener toda la información en el mismo contexto, tienen dos opciones en este momento:

Seguir usando el contexto aio-cli-plugin-cloudmanager

El contexto aún se puede utilizar. Se muestra una advertencia de obsolescencia en el complemento RDE. Esta advertencia se puede omitir utilizando el modo --quiet. Las versiones más recientes del complemento RDE ya no ofrecen la alternativa de leer el contexto aio-cli-plugin-cloudmanager. Para seguir usándolo, simplemente configure el contexto predeterminado en aio-cli-plugin-cloudmanager. Consulte el ejemplo para configurar un contexto local más arriba.

Utilice también cualquier otro nombre de contexto para el complemento de Cloud Manager

Los complementos de Cloud Manager ofrecen un parámetro para definir el contexto que se va a utilizar. Todavía no admite la configuración de contexto predeterminada de IMS. Para ello, configure el complemento RDE con el ejemplo para configurar un contexto local e indique al complemento de Cloud Manager que use myContext como --imsContextName=myContext en cada llamada a él.