Snabba utvecklingsmiljöer

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.

Tack vare de lokala redigeringssystemen 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 molnutvecklingsmiljö via Cloud Managers pipeline.

Du kan se ytterligare videofilmer som visar konfigurera, hur man använder denoch utvecklingslivscykel med RDE.

Introduktion

RDE kan användas för konfigurationer av kod, innehåll och Apache eller Dispatcher. 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. När det gäller sandlådekonton är de i viloläge efter några timmars icke-användning.

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

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

Följ de här stegen för att använda Cloud Manager för att skapa en RDE för ditt program.

1. Logga in i Cloud Manager på my.cloudmanager.adobe.com och välja lämplig organisation.

2. Klicka på det program som du vill lägga till en RDE till för att visa information om det.

   • RDE kan läggas till i båda sandlådeprogram och produktionsprogram.

3. Från Programöversikt sida, klicka på Lägg till miljö på Miljö för att lägga till en miljö.

   

   • The Lägg till miljö finns även på Miljö -fliken.

     

   • The Lägg till miljö kan vara inaktiverat på grund av bristande behörighet eller beroende på vilka licensierade resurser som används.

4. I Lägg till miljö som visas:

   • Välj Snabb utveckling under Välj miljötyp rubrik.
     • Antalet tillgängliga/använda miljöer visas inom parentes bakom miljötypen.
   • Ange en Namn för miljön.
   • Ange ett valfritt Beskrivning för miljön.
   • Välj en Molnregion.

   

5. Klicka Spara för att lägga till den angivna miljön.

The Ökning visas nu din nya miljö i Miljö kort.

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

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 Cloud Manager-dokumentationen.

Installera kommandoradsverktygen för RDE

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

1. Installera CLI-verktygen för Adobe I/O enligt proceduren här.

2. Installera molnhanterarplugin-programmet för CLI-verktygen i Adobe I/O och konfigurera dem enligt beskrivningen här.

3. Installera Adobe I/O CLI-verktyg AEM RDE-plugin genom att köra följande kommandon:

   aio plugins:install @adobe/aio-cli-plugin-aem-rde
   aio plugins:update
   

4. Konfigurera plugin-programmet för molnhantering för ditt företags-ID:

   aio config:set cloudmanager_orgid 4E03EQC05D34GL1A0B49421C@AdobeOrg

   och ersätta den alfanumeriska strängen med ditt eget organisations-ID, som kan slås upp med strategin här.

5. Konfigurera sedan ditt program-ID:

   aio config:set cloudmanager_programid 12345

6. Konfigurera sedan det miljö-ID som den virtuella miljön ska kopplas till:

   aio config:set cloudmanager_environmentid 123456

7. När du är klar med konfigurationen av plugin-programmet loggar du in genom att utföra

   aio login

   Svaret på en lyckad inloggning ska likna utdata nedan, men du kan ignorera värdena som visas.

   ...
   You are currently in:
   1. Org: <no org selected>
   2. Project: <no project selected>
   3. Workspace: <no workspace selected>
   

   Observera att det här steget kräver att du är medlem i Cloud Manager Utvecklare - Cloud Service Produktprofil. Se den här sidan för mer information.

   Du kan också bekräfta att du har den här utvecklarrollen om du kan logga in på utvecklarkonsolen med det här kommandot:

   aio cloudmanager:environment:open-developer-console

   TIPS

   Om du ser Warning: cloudmanager:list-programs is not a aio command. måste du installera aio-cli-plugin-cloud-manager genom att köra kommandot nedan:

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

8. Verifiera att inloggningen slutfördes genom att köra

   aio cloudmanager:list-programs

   Detta bör visa alla program i din konfigurerade organisation.

Mer information och demonstrationer finns i konfigurera en RDE videosjälvstudie.

Använda RDE under utvecklingen av en ny funktion

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

• När en mellanliggande milstolpe har nåtts och validerats lokalt med den AEM as a Cloud Service SDK:n, bör koden implementeras på en Git-funktionsgren som ännu inte är en del av huvudraden, även om det är valfritt att binda sig för Git. Vad som utgör en"mellanmilstolpe" varierar beroende på teamets vanor. Exempel är några nya kodrader, en halv arbetsdag eller en underfunktion.

