Snelle ontwikkelomgevingen rapid-development-environments

Om veranderingen op te stellen, vereisen de huidige milieu's van de Ontwikkeling van de Wolk het gebruik van een proces dat uitgebreide codeveiligheid en kwaliteitsregels gebruikt genoemd een pijpleiding CI/CD. Voor situaties waar snelle en iteratieve veranderingen nodig zijn, heeft Adobe Rapid Development Environment (RDE's voor korte tijd) geïntroduceerd.

RDEs laat ontwikkelaars snel veranderingen opstellen en herzien, die de hoeveelheid tijd minimaliseren nodig om eigenschappen te testen die om in een lokale ontwikkelomgeving worden bewezen te werken.

Zodra de veranderingen in RDE zijn getest, kunnen zij aan een regelmatige milieu van de Ontwikkeling van de Wolk door de pijpleiding van Cloud Manager worden opgesteld.

U kunt extra video's zien die tonen hoe te om het, te plaatsen hoe te om hette gebruiken, en de cyclus van het ontwikkelingslevengebruikend RDE.

Inleiding introduction

RDEs kan voor code, inhoud, en Apache of Dispatcher configuraties worden gebruikt. In tegenstelling tot gewone Cloud Development-omgevingen kunnen ontwikkelaars lokale opdrachtregelprogramma's gebruiken om code die lokaal is gemaakt te synchroniseren met een RDE.

Elk programma wordt voorzien van RDE. Als er Sandbox-accounts zijn, worden deze na een paar uur niet meer gebruikt.

Bij het maken worden RDE's ingesteld op de laatst beschikbare Adobe Experience Manager (AEM)-versie. Een RDE-reset, die kan worden uitgevoerd met Cloud Manager, fietst de RDE en stelt deze in op de meest recente beschikbare AEM-versie.

Typisch, wordt RDE gebruikt door één enkele ontwikkelaar in een bepaald tijd, voor het testen van en het zuiveren van een specifieke eigenschap. Wanneer de ontwikkelingszitting wordt gedaan, kan RDE in een standaardstaat voor het volgende gebruik worden teruggesteld.

Aanvullende RDE's kunnen in licentie worden gegeven voor productieprogramma's (niet-sandbox).

RDE inschakelen in een programma enabling-rde-in-a-program

Het scherm van het Overzicht toont nu uw nieuw milieu in de ​ ​kaart van Milieu's.

Bij het maken worden RDE's ingesteld op de laatst beschikbare AEM-versie. Een RDE-reset, die ook kan worden uitgevoerd met Cloud Manager, fietst de RDE en stelt deze in op de laatst beschikbare AEM-versie.

Voor meer informatie over het gebruiken van Cloud Manager om milieu's tot stand te brengen, wie toegang tot hen heeft, en douanedomeinen toe te wijzen, zie Programma's en de Types van Programmain de documentatie van Cloud Manager.

De RDE-opdrachtregelprogramma's installeren installing-the-rde-command-line-tools

Nadat u een RDE voor uw programma gebruikend Cloud Manager hebt toegevoegd, kunt u met het in wisselwerking staan door de bevel-lijn hulpmiddelen te plaatsen zoals die in de volgende stappen worden beschreven:

Interactieve setup installing-the-rde-command-line-tools-interactive

Het opstellingsbevel vraagt of zou de verstrekte configuratie plaatselijk of globaal moeten worden opgeslagen.

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)

Kies no naar

Kies yes om het volgende te doen:

Zodra de lokale of globale configuratie wordt geselecteerd, probeert het opstellingsbevel om uw organisatie identiteitskaart van uw huidige login te lezen en dan de programma's van de organisatie te lezen. Als de organisatie niet kan worden gevonden, kunt u het manueel samen met sommige begeleiding ingaan.

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

Nadat de programma's zijn opgehaald, kan de gebruiker een keuze maken in de lijst en filteren. Als het programma is geselecteerd, wordt een lijst met RDE-omgevingen weergegeven waaruit u kunt kiezen. Als er slechts één programma, of slechts één beschikbare milieu van RDE, of allebei is, wordt het automatisch geselecteerd.

Voer de volgende handelingen uit om de huidige omgevingscontext weer te geven:

