Ambienti di sviluppo rapidi rapid-development-environments

Per distribuire le modifiche, gli ambienti di sviluppo cloud attuali richiedono l’utilizzo di un processo che utilizza regole estese di qualità e sicurezza del codice, denominate pipeline CI/CD. Nelle situazioni in cui sono necessarie modifiche rapide e iterative, Adobe ha introdotto gli ambienti di sviluppo rapido (RDE, Rapid Development Environments).

Gli RDE consentono agli sviluppatori di implementare e rivedere rapidamente le modifiche, riducendo al minimo il tempo necessario per testare le funzioni che hanno dimostrato di funzionare in un ambiente di sviluppo locale.

Una volta testate in un RDE, le modifiche possono essere distribuite in un ambiente di sviluppo cloud regolare tramite la pipeline Cloud Manager.

Sono disponibili altri video che mostrano come configurarlo, come utilizzarlo e il ciclo di vita dello sviluppo utilizzando RDE.

Introduzione introduction

Gli RDE possono essere utilizzati per codice, contenuto e configurazioni Apache o Dispatcher. A differenza dei normali ambienti di sviluppo cloud, gli sviluppatori possono utilizzare strumenti della riga di comando locali per sincronizzare il codice generato localmente con un RDE.

A ogni programma viene fornito un RDE. Se sono presenti account Sandbox, vengono sospesi dopo alcune ore di non utilizzo.

Al momento della creazione, gli RDE sono impostati sulla versione di Adobe Experience Manager (AEM) più recente disponibile. Un ripristino RDE, che può essere eseguito utilizzando Cloud Manager, esegue un ciclo di tale ripristino e lo imposta sulla versione di AEM più recente disponibile.

In genere, un RDE viene utilizzato da un singolo sviluppatore in un determinato momento, per testare e eseguire il debug di una funzione specifica. Al termine della sessione di sviluppo, è possibile ripristinare lo stato predefinito dell’RDE per l’utilizzo successivo.

Ulteriori RDE possono essere concessi in licenza per programmi di produzione (non sandbox).

Abilitare RDE in un programma enabling-rde-in-a-program

Nella schermata Panoramica il nuovo ambiente viene ora visualizzato nella scheda Ambienti.

Al momento della creazione, gli RDE sono impostati sulla versione di AEM più recente disponibile. Un ripristino RDE, che può essere eseguito anche utilizzando Cloud Manager, esegue un ciclo di tale ripristino e lo imposta sulla versione di AEM più recente disponibile.

Per ulteriori informazioni sull'utilizzo di Cloud Manager per la creazione di ambienti, la gestione degli utenti che possono accedervi e l'assegnazione di domini personalizzati, vedere Programmi e tipi di programmi nella documentazione di Cloud Manager.

Installare gli strumenti della riga di comando RDE installing-the-rde-command-line-tools

Dopo aver aggiunto un RDE per il programma utilizzando Cloud Manager, è possibile interagire con esso impostando gli strumenti della riga di comando come descritto nei passaggi seguenti:

Configurazione interattiva installing-the-rde-command-line-tools-interactive

Il comando setup richiede se la configurazione fornita deve essere memorizzata localmente 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)

Scegli no per

Scegliere yes per effettuare le seguenti operazioni:

Una volta selezionata la configurazione locale o globale, il comando di configurazione tenta di leggere l’ID organizzazione dall’accesso corrente e quindi di leggere i programmi dell’organizzazione. Nel caso in cui l’organizzazione non possa essere trovata, puoi inserirla manualmente insieme ad alcune indicazioni.

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

Una volta recuperati i programmi, l’utente può selezionare dall’elenco e anche digitare per filtrare. Quando il programma è selezionato, viene elencato un elenco di ambienti RDE tra cui scegliere. Se è disponibile un solo programma, un solo ambiente RDE o entrambi, viene selezionato automaticamente.

Per visualizzare il contesto dell’ambiente corrente, esegui le seguenti operazioni:

aio aem rde setup --show

