Snabba utvecklingsmiljöer rapid-development-environments

För att kunna driftsätta ändringar kräver de aktuella utvecklingsmiljöerna i molnet en process som använder omfattande kodsäkerhet och kvalitetsregler som kallas CI/CD-pipeline. I situationer där snabba och iterativa förändringar behövs har Adobe infört snabba utvecklingsmiljöer (RDE) för kort tid.

Med RDE-teknik kan utvecklare snabbt driftsätta och granska ändringar, vilket minimerar den tid som krävs för att testa funktioner som är beprövade i en lokal utvecklingsmiljö.

När ändringarna har testats i en RDE kan de distribueras till en vanlig Cloud Development-miljö via Cloud Manager pipeline.

Du kan se ytterligare videofilmer som visar hur du konfigurerar den, hur du använder den och utvecklingscykeln med hjälp av RDE.

Introduktion introduction

RDE kan användas för kod, innehåll och Apache- eller Dispatcher-konfigurationer. Till skillnad från vanliga Cloud Development-miljöer kan utvecklare använda lokala kommandoradsverktyg för att synkronisera kod som skapats lokalt till en RDE.

Alla program tillhandahålls med en RDE. Om det finns sandlådekonton är de i viloläge efter några timmars icke-användning.

När de skapas ställs de lokala utvecklingsmiljöerna in på den senast tillgängliga Adobe Experience Manager-versionen (AEM). En RDE-återställning, som kan utföras med Cloud Manager, går igenom RDE-filen och ställer in den på den senast tillgängliga AEM-versionen.

Vanligtvis används en RDE av en enskild utvecklare vid en viss tidpunkt för att testa och felsöka en viss funktion. När utvecklingssessionen är klar kan den återställas till ett standardläge för nästa användning.

Ytterligare RDE kan licensieras för produktionsprogram (ej sandlådeprogram).

Aktivera RDE i ett program enabling-rde-in-a-program

Skärmen Översikt visar nu din nya miljö på kortet Miljöer.

När de skapas ställs de lokala versionerna in på den senast tillgängliga AEM-versionen. En RDE-återställning, som även kan utföras med Cloud Manager, går igenom RDE-filen och ställer in den på den senast tillgängliga AEM-versionen.

Mer information om hur du använder Cloud Manager för att skapa miljöer, hantera vem som har åtkomst till dem och tilldela anpassade domäner finns i Program och programtyper i Cloud Manager-dokumentationen.

Installera kommandoradsverktygen för RDE installing-the-rde-command-line-tools

När du har lagt till en RDE för programmet med Cloud Manager kan du interagera med den genom att konfigurera kommandoradsverktygen enligt följande steg:

Interaktiv inställning installing-the-rde-command-line-tools-interactive

Installationskommandot frågar om den angivna konfigurationen ska lagras lokalt eller globalt.

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)

Välj no att

Välj yes om du vill göra följande:

När en lokal eller global konfiguration har valts försöker kommandot setup att läsa ditt organisations-ID från din aktuella inloggning och sedan läsa organisationens program. Om det inte går att hitta organisationen kan du ange den manuellt tillsammans med lite vägledning.

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

När programmen har hämtats kan användaren välja i listan och även ange vilken typ som ska filtreras. När programmet är valt visas en lista med de RDE-miljöer du kan välja mellan. Om det bara finns ett program, eller bara en tillgänglig RDE-miljö, eller båda, väljs den automatiskt.

Om du vill se den aktuella miljökontexten kör du följande:

aio aem rde setup --show

Kommandot svarar med ett resultat som liknar följande:

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

Manuell konfigurationsprocedur i en icke-interaktiv miljö manual-setup

I miljöer där ingen användare interaktivt kan köra installationskommandot (till exempel CI/CD eller skript) krävs manuell konfiguration. Du kan ställa in parametrarna för organisation, program och miljö enligt stegen nedan.

Använd RDE när du utvecklar en ny funktion using-rde-while-developing-a-new-feature

Adobe rekommenderar följande arbetsflöde för att utveckla en ny funktion:

Felsöka en befintlig funktion med RDE use-rde-to-debug-an-existing-feature