aio aem rde setup --show

De opdracht reageert op een resultaat dat lijkt op het volgende:

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

Handmatige installatieprocedure in een niet-interactieve omgeving manual-setup

In omgevingen waar geen enkele gebruiker interactief de instellingsopdracht kan uitvoeren (zoals CI/CD of scripts), is handmatige configuratie vereist. U kunt de parameters voor organisatie, programma en omgeving instellen met de onderstaande stappen.

RDE gebruiken tijdens het ontwikkelen van een nieuwe functie using-rde-while-developing-a-new-feature

Adobe raadt de volgende workflow aan voor het ontwikkelen van een nieuwe functie:

RDE gebruiken om een bestaande eigenschap te zuiveren use-rde-to-debug-an-existing-feature

Het werkschema is gelijkaardig aan het ontwikkelen van een nieuwe eigenschap. Het verschil is dat de code die aan RDE wordt gesynchroniseerd het etiket van de Git van weerspiegelt wat aan het milieu werd geduwd waar de kwestie voorkwam. Deze workflow zorgt voor consistentie bij het onderzoeken of weergeven van het probleem. Bovendien kan het nuttig zijn om inhoud op te stellen die de stroomopwaartse milieu aanpast. Deze aanpak kan worden bereikt door inhoudspakketten te exporteren en te importeren.

Meerdere ontwikkelaars die samenwerken op dezelfde RDE multiple-developers-collaborating-on-the-same-rde

RDE steunt één enkel project tegelijkertijd. Aangezien de code van een lokale ontwikkelomgeving aan het milieu RDE wordt gesynchroniseerd, is het het meest natuurlijk voor één ontwikkelaar om het op een bepaald ogenblik op zich te gebruiken.

Met zorgvuldige coördinatie is het echter mogelijk dat meerdere ontwikkelaars een specifieke functie valideren of fouten in een specifiek probleem opsporen. De sleutel is dat elke ontwikkelaar hun lokale projecten synchroon houdt zodat de codeveranderingen die door een bepaalde ontwikkelaar worden aangebracht door de andere ontwikkelaars worden geabsorbeerd. Anders zou één ontwikkelaar per ongeluk de code van de ander kunnen overschrijven. De aanbevolen strategie is dat elke ontwikkelaar zijn of haar wijzigingen doorvoert in een gedeelde Git-vertakking voordat hij of zij synchroniseert met de RDE, zodat de andere ontwikkelaars de wijzigingen doorvoeren voordat ze hun eigen wijzigingen doorvoeren.

Opdrachten voor RDE-opdrachtregelprogramma's rde-cli-commands

Help/algemene informatie help

Globale vlaggen global-flags

Distribueren naar RDE deploying-to-rde

Deze sectie verklaart hoe te om RDE CLI te gebruiken om, diverse middelen op te stellen te installeren of bij te werken. Deze bronnen zijn onder andere:

Het algemene gebruikspatroon is aio aem:rde:install <artifact> .

Hieronder vindt u enkele voorbeelden:

Een inhoudspakket implementeren deploy-content-package

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

De reactie voor een succesvolle plaatsing lijkt op het volgende:

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

U kunt desgewenst naar een externe opslagplaats verwijzen:

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"

Artefacten worden standaard ingezet op zowel auteur- als publicatieniveaus, maar de markering -s kan worden gebruikt om een specifieke laag als doel in te stellen.

Om het even welk pakket van AEM kan worden opgesteld, zoals pakketten met code, inhoud, of a containerpakket(ook genoemd het "alle"pakket).

Een OSGI-configuratie implementeren deploy-OSGI-config

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

Waar de reactie voor een succesvolle plaatsing op het volgende lijkt:

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

Een bundel implementeren deploy-bundle

Om een bundel op te stellen, gebruik:

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

Waar de reactie voor een succesvolle plaatsing op het volgende lijkt:

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

Een inhoudsbestand implementeren deploy-content-file

Als u een inhoudsbestand wilt implementeren, gebruikt u:

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

Waar de reactie voor een succesvolle plaatsing op het volgende lijkt:

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

Een Apache/Dispatcher-configuratie implementeren deploy-apache-config

Voor dit type configuratie moet de volledige mapstructuur de vorm hebben van een ZIP-bestand.