Il comando risponde con un risultato simile al seguente:

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

Procedura di configurazione manuale in un ambiente non interattivo manual-setup

Negli ambienti in cui nessun utente può eseguire il comando di installazione in modo interattivo (ad esempio CI/CD o script), è necessaria la configurazione manuale. Puoi impostare i parametri di organizzazione, programma e ambiente seguendo la procedura riportata di seguito.

Utilizzare RDE durante lo sviluppo di una nuova funzione using-rde-while-developing-a-new-feature

Adobe consiglia di utilizzare il seguente flusso di lavoro per sviluppare una nuova funzione:

Utilizzare RDE per eseguire il debug di una funzionalità esistente use-rde-to-debug-an-existing-feature

Il flusso di lavoro è simile allo sviluppo di una nuova funzione. La differenza è che il codice sincronizzato in RDE riflette l’etichetta Git di ciò che è stato inviato all’ambiente in cui si è verificato il problema. Questo flusso di lavoro garantisce coerenza durante l’analisi o la riproduzione del problema. Inoltre, può essere utile distribuire contenuti corrispondenti all’ambiente a monte. Questo approccio può essere ottenuto esportando e importando pacchetti di contenuti.

Più sviluppatori che collaborano allo stesso RDE multiple-developers-collaborating-on-the-same-rde

Un RDE supporta un singolo progetto alla volta. Poiché il codice viene sincronizzato da un ambiente di sviluppo locale all’ambiente RDE, è più naturale per uno sviluppatore utilizzarlo da solo in un determinato momento.

Tuttavia, con un’attenta coordinazione, è possibile per più sviluppatori convalidare una funzione specifica o eseguire il debug di un problema specifico. La chiave è che ogni sviluppatore mantiene sincronizzati i propri progetti locali in modo che le modifiche del codice apportate da un particolare sviluppatore vengano assorbite dagli altri sviluppatori. In caso contrario, uno sviluppatore potrebbe inavvertitamente sovrascrivere il codice dell’altro. La strategia consigliata è che ogni sviluppatore esegua il commit delle modifiche in un ramo Git condiviso prima di eseguire la sincronizzazione con l’RDE, in modo che gli altri sviluppatori possano richiamare le modifiche prima di apportare le proprie.

Strumenti della riga di comando RDE Comandi rde-cli-commands

Guida/Informazioni generali help

Flag globali global-flags

Distribuisci su RDE deploying-to-rde

Questa sezione spiega come utilizzare RDE CLI per distribuire, installare o aggiornare varie risorse. Queste risorse includono:

Il modello di utilizzo generale è aio aem:rde:install <artifact>.

Di seguito sono riportati alcuni esempi:

Distribuire un pacchetto di contenuti deploy-content-package

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

La risposta per una distribuzione corretta è simile alla seguente:

...
#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

Facoltativamente, puoi fare riferimento a un archivio 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"

Per impostazione predefinita, gli artefatti vengono distribuiti sia sul livello di authoring che su quello di pubblicazione, ma è possibile utilizzare il flag -s per impostare come destinazione un livello specifico.

Qualsiasi pacchetto AEM può essere distribuito, ad esempio pacchetti con codice, contenuto o un pacchetto contenitore (detto anche pacchetto "all").

Distribuire una configurazione OSGI deploy-OSGI-config

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

In cui la risposta per una distribuzione corretta è simile alla seguente:

...
#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

Distribuire un bundle deploy-bundle

Per distribuire un bundle, utilizza:

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

In cui la risposta per una distribuzione corretta è simile alla seguente:

...
#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

Distribuire un file di contenuto deploy-content-file

Per distribuire un file di contenuto, utilizza:

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

In cui la risposta per una distribuzione corretta è simile alla seguente:

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

Distribuire una configurazione Apache/Dispatcher deploy-apache-config

Per questo tipo di configurazione, l’intera struttura di cartelle deve essere sotto forma di un file zip.

