Configuración de desarrollo local
- Se aplica a:
- Experience Manager as a Cloud Service
Creado para:
- Intermedio
- Desarrollador
Aprenda a configurar un entorno de desarrollo local para editar el contenido de una aplicación de React con el Editor universal de AEM.
Requisitos previos
Se requiere lo siguiente para seguir este tutorial:
-
Aptitudes básicas de HTML y JavaScript.
-
Las siguientes herramientas deben instalarse localmente:
- Nodo.js
- Git
- Un IDE o editor de código, como Visual Studio Code
-
Descargue e instale lo siguiente:
- AEM as a Cloud Service SDK: contiene el Jar de inicio rápido utilizado para ejecutar AEM Author y Publish localmente con fines de desarrollo.
- Servicio de editor universal: una copia local del servicio de editor universal, tiene un subconjunto de características y se puede descargar desde el portal de distribución de software.
- local-ssl-proxy: Un proxy HTTP SSL local simple que usa un certificado autofirmado para el desarrollo local. El editor universal de AEM requiere la URL HTTPS de la aplicación React para cargarla en el editor.
Configuración local
Siga los pasos a continuación para configurar el entorno de desarrollo local:
AEM SDK
Para proporcionar el contenido para la aplicación WKND Teams React, instale los siguientes paquetes en el SDK local de AEM.
-
Equipos WKND - Paquete de contenido: Contiene los modelos de fragmentos de contenido, fragmentos de contenido y consultas de GraphQL persistentes.
-
Equipos WKND - Paquete de configuración: Contiene las configuraciones de Intercambio de recursos de origen cruzado (CORS) y Controlador de autenticación de token. El CORS facilita las propiedades web que no son de AEM para realizar llamadas del lado del cliente basadas en explorador a las API de GraphQL de AEM y el controlador de autenticación de token se utiliza para autenticar cada solicitud a AEM.
Aplicación React
Para configurar la aplicación WKND Teams React, siga los pasos a continuación:
-
Clona la aplicación WKND Teams React de la rama de solución
basic-tutorial
.$ git clone -b solution/basic-tutorial git@github.com:adobe/aem-guides-wknd-graphql.git
-
Vaya al directorio
basic-tutorial
y ábralo en el editor de código.$ cd aem-guides-wknd-graphql/basic-tutorial $ code .
-
Instale las dependencias e inicie la aplicación React.
$ npm install $ npm start
-
Abra la aplicación WKND Teams React en el explorador en http://localhost:3000. Muestra una lista de los integrantes del equipo y sus detalles. El contenido de la aplicación React lo proporciona AEM SDK local mediante las API de GraphQL (
/graphql/execute.json/my-project/all-teams
), que puede comprobar mediante la ficha de red del explorador.
Servicio de editor universal
Para configurar el servicio de editor universal local, siga los pasos a continuación:
-
Descargue la versión más reciente del servicio de editor universal del Portal de distribución de software.
-
Extraiga el archivo zip descargado y copie el archivo
universal-editor-service.cjs
en un nuevo directorio llamadouniversal-editor-service
.$ unzip universal-editor-service-vproduction-<version>.zip $ mkdir universal-editor-service $ cp universal-editor-service.cjs universal-editor-service
-
Cree el archivo
.env
en el directoriouniversal-editor-service
y agregue las siguientes variables de entorno:# The port on which the Universal Editor service runs EXPRESS_PORT=8000 # Disable SSL verification NODE_TLS_REJECT_UNAUTHORIZED=0
-
Inicie el servicio local de Universal Editor.
$ cd universal-editor-service $ node universal-editor-service.cjs
El comando anterior inicia el servicio Editor universal en el puerto 8000
y debería ver el siguiente resultado:
Either no private key or certificate was set. Starting as HTTP server
Universal Editor Service listening on port 8000 as HTTP Server
Proxy HTTP SSL local
El editor universal de AEM requiere que la aplicación React se suministre a través de HTTPS. Vamos a configurar un proxy HTTP SSL local que utilice un certificado firmado automáticamente para el desarrollo local.
Siga los pasos a continuación para configurar el proxy HTTP SSL local y servir el servicio SDK de AEM y el editor universal a través de HTTPS:
-
Instale el paquete
local-ssl-proxy
globalmente.$ npm install -g local-ssl-proxy
-
Inicie dos instancias del proxy HTTP SSL local para los siguientes servicios:
- Proxy HTTP SSL local de AEM SDK en el puerto
8443
. - Proxy HTTP SSL local del servicio Editor universal en el puerto
8001
.
# AEM SDK local SSL HTTP proxy on port 8443 $ local-ssl-proxy --source 8443 --target 4502 # Universal Editor service local SSL HTTP proxy on port 8001 $ local-ssl-proxy --source 8001 --target 8000
- Proxy HTTP SSL local de AEM SDK en el puerto
Actualizar la aplicación React para que utilice HTTPS
Para habilitar HTTPS para la aplicación WKND Teams React, siga los pasos a continuación:
-
Detenga el React presionando
Ctrl + C
en el terminal. -
Actualice el archivo
package.json
para incluir la variable de entornoHTTPS=true
en el scriptstart
."scripts": { "start": "HTTPS=true react-scripts start", ... }
-
Actualice
REACT_APP_HOST_URI
en el archivo.env.development
para utilizar el protocolo HTTPS y el puerto proxy HTTP SSL local de AEM SDK.REACT_APP_HOST_URI=https://localhost:8443 ...
-
Actualice el archivo
../src/proxy/setupProxy.auth.basic.js
para usar la configuración SSL relajada mediante la opciónsecure: false
.... module.exports = function(app) { app.use( ['/content', '/graphql'], createProxyMiddleware({ target: REACT_APP_HOST_URI, changeOrigin: true, secure: false, // Ignore SSL certificate errors // pass in credentials when developing against an Author environment auth: `${REACT_APP_BASIC_AUTH_USER}:${REACT_APP_BASIC_AUTH_PASS}` }) ); };
-
Inicie la aplicación React.
$ npm start
Verificar la configuración
Después de configurar el entorno de desarrollo local siguiendo los pasos anteriores, vamos a verificar la configuración.
Verificación local
Asegúrese de que los siguientes servicios se ejecutan localmente en HTTPS; es posible que tenga que aceptar la advertencia de seguridad en el explorador para el certificado autofirmado:
- Aplicación WKND Teams React en https://localhost:3000
- AEM SDK en https://localhost:8443
- Servicio de editor universal en https://localhost:8001
Carga de la aplicación WKND Teams React en el editor universal
Carguemos la aplicación WKND Teams React en el editor universal para verificar la configuración:
-
Abra Universal Editor https://experience.adobe.com/#/aem/editor en su explorador. Si se le solicita, inicie sesión con su Adobe ID.
-
Introduzca la URL de la aplicación WKND Teams React en el campo de entrada URL del sitio del editor universal y haga clic en
Open
. -
La aplicación WKND Teams React se carga en el editor universal pero aún no puede editar el contenido. Debe instrumentar la aplicación React para habilitar la edición de contenido con el editor universal.
Siguiente paso
Aprenda a instrumentar la aplicación React para editar el contenido.