Vanuit de module dispatcher van een AEM-project kunt u de Dispatcher-configuratie comprimeren door de onderstaande gemaskeerde opdracht uit te voeren:

mvn clean package

Of u gebruikt de opdracht onder zip vanuit de map src van de module dispatcher :

zip -y -r dispatcher.zip .

Dan stel de configuratie door dit bevel op:

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

Een succesvolle plaatsing produceert een reactie die op het volgende lijkt:

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

De code die aan RDE wordt opgesteld ondergaat geen pijpleiding van Cloud Manager en zijn bijbehorende kwaliteitspoorten. De code doorloopt echter wel een analyse, die de fouten rapporteert, zoals in het onderstaande codevoorbeeld wordt geïllustreerd:

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

Het bovenstaande codevoorbeeld illustreert het gedrag als een bundel niet oplost. In dat geval wordt het "gefaseerd" en wordt het alleen geïnstalleerd als aan de vereisten ervan (ontbrekende invoer, in dit geval) wordt voldaan door de installatie van andere code.

Distribueer configuratie met betrekking tot configuratiemogelijkheden voor config-pijpleidingen (configuraties yaml) deploy-config-pipeline

De milieu-specifieke configuraties (één of meerdere yaml dossiers) die in het artikel worden beschreven Gebruikend Pijpleidingen Configkunnen als volgt worden opgesteld:

aio aem:rde:install -t env-config ./my-config-folder
Waar my-config-folder de bovenliggende map is die uw onderliggende configuraties bevat.

U kunt ook een ZIP-bestand met de mapstructuur config installeren:

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

De envTypes-array van het afbeeldingsbestand bevat de waarde rde , zoals in het onderstaande voorbeeld:

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

Voorste code implementeren op basis van sitethema's en sitesjablonen deploying-themes-to-rde

RDEs steunt front-end code die met plaatsthema'sen plaatsmalplaatjeswordt gebouwd. In plaats van het gebruiken van Cloud Manager voorste-Eind Pijpleidingals andere milieutypes, stelt RDEs voorste pakketten gebruikend een bevel-lijn richtlijn op.

Zoals gebruikelijk, bouw uw front-end pakket gebruikend npm:

npm run build

Er wordt een dist/ -map gegenereerd, zodat uw front-end pakketmap een package.json bestand en dist -map bevat:

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

Nu, bent u bereid om het front-end pakket aan RDE op te stellen door aan de front-end pakketomslag op de volgende manier te richten:

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

U kunt ook het bestand package.json en de map dist comprimeren en dat ZIP-bestand implementeren:

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

Controleer de status van de RDE checking-rde-status

U kunt RDE CLI gebruiken om te controleren of het milieu klaar is om aan worden opgesteld, aangezien welke plaatsingen door middel van het elektrische toestel van RDE zijn gemaakt.

Voer het volgende uit:

aio aem:rde:status

Retourneert met het volgende:

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

Als het bevel een nota over instanties terugkeert die opstellen, kunt u nog gaan en de volgende update uitvoeren, maar uw laatste zou nog niet op de instantie zichtbaar kunnen zijn.

Implementatiegeschiedenis tonen show-deployment-history

U kunt de geschiedenis van plaatsingen controleren die aan RDE door te lopen worden gemaakt:

aio aem:rde:history

Deze geeft een antwoord in de vorm van:

#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

Verwijderen uit RDE deleting-from-rde

U kunt CLI het gebruiken om configuraties en bundels te schrappen die u eerder aan RDE opstelde. Gebruik de opdracht status voor een lijst met items die kunnen worden verwijderd. Deze lijst bevat de instructie bsn for bundles en pid voor configuraties waarnaar moet worden verwezen in de opdracht delete.

Bijvoorbeeld, als com.adobe.granite.demo.MyServlet.cfg.json is geïnstalleerd, is bsn enkel com.adobe.granite.demo.MyServlet, zonder het {achtervoegsel 3} cfg.json.

Verwijderen van inhoudspakketten of inhoudsbestanden wordt niet ondersteund. Om hen te verwijderen, stel RDE terug, die het aan een standaardstaat terugkeert.

Zie het onderstaande voorbeeld voor meer informatie:

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