Dal modulo dispatcher di un progetto AEM, puoi comprimere la configurazione Dispatcher eseguendo il seguente comando maven:

mvn clean package

Oppure utilizzando il comando zip seguente dalla directory src del modulo dispatcher:

zip -y -r dispatcher.zip .

Quindi distribuisci la configurazione con questo comando:

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

Una distribuzione corretta genera una risposta simile alla seguente:

..
#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

Il codice distribuito in RDE non viene sottoposto a una pipeline Cloud Manager e ai relativi gate di qualità associati. Tuttavia, il codice viene sottoposto ad alcune analisi che segnalano gli errori, come illustrato nell’esempio di codice seguente:

$ 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.

L’esempio di codice riportato sopra illustra il comportamento se un bundle non si risolve. In questo caso, è "staging" e viene installato solo se i suoi requisiti (importazioni mancanti, in questo caso) sono soddisfatti tramite l'installazione di un altro codice.

Implementa configurazione relativa alla pipeline di configurazione (configurazioni yaml) deploy-config-pipeline

Le configurazioni specifiche dell'ambiente (uno o più file yaml) descritte nell'articolo Utilizzo delle pipeline di configurazione possono essere distribuite come segue:

aio aem:rde:install -t env-config ./my-config-folder
Dove my-config-folder è la cartella principale contenente le configurazioni yaml.

In alternativa, è possibile installare un file zip contenente la struttura della cartella di configurazione:

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

Si noti che la matrice envTypes del file yaml include il valore rde, come nell'esempio seguente:

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

Distribuire il codice front-end in base ai temi e ai modelli del sito deploying-themes-to-rde

Gli RDE supportano il codice front-end creato con temi e modelli del sito. Invece di utilizzare la pipeline front-end di Cloud Manager come altri tipi di ambiente, gli RDE distribuiscono pacchetti front-end utilizzando una direttiva della riga di comando.

Come sempre, crea il pacchetto front-end utilizzando npm:

npm run build

Genera una cartella dist/, quindi la cartella del pacchetto front-end contiene un file package.json e una cartella dist:

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

Ora puoi distribuire il pacchetto front-end nell’RDE puntando alla cartella del pacchetto front-end nel modo seguente:

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

In alternativa, è possibile comprimere il file package.json e la cartella dist e distribuire il file 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

Controllare lo stato della RDE checking-rde-status

È possibile utilizzare RDE CLI per verificare se l’ambiente è pronto per essere distribuito in, in quanto tramite il plug-in RDE sono state effettuate delle distribuzioni.

Esecuzione di quanto segue:

aio aem:rde:status

Restituisce con quanto segue:

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

Se il comando restituisce una nota sulla distribuzione delle istanze, è comunque possibile procedere ed eseguire l'aggiornamento successivo, ma l'ultimo potrebbe non essere ancora visibile nell'istanza.

Mostra cronologia di distribuzione show-deployment-history

Puoi controllare la cronologia delle distribuzioni effettuate nell’RDE eseguendo:

aio aem:rde:history

Che restituisce una risposta sotto forma di:

#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

Elimina da RDE deleting-from-rde

È possibile utilizzare gli strumenti CLI per eliminare le configurazioni e i bundle distribuiti in precedenza nell'RDE. Utilizzare il comando status per un elenco degli elementi che è possibile eliminare, che include bsn per i bundle e pid per le configurazioni a cui fare riferimento nel comando delete.

Ad esempio, se com.adobe.granite.demo.MyServlet.cfg.json è stato installato, bsn è solo com.adobe.granite.demo.MyServlet, senza il suffisso cfg.json.

L'eliminazione di pacchetti di contenuti o file di contenuti non è supportata. Per rimuoverli, reimpostare l'RDE e riportarlo allo stato predefinito.

Per ulteriori informazioni, consulta l’esempio seguente:

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

Per ulteriori informazioni e dimostrazioni, vedere l'esercitazione video utilizzo dei comandi RDE (10:01).

Distribuire in un RDE da provider Git esterni deploy-to-rde