Arbetsflödet liknar utvecklingen av en ny funktion. Skillnaden är att koden som synkroniseras med RDE återspeglar Git-etiketten för det som skickades till miljön där problemet uppstod. Det här arbetsflödet säkerställer konsekvens när du undersöker eller återskapar ett problem. Dessutom kan det vara användbart att distribuera innehåll som matchar den överordnade miljön. Detta kan uppnås genom export och import av innehållspaket.

Flera utvecklare som samarbetar med samma utvecklingsmiljö multiple-developers-collaborating-on-the-same-rde

En RDE har stöd för ett enda projekt i taget. Eftersom kod synkroniseras från en lokal utvecklingsmiljö till en RDE-miljö är det mest naturligt för en utvecklare att använda den fristående vid en viss tidpunkt.

Med noggrann samordning kan dock fler än en utvecklare validera en viss funktion eller felsöka ett specifikt problem. Nyckeln är att varje utvecklare håller sina lokala projekt synkroniserade så att kodändringar som gjorts av en viss utvecklare tas upp av de andra utvecklarna. I annat fall kan en utvecklare oavsiktligt skriva över den andres kod. Den rekommenderade strategin är att alla utvecklare implementerar sina ändringar i en delad Git-gren innan de synkroniserar till den lokala utvecklingsmiljön, så att de andra utvecklarna drar in ändringarna innan de gör sina egna ändringar.

Kommandoradsverktyg för RDE rde-cli-commands

Hjälp/Allmän information help

Globala flaggor global-flags

Distribuera till RDE deploying-to-rde

I det här avsnittet beskrivs hur du använder RDE CLI för att distribuera, installera eller uppdatera olika resurser. Följande resurser ingår:

Det allmänna användningsmönstret är aio aem:rde:install <artifact>.

Här följer några exempel:

Distribuera ett innehållspaket deploy-content-package

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

Svaret för en lyckad distribution liknar följande:

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

Du kan även referera till en fjärrdatabas:

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"

Som standard distribueras artefakter till både författar- och publiceringsnivåer, men flaggan -s kan användas för att ange ett specifikt skikt som mål.

Alla AEM-paket kan distribueras, till exempel paket med kod, innehåll eller ett behållarpaket (kallas även"alla"-paket).

Distribuera en OSGI-konfiguration deploy-OSGI-config

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

Där svaret för en lyckad distribution liknar följande:

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

Distribuera ett paket deploy-bundle

Använd följande för att distribuera ett paket:

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

Där svaret för en lyckad distribution liknar följande:

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

Distribuera en innehållsfil deploy-content-file

Använd följande för att distribuera en innehållsfil:

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

Där svaret för en lyckad distribution liknar följande:

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

Distribuera en Apache/Dispatcher-konfiguration deploy-apache-config

Hela mappstrukturen måste vara i form av en ZIP-fil för den här typen av konfiguration.

Från modulen dispatcher i ett AEM-projekt kan du zippa upp Dispatcher-konfigurationen genom att köra kommandot nedan:

mvn clean package

Eller använd zip-kommandot nedan från katalogen src i modulen dispatcher:

zip -y -r dispatcher.zip .

Distribuera sedan konfigurationen med det här kommandot:

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

En lyckad distribution genererar ett svar som liknar följande:

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

Kod som distribueras till RDE genomgår inte någon Cloud Manager-pipeline och tillhörande kvalitetsportar. Koden går dock igenom en del analyser som rapporterar felen, vilket visas i kodexemplet nedan:

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

Kodexemplet ovan visar beteendet om ett paket inte löses. I så fall"mellanlagras" den och installeras endast om dess krav (i detta fall"import som saknas") uppfylls genom installation av annan kod.

Distribuera konfiguration relaterad till konfigurationspipeline (yaml-konfigurationer) deploy-config-pipeline

De miljöspecifika konfigurationer (en eller flera dynamiska filer) som beskrivs i artikeln Använda konfigurationsförlopp kan distribueras enligt följande:

aio aem:rde:install -t env-config ./my-config-folder
Där my-config-folder är den överordnade mappen som innehåller dina bildkonfigurationer.

Du kan också installera en ZIP-fil som innehåller config-mappträdet:

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

Observera att namnfilens envTypes-matris innehåller värdet rde, som i exemplet nedan:

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

Distribuera startkod baserat på webbplatsteman och webbplatsmallar deploying-themes-to-rde