Voor meer informatie en demonstratie, zie het videoleerprogramma hoe te om de bevelen van RDE (10:01) te gebruiken.

Implementeren naar een RDE van externe Git-providers deploy-to-rde

Cloud Manager steunt het opstellen van code aan RDE direct van externe leveranciers van het Git wanneer het gebruiken van uw eigen configuratie van het Git (BYOG)brengt.

Voor het implementeren van RDE's vanuit een externe Git-opslagplaats is het volgende vereist:

Nota's van het Gebruik

hoe het werkt

Logboeken rde-logging

Gelijkaardig aan andere milieutypes, kunnen de logboekniveaus worden geplaatst door configuraties te wijzigen OSGi, hoewel zoals hierboven beschreven, het plaatsingsmodel voor RDEs een bevellijn eerder dan een plaatsing van Cloud Manager impliceert. Controleer de registrerendocumentatievoor meer informatie over hoe te om, logboeken te bekijken te downloaden en te interpreteren.

RDE CLI heeft ook zijn eigen logboekbevel dat wordt gebruikt om snel te vormen welke klassen en pakketten worden geregistreerd, en op welk logboekniveau. Deze configuraties kunnen als letterlijk worden beschouwd, aangezien zij niet de eigenschappen OSGI in versiecontrole wijzigen. Deze functie is gericht op het in real time stammen van logboeken in plaats van het omhoog kijken van logboeken van het verre verleden.

In het volgende voorbeeld wordt getoond hoe u de auteurslaag kunt staart, met één pakket dat is ingesteld op een logniveau voor foutopsporing en twee pakketten (gescheiden door spaties) die zijn ingesteld op een niveau voor foutopsporing voor info. Output die een auth pakket omvat wordt benadrukt.

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

Zie aio aem:rde:logs --help voor de volledige reeks opties voor de opdrachtregel.

Functies zijn onder andere:

Merk op dat de logboeken in geheugen op RDE worden opgeslagen en deze logboeken worden gerecycled en zo worden verworpen als zij niet worden gesleept of als het netwerk te langzaam is.

De RDE opnieuw instellen reset-rde

Als u de RDE opnieuw instelt, verwijdert u alle aangepaste code, configuraties en inhoud van zowel de auteur- als de publicatieversie. Het opnieuw instellen van de RDE is nuttig wanneer u klaar bent met het testen van één functie en de omgeving wilt terugzetten naar de standaardtoestand voordat u een andere test.

Met een reset wordt de RDE ingesteld op de meest recente beschikbare AEM-versie.

U kunt RDE terugstellen gebruikend of Cloud Managerof de bevellijn. Het opnieuw instellen duurt een paar minuten en alle bestaande inhoud en code wordt verwijderd uit de RDE.

RDE herstellen met behulp van opdrachtregel reset-the-rde-command-line

U kunt RDE terugstellen en het terugkeren aan een standaardstaat door het volgende in werking te stellen:

aio aem:rde:reset

Dit proces neemt meestal een paar minuten in beslag en rapporteert Environment reset. wanneer dit is gelukt of Failed to reset the environment. over fouten. Zie het onderstaande hoofdstuk over --json uitvoer voor een gestructureerde uitvoer.

Gebruik het statusbevelom te controleren wanneer het milieu opnieuw klaar is.

De RDE in Cloud Manager opnieuw instellen reset-the-rde-cloud-manager

U kunt Cloud Manager gebruiken om uw RDE opnieuw in te stellen door de volgende stappen te volgen:

Nadat de RDE-reset is gestart, duurt het meestal enkele minuten om de omgeving te voltooien en terug te zetten naar de standaardtoestand. U kunt de terugstellingstatus op elk ogenblik in de kolom van de Status van de kaart of het venster van Milieu's bekijken.

U kunt RDE ook terugstellen gebruikend de elliptische knoop direct van de 1} kaart van Milieu's {op de Overzicht pagina.

Voor meer informatie over hoe te om Cloud Manager te gebruiken om uw milieu's te beheren, zie de documentatie van Cloud Manager.

Opdrachten die JSON-uitvoer ondersteunen json-commands