Cloud Manager supporta la distribuzione di codice in un RDE direttamente da provider Git esterni quando si utilizza la configurazione Bring Your Own Git (BYOG).

La distribuzione degli RDE da un archivio Git esterno richiede quanto segue:

Note sull'utilizzo

Come funziona

Registri rde-logging

Analogamente ad altri tipi di ambiente, i livelli di registro possono essere impostati modificando le configurazioni OSGi, anche se, come descritto in precedenza, il modello di distribuzione per gli RDE prevede una riga di comando anziché una distribuzione Cloud Manager. Per ulteriori informazioni su come visualizzare, scaricare e interpretare i registri, consulta la documentazione di registrazione.

RDE CLI dispone inoltre di un proprio comando di registro utilizzato per configurare rapidamente le classi e i pacchetti registrati e a quale livello di registro. Queste configurazioni possono essere visualizzate come temporanee, in quanto non modificano le proprietà OSGI nel controllo della versione. Questa funzione si concentra sulla suddivisione dei registri in tempo reale, anziché cercare registri di un passato remoto.

L’esempio seguente illustra come visualizzare il livello di authoring, con un pacchetto impostato su un livello di registro di debug e due pacchetti (separati da spazi) impostati su un livello di debug di informazioni. L'output che include un pacchetto auth è evidenziato.

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

Vedere aio aem:rde:logs --help per l'insieme completo delle opzioni della riga di comando.

Le caratteristiche includono:

Si noti che i registri vengono memorizzati in memoria sull'RDE e che tali registri vengono riciclati e quindi eliminati se non sono in coda o se la rete è troppo lenta.

Reimposta RDE reset-rde

Se si ripristina la RDE, verranno rimossi dalle istanze di authoring e di pubblicazione tutto il codice personalizzato, le configurazioni e il contenuto. Il ripristino dell'RDE è utile quando avete terminato il test di una feature e desiderate ripristinare lo stato predefinito dell'ambiente prima di testarne un'altra.

Una reimpostazione imposta l’RDE sulla versione di AEM più recente disponibile.

È possibile reimpostare la RDE utilizzando Cloud Manager o la riga di comando. Il ripristino richiede alcuni minuti e tutto il contenuto e il codice esistenti viene eliminato dall’RDE.

Reimpostare l'RDE utilizzando la riga di comando reset-the-rde-command-line

È possibile ripristinare l'RDE e riportarlo allo stato predefinito eseguendo le operazioni seguenti:

aio aem:rde:reset

Questo processo in genere richiede alcuni minuti e segnala Environment reset. in caso di esito positivo o Failed to reset the environment. in caso di errori. Per un output strutturato, vedere il capitolo sull'output --json riportato di seguito.

Utilizza il comando status per verificare quando l'ambiente è nuovamente pronto.

Reimpostare l'RDE in Cloud Manager reset-the-rde-cloud-manager

È possibile utilizzare Cloud Manager per reimpostare la RDE seguendo la procedura riportata di seguito:

Dopo l’avvio del ripristino RDE, in genere sono necessari alcuni minuti per completare e ripristinare lo stato predefinito dell’ambiente. Puoi visualizzare lo stato di ripristino in qualsiasi momento nella colonna Stato della scheda o della finestra Ambienti.

Puoi anche reimpostare l'RDE utilizzando il pulsante con i puntini di sospensione direttamente dalla scheda Ambienti nella pagina Panoramica.

Per ulteriori informazioni su come utilizzare Cloud Manager per gestire gli ambienti, consulta la documentazione di Cloud Manager.

Comandi che supportano l’output JSON json-commands

La maggior parte dei comandi supporta il flag globale --json che sopprime l'output della console e restituisce un JSON valido da elaborare negli script. Di seguito sono riportati alcuni comandi supportati, con esempi dell’output json.

Stato 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"
        }
      }
    ]
  }
}

Installa 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."
      ]
    }
  ]
}

Elimina 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."
      ]
    }
  ]
}