De lokala redigeringssystemen har stöd för frontendkod som skapats med webbplatsteman och webbplatsmallar. I stället för att använda Cloud Manager Front-End Pipeline som andra miljötyper distribuerar RDE-enheter klientpaket med ett kommandoradsdirektiv.

Som vanligt kan du bygga ditt front end-paket med npm:

npm run build

Den genererar en dist/-mapp, så den främre paketmappen innehåller en package.json-fil och en dist-mapp:

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

Nu är du redo att distribuera paketet till den lokala utvecklingsmiljön genom att peka på paketmappen i serverdelen på följande sätt:

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

Du kan också komprimera filen package.json och mappen dist och distribuera zip-filen:

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

Kontrollera RDE-status checking-rde-status

Du kan använda RDE CLI för att kontrollera om miljön är klar att distribueras till, som vilka distributioner som har gjorts via RDE-pluginen.

Kör följande:

aio aem:rde:status

Returnerar med följande:

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

Om kommandot returnerar en anteckning om instanser som distribueras kan du fortsätta och utföra nästa uppdatering, men den senaste uppdateringen kanske inte visas på instansen än.

Visa distributionshistorik show-deployment-history

Du kan kontrollera historiken för distributioner som gjorts till RDE genom att köra:

aio aem:rde:history

som returnerar ett svar i form av:

#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

Ta bort från RDE deleting-from-rde

Du kan använda CLI-verktygen för att ta bort konfigurationer och paket som du tidigare distribuerat till RDE. Använd kommandot status om du vill se en lista över vad som kan tas bort, som innehåller bsn för paket och pid om det finns konfigurationer att referera till i kommandot delete.

Om till exempel com.adobe.granite.demo.MyServlet.cfg.json har installerats är bsn bara com.adobe.granite.demo.MyServlet, utan suffixet cfg.json.

Det går inte att ta bort innehållspaket eller innehållsfiler. Om du vill ta bort dem återställer du den lokala lagringsplatsen, som återgår till standardläget.

Se exemplet nedan för mer information:

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

Mer information och demonstration finns i videosjälvstudien om hur du använder RDE-kommandon (10:01).

Distribuera till en RDE från externa Git-leverantörer deploy-to-rde

Cloud Manager har stöd för att distribuera kod till en RDE direkt från externa Git-leverantörer när du använder BYOG-konfigurationen Bring Your Own Git (BYOG).

Distribuering till RDE från en extern Git-databas kräver följande:

Användningsinformation

Så här fungerar det

Loggar rde-logging

På samma sätt som för andra miljötyper kan loggnivåer ställas in genom att OSGi-konfigurationer ändras, även om distributionsmodellen för RDE-konfigurationer enligt beskrivningen ovan inbegriper en kommandorad i stället för en Cloud Manager-distribution. Mer information om hur du visar, hämtar och tolkar loggar finns i loggningsdokumentationen.

RDE CLI har också ett eget loggkommando som används för att snabbt konfigurera vilka klasser och paket som ska loggas och på vilken loggnivå. Dessa konfigurationer kan betraktas som tillfälliga eftersom de inte ändrar OSGI-egenskaperna i versionskontrollen. Den här funktionen fokuserar på att skräddarsy loggar i realtid, i stället för att leta efter loggar från det avlägsna förflutna.

I följande exempel visas hur du finjusterar författarnivån, med ett paket inställt på en felsökningsloggnivå, och två paket (avgränsade med blanksteg) inställda på en informationsfelsökningsnivå. Utdata som innehåller ett auth-paket är markerade.

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

Mer information om alla kommandoradsalternativ finns i aio aem:rde:logs --help.

Funktionerna är följande:

Observera att loggar lagras i minnet på den lokala lagringsplatsen och att dessa loggar återvinns och därmed tas bort om de inte är skräddarsydda eller om nätverket är för långsamt.

Återställ RDE reset-rde

Om du återställer RDE tas all anpassad kod, konfigurationer och innehåll bort från både författaren och publiceringsinstansen. Det kan vara bra att återställa RDE när du har testat en funktion och vill återställa miljön till standardläge innan du testar en annan.

En återställning ställer in RDE till den senast tillgängliga AEM-versionen.

Du kan återställa RDE med antingen Cloud Manager eller kommandoraden. Återställningen tar några minuter och allt befintligt innehåll och all befintlig kod tas bort från den lokala utvecklingsmiljön.

Återställ RDE med kommandoraden reset-the-rde-command-line