De meeste opdrachten ondersteunen de algemene markering --json , die de uitvoer van de console onderdrukt en geldige items retourneert die in scripts moeten worden verwerkt. Hieronder vindt u enkele ondersteunde opdrachten, met voorbeelden van de json-uitvoer.

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

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

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

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

Herstellen reset

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

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

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

Opnieuw starten restart

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

Modus Uitvoeren runmodes

RDE-specifieke configuratie OSGI kan worden toegepast door achtervoegsels op de omslagnaam te gebruiken, zoals in de voorbeelden hieronder:

Zie de documentatie van de looppaswijzevoor algemene informatie over looppaswijzen.

RDE's verschillen van andere omgevingen in die zin dat inhoud kan worden geïnstalleerd in een install.rde -map (of install.author.rde of install.publish.rde ) onder /apps . Hierdoor kunt u inhoud toewijzen aan Git en deze leveren aan de RDE met behulp van opdrachtregelprogramma's.

Vullen met inhoud populating-content

Wanneer een RDE wordt teruggesteld, wordt al inhoud verwijderd en zo zo, zo moet de expliciete actie worden genomen om inhoud toe te voegen. Als beste praktijken, overweeg het assembleren van een reeks inhoud die als testinhoud voor het bevestigen van of het zuiveren eigenschappen in RDE moet worden gebruikt. Er zijn verscheidene mogelijke strategieën om RDE met die inhoud te bevolken:

U kunt maximaal 1 GB gebruiken bij het synchroniseren van inhoudspakketten.

Hoe verschillen RDE's van cloudontwikkelomgevingen? how-are-rds-different-from-cloud-development-environments

Terwijl RDE in vele opzichten gelijkaardig aan een milieu van de Ontwikkeling van de Wolk is, zijn er sommige kleine architecturale verschillen om voor snelle synchronisatie van code toe te staan. Het mechanisme om code aan RDE te krijgen is verschillend — voor RDEs, één syncs code van een lokale ontwikkelomgeving, terwijl voor de milieu's van de Ontwikkeling van de Wolk, één code door Cloud Manager opstelt.

Om deze redenen, adviseert men dat na het bevestigen van code op een milieu RDE, u de code aan een milieu van de Ontwikkeling van de Wolk gebruikend de niet productiepijplijn opstelt. Tot slot test de code alvorens met de productiepijpleiding op te stellen.

Houd ook rekening met het volgende:

Hoeveel RDEs heb ik nodig? how-many-rds-do-i-need

Een RDE is beschikbaar voor elke gelicentieerde oplossing en Adobe biedt ook extra RDEs aan, die voor Productie (niet-zandbak) programma's kunnen worden vergunning gegeven.

Het aantal vereiste RDEs hangt van de samenstelling en de processen van een organisatie af. Het meest flexibele model is waar een organisatie een specifieke RDE voor elk van hun ontwikkelaars van de Dienst van de Wolk AEM koopt. In dit model, kan elke ontwikkelaar hun code op RDE testen zonder met andere teamleden te coördineren op of een milieu RDE beschikbaar is.

Aan de andere kant kan een team met slechts één RDE op interne coördinatie vertrouwen om te bepalen welke ontwikkelaar het milieu op een bepaald tijdstip gebruikt. Deze aanpak werkt goed wanneer een ontwikkelaar een mijlpaal bereikt met functies en zijn werk moet valideren in een cloud-omgeving met de flexibiliteit om snel wijzigingen aan te brengen.

Een ingebouwd model is een model waarbij een organisatie verschillende RDE's koopt, zodat er een grotere kans is dat een ongebruikte RDE beschikbaar is. Eén strategie zou kunnen bestaan uit het toewijzen van een RDE per rumteam of belangrijke functie. Interne processen kunnen worden gebruikt om het gebruik van de omgevingen te coördineren.

Hoe anders is een AEM Forms Cloud Service RDE dan andere omgevingen? how-are-forms-rds-different-from-cloud-development-environments