• Återställ RDE om den har använts av en annan funktion och du vill återställa till standardläge. Återställningen tar några minuter och allt befintligt innehåll och all befintlig kod tas bort. Du kan använda kommandot för RDE-status för att bekräfta att RDE är klart. Den nya versionen av AEM kommer att användas.

  VIKTIGT

  Om din testnings- och produktionsmiljö inte får automatiska AEM och ligger långt efter den senaste versionen av AEM bör du tänka på att koden som körs på den lokala utvecklingsmiljön kanske inte stämmer överens med hur koden fungerar i testversionerna och produktionen. I så fall är det särskilt viktigt att utföra grundliga tester av koden på mellanlagring innan den distribueras till produktion.

• Synkronisera lokal kod med RDE-kommandoradsgränssnittet. Du kan installera ett innehållspaket, ett specifikt paket, en OSGI-konfigurationsfil, en innehållsfil och en zip-fil för en Apache/Dispatcher-konfiguration. Det går också att referera till ett fjärrinnehållspaket. Se Verktyg för RDE-kommandorad för mer information. Du kan använda statuskommandot för att validera att distributionen lyckades. Du kan också använda Package Manager för att installera innehållspaket.

• Testa koden i RDE. URL:er för författare och publicering är tillgängliga i Cloud Manager.

• Om koden inte beter sig som förväntat kan du använda standardfelsökningstekniker för att förstå problemet och göra lämpliga ändringar. Utan att implementera kodändringarna i Git (eftersom de inte har validerats) kan du synkronisera koden med den lokala CLI:n. Fortsätt tills problemet är löst.

• När koden beter sig som förväntat implementerar du koden i Git-funktionsgrenen.

• Kod som synkroniseras till RDE använder inte en molnhanterarpipeline, så nu bör du använda en icke-produktionsprocess i Cloud Manager för att distribuera Git-funktionsgrenen till molnutvecklingsmiljön. Detta validerar att koden klarar Cloud Managers kvalitetsportar och gör att du kan vara säker på att koden senare distribueras med hjälp av Cloud Managers produktionsflöde.

• Upprepa stegen ovan för varje mellanliggande milstolpe tills all kod för funktionen är klar och fungerar bra i både RDE- och Cloud Development-miljön.

• Distribuera koden till produktionen via Cloud Managers produktionsflöde.

Felsöka en befintlig funktion med RDE

Arbetsflödet liknar utvecklingen av en ny funktion. Skillnaden är att koden som synkroniseras till RDE skulle återspegla Git-etiketten för det som har skickats till miljön där problemet har hittats. Dessutom kan det vara användbart att distribuera innehåll som matchar den överordnade miljön. Detta kan du göra genom att exportera och importera innehållspaket.

Flera utvecklare som samarbetar i samma utvecklingsmiljö

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 absorberas av andra utvecklare, annars kan en utvecklare oavsiktligt skriva över den andra utvecklarens kod. Den rekommenderade strategin är att varje 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.

Verktyg för RDE-kommandorad

Hjälp/Allmän information

• Om du vill visa en lista med kommandon skriver du:

  aio aem:rde

• Om du vill ha mer information om ett kommando skriver du:

  aio aem rde <command> --help

Distribuera till RDE

I det här avsnittet beskrivs hur du använder RDE CLI för att distribuera, installera eller uppdatera paket, OSGI-konfigurationer, innehållspaket, enskilda innehållsfiler och Apache- eller Dispatcher-konfigurationer.

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

Här följer några exempel:

Distribuera ett innehållspaket

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 kan distribueras, till exempel paket med kod, innehåll eller en behållarpaket (kallas även"all"-paketet).

Distribuera en OSGI-konfiguration

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

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

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

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

Från dispatcher i ett AEM projekt kan du zippa upp dispatcherkonfigurationen genom att köra kommandot nedan maven:

mvn clean package

eller använda zip-kommandot nedan från src katalogen för dispatcher modul:

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 kvalitetsgates, men koden går igenom en analys 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 hur ett paket fungerar om det inte går att lösa. I så fall"staged" och installeras bara om kraven (saknad import, i detta fall) uppfylls genom installation av annan kod.

Kontrollera statusen för den lokala lagringsplatsen

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örs:

aio aem:rde:status

kommer att returnera:

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

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

Tar bort från RDE

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

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

Det går inte att ta bort innehållspaket eller innehållsfiler. Om du vill ta bort dem bör du återställa den skrivskyddade miljön, vilket innebär att den återställs 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 demonstrationer finns i använda RDE-kommandon videosjälvstudie.

Återställ

Om du återställer RDE tas all anpassad kod, konfigurationer och innehåll bort från både författaren och publiceringsinstansen. Den här återställningen är användbar om den aktuella miljön har använts för att testa en viss funktion och du vill återställa den till ett standardläge så att du kan testa en annan funktion.