Du kan återställa RDE och återställa det till standardläge genom att köra följande:

aio aem:rde:reset

Den här processen tar vanligtvis några minuter och rapporterar Environment reset. när den lyckades eller Failed to reset the environment. om fel. För strukturerade utdata, se kapitlet om --json-utdata nedan.

Använd statuskommandot för att kontrollera när miljön är klar igen.

Återställ RDE i Cloud Manager reset-the-rde-cloud-manager

Du kan använda Cloud Manager för att återställa din RDE genom att följa stegen nedan:

När återställningen av RDE startar tar det oftast några minuter att slutföra och återställa miljön till standardläget. Du kan när som helst visa återställningsstatusen i kolumnen Status på kortet eller i fönstret Miljöer.

Du kan också återställa den lokala lagringsplatsen med hjälp av ellipsknappen direkt från kortet Miljöer på sidan Översikt.

Mer information om hur du använder Cloud Manager för att hantera miljöer finns i Cloud Manager-dokumentationen.

Kommandon som stöder JSON-utdata json-commands

De flesta kommandon har stöd för den globala flaggan --json som undertrycker konsolutdata och returnerar giltig json som ska bearbetas i skript. Nedan finns några kommandon som stöds, med exempel på json-utdata.

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

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

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

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

Återställ reset

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

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

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

Starta om restart

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

Körningslägen runmodes

RDE-specifik OSGI-konfiguration kan tillämpas med hjälp av suffix i mappnamnet, som i exemplen nedan:

Mer information om körningslägen finns i dokumentationen för körningsläge.

De lokala lagringsplatserna skiljer sig från andra miljöer där innehållet kan installeras i en install.rde-mapp (eller install.author.rde eller install.publish.rde) under /apps. På så sätt kan du implementera innehåll i Git och leverera det till RDE med hjälp av kommandoradsverktygen.

Fyll med innehåll populating-content

När en RDE återställs tas allt innehåll bort, och om så önskas måste en explicit åtgärd vidtas för att lägga till innehåll. Ett tips är att du bör överväga att sätta ihop en uppsättning innehåll som ska användas som testinnehåll för validering och felsökning i den lokala redigeringsmiljön. Det finns flera möjliga strategier för att fylla i den regionala utvecklingsmiljön med det innehållet:

Du är begränsad till 1 GB när du synkroniserar innehållspaket.

På vilket sätt skiljer sig de regionala utvecklingsmiljöerna från molnutvecklingsmiljöer? how-are-rds-different-from-cloud-development-environments

Även om RDE på många sätt liknar en utvecklingsmiljö i molnet finns det vissa mindre arkitektoniska skillnader som gör det möjligt att snabbt synkronisera kod. Mekanismen för att hämta kod till RDE skiljer sig åt - för RDE synkroniserar en kod från en lokal utvecklingsmiljö, medan en för Cloud Development-miljöer distribuerar kod via Cloud Manager.

Därför rekommenderar vi att du distribuerar koden till en Cloud Development-miljö via icke-produktionsflödet när du har validerat koden i en RDE-miljö. Testa slutligen koden innan du distribuerar med produktionsflödet.

Observera även följande:

Hur många skrivbord behöver jag? how-many-rds-do-i-need

Det finns en RDE för varje licensierad lösning och Adobe erbjuder även ytterligare RDE som kan licensieras för Production-program (ej sandlådeprogram).

Hur många skrivbord som behövs beror på en organisations sammansättning och processer. Den mest flexibla modellen är när en organisation köper en dedikerad RDE för var och en av sina utvecklare av AEM Cloud-tjänster. I den här modellen kan varje utvecklare testa sin kod på den lokala utvecklingsmiljön utan att samordna med andra gruppmedlemmar om huruvida en RDE-miljö är tillgänglig.

Å andra sidan kan ett team med bara en utvecklingsmiljö vara beroende av intern samordning för att avgöra vilken utvecklingsmiljö som används vid en viss tidpunkt. Det här arbetssättet fungerar bra när en utvecklare når en milstolpe och behöver validera sitt arbete i en molnmiljö med flexibiliteten att göra snabba ändringar.

En mellanliggande modell är en modell där en organisation köper flera olika lagringssystem, vilket innebär att det är större sannolikhet att det finns en oanvänd lagringsbar dataström tillgänglig. En strategi kan vara att tilldela en RDE per team eller större funktion. Interna processer kan användas för att samordna användningen av miljöerna.