Cronologia 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"
    }
  ]
}

Ripristina reset

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

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

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

Riavvia restart

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

Modalità di esecuzione runmodes

La configurazione OSGI specifica per RDE può essere applicata utilizzando i suffissi sul nome della cartella, come negli esempi seguenti:

Per informazioni generali sulle modalità di esecuzione, vedere la documentazione sulle modalità di esecuzione.

Gli RDE sono distinti da altri ambienti in quanto il contenuto può essere installato in una cartella install.rde (o install.author.rde o install.publish.rde) in /apps. Questa funzionalità consente di eseguire il commit del contenuto in Git e distribuirlo all’RDE utilizzando gli strumenti della riga di comando.

Popola con contenuto populating-content

Quando un RDE viene reimpostato, tutto il contenuto viene rimosso e quindi, se desiderato, è necessario eseguire un’azione esplicita per aggiungere contenuto. Come best practice, è consigliabile assemblare un set di contenuti da utilizzare come contenuti di prova per convalidare o eseguire il debug delle funzioni nell’RDE. Esistono diverse strategie possibili per popolare l’RDE con tale contenuto:

Il limite è di 1 GB per la sincronizzazione dei pacchetti di contenuti.

Quali sono le differenze tra gli RDE e gli ambienti di sviluppo cloud? how-are-rds-different-from-cloud-development-environments

Sebbene l’RDE sia per molti aspetti simile a un ambiente di sviluppo cloud, esistono alcune lievi differenze a livello di architettura per consentire una rapida sincronizzazione del codice. Il meccanismo per ottenere il codice da RDE è diverso: per gli RDE, si sincronizza il codice da un ambiente di sviluppo locale, mentre per gli ambienti di sviluppo cloud, si distribuisce il codice tramite Cloud Manager.

Per questi motivi, si consiglia di distribuire il codice in un ambiente di sviluppo cloud utilizzando la pipeline non di produzione dopo aver convalidato il codice in un ambiente RDE. Infine, verifica il codice prima di distribuirlo con la pipeline di produzione.

Inoltre, tieni presente le seguenti considerazioni:

Di quante RDE ho bisogno? how-many-rds-do-i-need

È disponibile un RDE per ogni soluzione concessa in licenza e Adobe offre anche RDE aggiuntivi che possono essere concessi in licenza per programmi di produzione (non sandbox).

Il numero di RDE necessari dipende dalla composizione e dai processi di un’organizzazione. Il modello più flessibile è quello in cui un’organizzazione acquista un RDE dedicato per ciascuno dei propri sviluppatori AEM Cloud Service. In questo modello, ogni sviluppatore può testare il proprio codice sull’RDE senza coordinarsi con gli altri membri del gruppo sulla disponibilità di un ambiente RDE.

All’altro estremo, un team con un solo RDE può fare affidamento sul coordinamento interno per decidere quale sviluppatore utilizza l’ambiente in un dato momento. Questo approccio funziona bene quando uno sviluppatore raggiunge una feature milestone e deve convalidare il proprio lavoro in un ambiente Cloud con la flessibilità di apportare modifiche rapide.

Un modello intermedio è un modello in cui un’organizzazione acquista diversi RDE, pertanto vi è una maggiore probabilità che sia disponibile un RDE inutilizzato. Una strategia potrebbe essere quella di allocare un RDE per team di scrum o per una funzione importante. I processi interni possono essere utilizzati per coordinare l’utilizzo degli ambienti.

Quali sono le differenze tra AEM Forms Cloud Service RDE e altri ambienti? how-are-forms-rds-different-from-cloud-development-environments

Gli sviluppatori Forms possono utilizzare AEM Forms Cloud Service Rapid Development Environment per sviluppare rapidamente Forms adattivo, flussi di lavoro e personalizzazioni quali la personalizzazione di componenti core, integrazioni con sistemi di terze parti e altro ancora. AEM Forms Cloud Service Rapid Development Environment (RDE) non supporta le API di comunicazione. Inoltre, non supporta funzioni e funzionalità che richiedono documenti di record, come la generazione di un documento di record all’invio di un modulo adattivo. Le seguenti funzioni di AEM Forms non sono disponibili in un ambiente di sviluppo rapido (RDE):