Forms-ontwikkelaars kunnen AEM Forms Cloud Service Rapid Development Environment gebruiken om snel adaptieve Forms, workflows en aanpassingen te ontwikkelen, zoals het aanpassen van kerncomponenten, integratie met systemen van derden en meer. De AEM Forms Cloud Service Rapid Development Environment (RDE) biedt geen ondersteuning voor communicatie-API's. Het biedt ook geen ondersteuning voor functies en mogelijkheden die Documenten van Record vereisen, zoals het genereren van een Document of Record bij het verzenden van een adaptief formulier. De hieronder vermelde AEM Forms-functies zijn niet beschikbaar in een Rapid Development Environment (RDE):

RDE-zelfstudie

Om over RDE in AEM as a Cloud Service te leren, zie het videoleerprogramma dat toont hoe te opstelling, hoe te om het te gebruiken, en de cyclus van het ontwikkelingsleven (01:25).

Problemen oplossen troubleshooting

Los RDE (#rde-troublehooting) problemen op

De nieuwste AEM-versie verkrijgen voor een bestaande RDE get-latest-aem-version

Bij het maken worden RDE's ingesteld op de laatst beschikbare Adobe Experience Manager (AEM)-versie. Een teruggestelde RDE, die kan worden uitgevoerd gebruikend Cloud Manager of het aio aem:rde:reset bevel, cycli RDE en plaats het aan de recentste beschikbare versie van AEM.

AIR RDE-plug-in oplossen aio-rde-plugin-troubleshooting

Fouten met betrekking tot ontoereikende machtigingen insufficient-permissions

Om de insteekmodule van RDE te gebruiken, vereist het u om een lid van de Cloud Manager Ontwikkelaar - het Profiel van het Product van Cloud Service te zijn. Zie de Leden van het Team aan de Profielen van het Product van Cloud Manager toewijzen - wijs het Profiel van het Product van de Ontwikkelaarvoor meer details toe.

Alternatief, kunt u bevestigen dat u deze ontwikkelaarrol hebt als u login aan de ontwikkelaarsconsole door het volgende bevel in werking te stellen:

aio cloudmanager:environment:open-developer-console

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

Controleer of de aanmelding is voltooid door het volgende uit te voeren:

aio cloudmanager:list-programs

Dit proces maakt een lijst van alle programma's onder uw gevormde organisatie en bevestigt dat u de correcte toegewezen rol hebt.

Vervangen context gebruiken aio-cli-plugin-cloudmanager aio-rde-plugin-troubleshooting-deprecatedcontext

Vanwege de geschiedenis van de aio-cli-plugin-aem-rde is de contextnaam aio-cli-plugin-cloudmanager al enige tijd gebruikt. De insteekmodule RDE gebruikt nu de IMS-methode voor het beheer van contextinformatie, zodat u de context globaal of lokaal kunt opslaan. U kunt een standaardcontext ook vormen om automatisch op alle vraag toe te passen AIO. De standaard gevormde context wordt plaatselijk opgeslagen en laat de ontwikkelaars toe om individuele contexten en hun informatie binnen een omslag te volgen en te gebruiken. Voor verdere details, lees het voorbeeld aan opstelling hierboven een lokale context.

Ontwikkelaars die zowel de plug-ins aio-cli-plugin-cloudmanager als de aio-cli-plugin-aem-rde gebruiken en alle informatie in dezelfde context willen houden, moeten nu opties kiezen:

Context blijven gebruiken aio-cli-plugin-cloudmanager

De context kan nog steeds worden gebruikt. In de RDE-plug-in wordt een afleidingswaarschuwing weergegeven. Deze waarschuwing kan worden weggelaten in de modus --quiet . Recentere versies van de RDE-insteekmodule bieden niet langer de mogelijkheid om de context aio-cli-plugin-cloudmanager te lezen. Als u dit wilt blijven gebruiken, configureert u gewoon de standaardcontext op aio-cli-plugin-cloudmanager . Zie het voorbeeld aan opstelling een lokale contexthierboven.

Gebruik een andere contextnaam ook voor de Cloud Manager-plug-in

De Cloud Manager-plug-ins bieden een parameter voor het definiëren van de context die moet worden gebruikt. De standaard IMS-contextconfiguratie wordt nog niet ondersteund. Om dit te doen, vorm de insteekmodule RDE gebruikend het voorbeeld aan opstelling een lokale contexten vertelt de insteekmodule van Cloud Manager om myContext als --imsContextName=myContext in elke vraag aan het te gebruiken.