Hur skiljer sig AEM Forms Cloud Service RDE från andra miljöer? how-are-forms-rds-different-from-cloud-development-environments

Forms-utvecklare kan använda AEM Forms Cloud Service Rapid Development Environment för att snabbt utveckla adaptiva Forms, arbetsflöden och anpassningar som att anpassa kärnkomponenter, integreringar med tredjepartssystem med mera. AEM Forms Cloud Service Rapid Development Environment (RDE) saknar stöd för kommunikations-API:er. Den har inte heller stöd för funktioner som kräver en dokumentfil, som att generera en dokumentfil när en anpassad blankett skickas in. Följande AEM Forms-funktioner är inte tillgängliga i en Rapid Development Environment (RDE):

RDE, genomgång

Om du vill veta mer om RDE i AEM as a Cloud Service kan du titta i videosjälvstudiekursen som demonstrerar hur du konfigurerar den, hur du använder den och utvecklingscykeln (01:25).

Felsökning troubleshooting

Felsök RDE (#rde-troublehooting)

Så här skaffar du den senaste AEM-versionen för en befintlig RDE get-latest-aem-version

När de skapas ställs de lokala utvecklingsmiljöerna in på den senast tillgängliga Adobe Experience Manager-versionen (AEM). En RDE-återställning, som kan utföras med Cloud Manager eller kommandot aio aem:rde:reset, går igenom RDE-filen och anger den senaste tillgängliga AEM-versionen.

Felsök plugin-programmet för AIO RDE aio-rde-plugin-troubleshooting

Fel som rör otillräcklig behörighet insufficient-permissions

Om du vill använda RDE-plugin-programmet måste du vara medlem i Cloud Manager Developer - Cloud Service produktprofil. Mer information finns i Tilldela teammedlemmar till Cloud Manager produktprofiler - Tilldela produktprofilen för utvecklare.

Du kan också bekräfta att du har den här utvecklarrollen om du loggar in på utvecklarkonsolen genom att köra följande kommando:

aio cloudmanager:environment:open-developer-console

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

Kontrollera att inloggningen har slutförts genom att köra följande:

aio cloudmanager:list-programs

Den här processen listar alla program i din konfigurerade organisation och bekräftar att du har tilldelats rätt roll.

Använd föråldrad kontext aio-cli-plugin-cloudmanager aio-rde-plugin-troubleshooting-deprecatedcontext

På grund av historiken för aio-cli-plugin-aem-rde användes kontextnamnet aio-cli-plugin-cloudmanager ett tag. RDE-pluginen använder nu IMS-metoden för att hantera kontextinformation, vilket gör att du kan lagra kontexten antingen globalt eller lokalt. Du kan också konfigurera en standardkontext som ska tillämpas automatiskt på alla AIO-anrop. Den konfigurerade standardkontexten lagras lokalt och gör att utvecklarna kan spåra och använda enskilda kontexter och deras information i en mapp. Mer information finns i exemplet för att konfigurera en lokal kontext ovan.

Utvecklare som använder båda plugin-programmen, aio-cli-plugin-cloudmanager och aio-cli-plugin-aem-rde och vill behålla all information i samma kontext måste nu ha följande alternativ:

Fortsätt använda kontext aio-cli-plugin-cloudmanager

Kontexten kan fortfarande användas. En borttagningsvarning visas i plugin-programmet för RDE. Den här varningen kan utelämnas i läget --quiet. De nyare versionerna av RDE-pluginen erbjuder inte längre reservversionen för att läsa kontexten aio-cli-plugin-cloudmanager. Om du vill fortsätta att använda den konfigurerar du standardkontexten till aio-cli-plugin-cloudmanager. Se exemplet för att konfigurera en lokal kontext ovan.

Använd ett annat kontextnamn även för Cloud Manager-plugin-programmet

Cloud Manager plug-ins innehåller en parameter som definierar vilket sammanhang som ska användas. Den stöder inte IMS-standardkontextkonfigurationen ännu. Om du vill göra det konfigurerar du RDE-plugin-programmet med exemplet för att konfigurera en lokal kontext och anger för Cloud Manager-plugin att använda myContext som --imsContextName=myContext i varje anrop till det.