Esercitazione RDE

Per informazioni su RDE in AEM as a Cloud Service, consulta l'esercitazione video che illustra come configurarlo, come utilizzarlo e il ciclo di vita dello sviluppo (01:25).

Risoluzione dei problemi troubleshooting

Risoluzione dei problemi relativi a RDE (#rde-troublehooting)

Come ottenere la versione più recente di AEM per un RDE esistente get-latest-aem-version

Al momento della creazione, gli RDE sono impostati sulla versione di Adobe Experience Manager (AEM) più recente disponibile. Un ripristino RDE, che può essere eseguito utilizzando Cloud Manager o il comando aio aem:rde:reset, esegue un ciclo RDE e lo imposta sulla versione di AEM più recente disponibile.

Risolvere i problemi relativi al plug-in di aio RDE aio-rde-plugin-troubleshooting

Errori relativi ad autorizzazioni insufficienti insufficient-permissions

Per utilizzare il plug-in RDE, è necessario essere membri del profilo di prodotto Cloud Manager Developer - Cloud Service. Per ulteriori dettagli, vedere Assegnazione dei membri del gruppo ai profili di prodotto di Cloud Manager - Assegnazione del profilo di prodotto sviluppatore.

In alternativa, puoi confermare di disporre di questo ruolo di sviluppatore se accedi alla console per sviluppatori eseguendo il seguente comando:

aio cloudmanager:environment:open-developer-console

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

Verifica che l’accesso sia stato completato correttamente eseguendo quanto segue:

aio cloudmanager:list-programs

Questo processo elenca tutti i programmi dell’organizzazione configurata e conferma che il ruolo assegnato è corretto.

Usa contesto obsoleto aio-cli-plugin-cloudmanager aio-rde-plugin-troubleshooting-deprecatedcontext

A causa della cronologia di aio-cli-plugin-aem-rde, il nome di contesto aio-cli-plugin-cloudmanager è stato utilizzato per qualche tempo. Il plug-in RDE ora utilizza il metodo IMS per gestire le informazioni di contesto, consentendo di memorizzare il contesto a livello globale o locale. È inoltre possibile configurare un contesto predefinito da applicare automaticamente a tutte le chiamate AIO. Il contesto predefinito configurato viene memorizzato localmente e consente agli sviluppatori di tenere traccia e utilizzare singoli contesti e le relative informazioni all'interno di una cartella. Per ulteriori dettagli, leggere l'esempio per impostare un contesto locale sopra.

Gli sviluppatori che utilizzano entrambi i plug-in, aio-cli-plugin-cloudmanager e aio-cli-plugin-aem-rde e desiderano conservare tutte le informazioni nello stesso contesto devono ora scegliere tra le seguenti opzioni:

Continua a utilizzare il contesto aio-cli-plugin-cloudmanager

Il contesto può ancora essere utilizzato. Nel plug-in RDE viene visualizzato un avviso di elementi obsoleti. Questo avviso può essere omesso utilizzando la modalità --quiet. Versioni più recenti del plug-in RDE non offrono più il fallback per la lettura del contesto aio-cli-plugin-cloudmanager. Per continuare a utilizzarlo, configurare il contesto predefinito su aio-cli-plugin-cloudmanager. Vedi l'esempio per configurare un contesto locale sopra.

Usa qualsiasi altro nome di contesto anche per il plug-in Cloud Manager

I plug-in di Cloud Manager offrono un parametro per definire un contesto da utilizzare. Al momento non supporta la configurazione del contesto predefinita di IMS. Per eseguire questa operazione, configurare il plug-in RDE utilizzando l'esempio per impostare un contesto locale e indicare al plug-in Cloud Manager di utilizzare myContext come --imsContextName=myContext in ogni chiamata.