En återställning anger att den senaste tillgängliga AEM är RDE.

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

1. Logga in i Cloud Manager på my.cloudmanager.adobe.com och välja lämplig organisation.

2. Klicka på det program för vilket du vill återställa RDE.

3. Från Ökning klickar du på Miljö överst på skärmen.

   

   • Du kan även klicka på Visa alla på Miljö för att gå direkt till Miljö -fliken.

     

4. The Miljö öppnas och alla miljöer för programmet visas.

   

5. Klicka på ellipsknappen för den RDE som du vill återställa och välj sedan Återställ.

   

6. Bekräfta att du vill återställa RDE genom att klicka på Återställ i dialogrutan.

   

7. Cloud Manager bekräftar via ett banderollmeddelande att återställningsprocessen har startats.

   

När återställningsprocessen för RDE har startats tar det oftast några minuter att slutföra och återställa miljön till standardläget. Återställningsprocessens status kan visas när som helst i Status kolumn i Miljö eller i Miljö -fönstret.

Du kan också återställa den lokala redigeringsmiljön med hjälp av ellipsknappen direkt från Miljö på Ökning sida.

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

Körningslägen

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

• config.rde
• config.author.rde
• config.publish.rde

Se dokumentation för runmode för allmän information om körningslägen.

RDE skiljer sig från andra miljöer där innehåll 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 för att Git och leverera det till RDE med kommandoradsverktygen.

Fylla med innehåll

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:

1. Synkronisera innehållspaketet explicit till RDE med kommandoradsverktygen

2. Placera och implementera exempelinnehållet i Git i en install.rde-mapp under /apps och synka sedan det övergripande innehållspaketet till RDE med kommandoradsverktygen.

3. Använd innehållskopia, verktyg om du vill kopiera en definierad innehållsuppsättning från produkter, scener eller dev-miljöer, eller från en annan RDE.

4. Använd pakethanteraren

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

Loggning

Loggnivåer kan ställas in genom att modifiera OSGi-konfigurationer. Kontrollera dokumentation för mer information.

Hur skiljer sig de lokala utvecklingsmiljöerna från utvecklingsmiljöer i molnet?

Ä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 synkroniseras en kod från en lokal utvecklingsmiljö, medan en för Cloud Development Environment distribuerar kod via Cloud Manager.

Därför rekommenderar vi att du distribuerar koden till en Cloud Development Environment 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:

• De lokala redigeringssystemen innehåller inte någon förhandsgranskningsnivå
• De lokala lagringsenheterna har för närvarande inte stöd för visning och felsökning av frontkod som distribuerats med molnhanteraren Front-End Pipeline.
• De lokala redigeringssystemen stöder för närvarande inte prerelease-kanalen.

Hur många skrivbord behöver jag?

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 AEM Cloud Service-utvecklare. I den här modellen kan varje utvecklare testa sin kod på den lokala utvecklingsmiljön utan att samordna med andra gruppmedlemmar kring om det finns en tillgänglig RDE-miljö.

Å andra sidan kan ett team med en enda RDE använda interna processer för att samordna vilken utvecklare som kan använda miljön vid en viss tidpunkt. Detta kan vara möjligt när en utvecklare har nått en milstolpe för mellanliggande funktioner och är redo att validera i en molnmiljö där de snabbt kan göra de ändringar de behöver.

En mellanliggande modell är en modell där en organisation köper ett antal olika lagringssystem, vilket innebär att det är större sannolikhet att det finns en oanvänd lagringsmodell 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 en AEM Forms Cloud Service Rapid Development Environment (RDE) från andra miljöer?

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 och för funktioner som kräver ett dokument för registrering, som att generera ett dokument för registrering när ett adaptivt formulär skickas. Följande AEM Forms-funktioner är inte tillgängliga i en Rapid Development Environment (RDE):

• Konfigurera ett postdokument för ett adaptivt formulär
• Generera ett registreringsdokument när ett adaptivt formulär skickas eller när ett arbetsflödessteg tas
• Skicka postdokument som en bifogad fil med åtgärden Skicka via e-post eller med steget E-post i ett arbetsflöde
• Använda Adobe Sign i ett adaptivt formulär eller i ett arbetsflödessteg
• Kommunikations-API:er

RDE, genomgång

Mer information om RDE på AEM as a Cloud Service finns i videosjälvstudiekurs som visar hur du konfigurerar den, hur du använder den och utvecklingscykeln

Resurser för Business.Adobe.com