Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
Apigee usa Acquia, un servicio de administración de sitios web, para alojar versiones basadas en la nube del portal de servicios para desarrolladores. Acquia está diseñado para funcionar con Drupal y te permite desarrollar, probar y publicar tu portal en un entorno seguro.
En las siguientes secciones, se describe cómo usar Acquia para desarrollar y administrar tu portal.
Accede a la interfaz de Acquia Cloud
Después de configurar tu cuenta de Acquia Cloud, puedes acceder a tu portal a través de la interfaz de Acquia Cloud en https://cloud.acquia.com/.
Cuando accedes por primera vez, se muestra la página Applications, como se muestra en la siguiente imagen.
En la página Aplicaciones, se muestran todas las aplicaciones a las que tienes acceso y que se alojan en Acquia Cloud. Una aplicación es la entidad de software que administras en Acquia Cloud, como tu sitio de portal basado en Drupal.
En las siguientes secciones, se describe cómo usar la interfaz de Acquia Cloud para administrar el contenido de tu portal.
Para obtener más información sobre la interfaz de Acquia Cloud, consulta Cómo acceder a la interfaz de Acquia Cloud y Cómo administrar aplicaciones con Acquia Cloud en la documentación de Acquia Cloud.
Administra tus entornos
Accede a la interfaz de Acquia Cloud y, en la página Aplicaciones, haz clic en Administrar asociado con el sitio de tu portal para acceder a su panel.
Para administrar tu flujo de trabajo, se proporcionan tres entornos para desarrollar, probar y publicar tu portal, como se describe en la siguiente tabla. Tu portal se implementa en cada entorno, pero puede estar en un estado diferente con una rama o etiqueta de código única, una base de datos, etcétera. Consulta Cómo implementar código en los entornos de tu portal.
Entorno | Descripción | URL predeterminada |
Desarrollo | Desarrollar nuevas funciones y personalizar tu portal |
http://{application-name}xxxxxx.devcloud.acquia-sites.com/
En el que |
Etapa | Prueba el código más reciente antes de enviarlo al entorno de producción. |
http://{application-name}yyyyyy.devcloud.acquia-sites.com/
En el que |
Producción | Publica tu portal en producción (en vivo). |
http://{application-name}.devcloud.acquia-sites.com/
Donde Nota: Consulta también Cómo configurar un dominio personalizado. |
Para obtener más información, consulta Cómo trabajar con entornos en la documentación de Acquia Cloud.
Desarrolla tu portal
En las siguientes secciones, se describe cómo desarrollar tu portal.
- Descripción general del repositorio de Git
- Cómo acceder a tu código
- Implementa código en los entornos de tu portal
- Cómo agregar módulos y temas personalizados
- Anulación de los temas y módulos de perfil de Drupal
Además, consulta las siguientes secciones para obtener más detalles sobre la personalización de tu portal.
Si quieres… |
Puedes |
Más información |
---|---|---|
Cambia el aspecto del sitio |
Básica: Usa la entrada de menú Diseño en el sitio del portal para realizar cambios, como modificar el logotipo y los colores del sitio. |
Consulta Cómo personalizar la apariencia. |
Avanzado: Para modificar el diseño completo del sitio, extiende el tema responsivo de Apigee. |
Consulta Cómo personalizar el tema. |
|
Cambia el comportamiento de la funcionalidad del sitio |
Básica: Usa la configuración de administrador del portal para cambiar o configurar el comportamiento del sitio. |
Consulta la documentación de Apigee aquí. |
Avanzado: Crea un módulo personalizado para cambiar cualquier comportamiento del sitio. |
Consulta Cómo crear módulos personalizados en la documentación de Drupal. |
Descripción general del repositorio de Git
El repositorio de Git para tu código de Drupal contiene todo el código de tu portal y se organiza con la siguiente estructura.
Nota: Solo modifica el contenido del directorio /sites/all. Si modificas contenido que está fuera del directorio /sites/all
, tendrás problemas cuando actualices a versiones nuevas y es posible que experimentes conflictos de combinación cuando revises los cambios en Git.
Carpeta en el repositorio de Git |
Descripción |
---|---|
/profiles/apigee |
Módulos y temas mantenidos por Apigee, incluidos los siguientes:
Nota: No modifiques el contenido del directorio /profiles/apigee, o tendrás problemas cuando actualices a versiones nuevas y es posible que experimentes conflictos de combinación cuando revises los cambios en Git. Para conocer las prácticas recomendadas de Drupal, consulta Nunca hackees el núcleo. |
/sites/all |
Tus módulos y temas de Drupal personalizados Para obtener información sobre cómo administrar el contenido de esta carpeta, consulta Cómo agregar módulos y temas personalizados y Cómo anular los módulos y temas de perfil de Drupal. Nota: Solo modifica el contenido del directorio /sites/all. |
Cómo acceder a tu código
Para acceder a tu repositorio de código en Git, debes realizar las tareas que se describen en las siguientes secciones:
Consulta también ¿Cómo accedo al código fuente del portal para desarrolladores de Drupal 7?
Habilita el acceso SSH a tu servidor
Antes de usar Git para administrar tu código de Drupal, debes habilitar SSH para acceder a tu servidor. Para obtener más información, consulta Cómo habilitar el acceso SSH en la documentación de Acquia Cloud.
Para habilitar el acceso SSH, sigue estos pasos:
- Accede a la interfaz de Acquia Accounts en https://accounts.acquia.com.
- Haz clic en Credenciales.
- Si se te solicita, vuelve a ingresar tu contraseña para confirmar tu identidad.
- En Claves SSH, haz clic en Agregar clave SSH.
- Ingresa la siguiente información:
Campo Descripción Sobrenombre Sobrenombre para la clave SSH. El sobrenombre puede contener caracteres alfanuméricos y guiones bajos. Clave pública Clave pública Para obtener información sobre cómo generar una clave pública SSH, consulta Cómo generar una clave pública SSH en la documentación de Acquia Cloud.
- Haz clic en Agregar clave.
Cómo acceder a tu repositorio de código en Git
El repositorio de Git contiene todo el código del sitio de tu portal. Puedes agregar código nuevo o personalizar el código existente para configurar tu portal. Para obtener más información, consulta Cómo usar tu repositorio de código en la documentación de Acquia Cloud.
Para acceder a tu repositorio de código en el repositorio de Git, haz lo siguiente:
- Accede a la interfaz de Acquia Cloud en https://cloud.acquia.com/.
- En la página Aplicaciones, haz clic en Administrar para ver los detalles del portal.
- Haz clic en Información de la aplicación en la barra de navegación.
- Copia el comando de clonación en el cuadro de diálogo Información de la aplicación.
- Ejecuta uno de los siguientes comandos de Git para clonar el repositorio de Git en tu entorno local:
Para clonar el repositorio de Git y crear una rama nueva, sigue estos pasos:
> git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
Para clonar el repositorio de Git desde la rama master, haz lo siguiente:
> git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]
- Repite estos pasos cuando tengas todo listo para preparar, confirmar y enviar los cambios al repositorio de
Git con los comandos relevantes que se muestran en la ventana Application.
Cuando confirmas una rama en tu repositorio, Acquia Cloud actualiza el entorno que ejecuta esa rama de código. Puedes implementar código en tus entornos de portal, como se describe en la siguiente sección.
Implementa código en los entornos de tu portal
Para implementar, cambiar o revertir código en un entorno de portal, moverlo entre
entornos o obtener más información sobre la estructura del repositorio y el flujo de trabajo recomendado, consulta Cómo trabajar con sitios en Aquia Cloud en la
documentación de Acquia Cloud. Cuando implementes código nuevo en un entorno, deberás ejecutar update.php
para realizar las actualizaciones de base de datos necesarias.
Cómo agregar módulos y temas personalizados
Para expandir la funcionalidad del portal, agrega tus propios módulos y temas personalizados a las carpetas que se indican en la siguiente tabla.
Nota: Solo modifica el contenido del directorio /sites/all. Si modificas contenido fuera del directorio /sites/all, es posible que experimentes conflictos de combinación cuando revises los cambios en Git.
Módulo o tema | Carpeta en el repositorio de Git | Más información (documentación de Drupal) |
Módulos personalizados | sites/all/modules/custom |
Cómo crear módulos personalizados |
Temas personalizados | sites/all/themes |
Personaliza el tema Temas de Drupal 7 |
Después de agregar el módulo o tema personalizado en el entorno Dev, puedes implementarlo en Test para realizar pruebas y, luego, en el entorno En vivo para producción, como se describe en Cómo implementar código en tus entornos de portal.
Anula los módulos y temas del perfil de Drupal
Los módulos y temas de los siguientes directorios anula los módulos y temas del perfil de Drupal que Apigee mantiene y distribuye en /profiles/apigee
.
Consulta Descripción general de tu repositorio de Git.
Por ejemplo, es posible que desees anular un módulo en la distribución de Drupal de Apigee en las siguientes situaciones:
- Quieres usar una versión diferente de un módulo en particular.
- Quieres implementar una actualización de seguridad antes del próximo lanzamiento programado de Apigee.
Módulo o tema | Carpeta en el repositorio de Git | Más información (documentación de Drupal) |
Módulos de Drupal Contributed |
sites/all/modules/contrib
Nota: Los módulos almacenados en cualquier lugar de |
Módulos enviados
Nota: Los módulos que Drupal contribuyó en este directorio anula los módulos equivalentes que Apigee mantiene y distribuye en |
Temas de Drupal contribuidos | sites/all/themes |
Temas aportados
Nota: Los temas que Drupal contribuyó en este directorio anula los módulos equivalentes que Apigee mantiene y distribuye en |
Habilita SSL
Para habilitar el acceso seguro a tu sitio con HTTPS, debes habilitar SSL.
Para habilitar SSL, sigue estos pasos:
- Obtén un certificado SSL de una autoridad certificadora (AC) o un proveedor de certificados SSL. Consulta Habilita SSL.
- Sube el certificado SSL en la página SSL de la interfaz de Acquia Cloud. Consulta Cómo administrar certificados SSL.
Cómo proteger tu entorno de producción
Cuando creas una aplicación por primera vez, puedes administrar libremente el entorno de producción y propagar los cambios desde los entornos de desarrollo y de etapa de pruebas. Después de publicar tu contenido, te recomendamos que bloquees el entorno de producción para evitar actualizaciones no autorizadas o accidentales del contenido. Para obtener más información, consulta Cómo usar el modo de producción para proteger tu aplicación activa en la documentación de Acquia Cloud.
Para proteger tu entorno de producción, haz lo siguiente:
- Accede a la interfaz de Acquia Cloud en https://cloud.acquia.com/.
- En la página Aplicaciones, haz clic en Administrar para ver los detalles del sitio de tu portal.
- Haz clic en Prod para ver los detalles del entorno de producción.
- Haz clic en Modo de producción en la barra de navegación.
- Haz clic en Habilitar para habilitar el modo de producción.
Aplica actualizaciones de módulos y temas al portal
De forma periódica, Apigee actualiza los módulos y temas de tu portal a la versión más reciente automáticamente. Las actualizaciones solo se realizan en el entorno Dev y se etiquetan para indicar que se deben migrar a otros entornos del portal.
Si tu sitio no forma parte de la organización de facturación de Apigee Acquia (por ejemplo, un sitio nuevo que se migró de otro proveedor de hosting a tu propia organización), debes permitir que Apigee acceda a tu repositorio de Git para recibir envíos de actualizaciones automáticas de Devportal. Comunícate con el equipo de asistencia de Apigee para obtener más información.
Si agregaste módulos o temas personalizados, deberás actualizarlos manualmente.
En la siguiente tabla, se resumen los pasos necesarios para aplicar actualizaciones de módulos y temas al portal.
Módulos o temas | Descripción |
Módulos de Apigee Edge |
Apigee aplica actualizaciones automáticamente solo al entorno Dev. Después de probar las actualizaciones, mígrarlas de Dev a Stage y a Prod, como se describe en Cómo implementar código en los entornos de tu portal. |
Tema responsivo de Apigee |
Apigee aplica actualizaciones automáticamente solo al entorno de Dev. Después de probar las actualizaciones, mígrarlas de Dev a Stage y a Prod, como se describe en Cómo implementar código en los entornos de tu portal. |
Módulos contribuidos y núcleo de Drupal |
Apigee aplica actualizaciones automáticamente solo al entorno de Dev. Después de probar las actualizaciones, mígrarlas de Dev a Stage y a Prod, como se describe en Cómo implementar código en los entornos de tu portal. |
Temas y módulos personalizados |
Si agregaste módulos y temas personalizados a tu portal, como se describe en Cómo agregar módulos y temas personalizados, debes instalar las actualizaciones de forma manual. Descarga la versión más reciente en tu directorio local de forma manual o con Drush. Luego, prepara, confirma y envía las actualizaciones al repositorio de Git. Después de probar las actualizaciones, mígrarlas de Dev a Stage y a Prod, como se describe en Cómo implementar código en los entornos de tu portal. |
Cómo migrar tus funciones personalizadas
Si agregas código o configuraciones personalizadas al portal, debes mantenerlos y migrarlos de los entornos Dev a Stage y a Prod.
En el caso del código del repositorio de Git, puedes usar el proceso que se describe en Cómo implementar código en los entornos de tu portal para migrar el código de Dev a Etapa y, luego, a Prod.
Si creaste alguna configuración personalizada, usa uno de los siguientes métodos para migrarlas:
Método | Descripción |
Exporta tu configuración al código | Muchas configuraciones comunes se pueden "exportar" para codificar con el módulo de funciones. Por ejemplo, vistas, paneles, caché de imágenes, etcétera. |
Implementa la función hook_update_N() |
Drupal administra los cambios de configuración y de la base de datos con la función hook_update_N().
Si tienes un módulo personalizado, puedes hacer lo siguiente:
|
Cómo configurar un dominio personalizado
Como se indica en Administra tus entornos, los nombres de dominio predeterminados para los entornos de portal terminan en acquia-sites.com
. Te recomendamos que proporciones tu propio nombre de dominio personalizado que personalice y transmita mejor el propósito de tu sitio. Por ejemplo, esta es una alternativa popular:
https://developers.mycompany.com
Para configurar un dominio personalizado, sigue estos pasos:
- Agrega tu dominio al entorno del sitio del portal. Consulta Cómo administrar dominios en la documentación de Acquia Cloud.
- Para configurar tu dominio personalizado con tu proveedor de DNS, dirige la entrada del registro DNS de tu nombre de dominio a la dirección IP pública (no a un dominio
acquia-sites.com
). Consulta Cómo apuntar registros DNS a tus direcciones IP públicas en la documentación de Acquia Cloud.Nota: No configures la entrada CNAME del nombre de dominio en un dominio
acquia-sites.com
. Si lo haces, es posible que se produzcan problemas de latencia o tiempo de inactividad en el sitio de tu portal.
Supervisa tu portal con Acquia Insight
Acquia Insight es un conjunto de herramientas que te permite optimizar el sitio de tu portal supervisando su rendimiento, seguridad y optimización para motores de búsqueda. Para obtener más información, consulta Acquia Insight.
Crea una copia de seguridad de tu portal
En las siguientes tablas, se resumen las opciones disponibles para crear copias de seguridad de los componentes del portal.
Componente | Detalles de la copia de seguridad | Más información en la documentación de Acquia Cloud |
Código |
|
|
Base de datos |
|
|
Archivos | Realiza copias de seguridad manuales o programa un trabajo cron. | |
Aplicación completa | Crea una copia de seguridad manual con Drush. . |
|
Sistema de archivos de Drupal |
Realiza copias de seguridad manuales con una de las siguientes opciones:
Nota: El módulo Copia de seguridad y migración no es compatible con Acquia Cloud. Para obtener más información, consulta El módulo de copia de seguridad y migración no es compatible con Acquia Cloud. |
Cómo ver las notificaciones de actividad
Puedes ver notificaciones de actividad para hacer un seguimiento de las acciones significativas que ocurren en tu sitio de portal, como el código que se instala o copia entre entornos, las actualizaciones y copias de seguridad de la base de datos, los cambios en el servidor y mucho más. Para obtener más información, consulta Cómo ver las notificaciones de actividad en la documentación de Acquia Cloud.
Para ver la lista de notificaciones, haz lo siguiente:
- Accede a la interfaz de Acquia Cloud en https://cloud.acquia.com/.
- En la página Aplicaciones, haz clic en Administrar para ver los detalles del sitio de tu portal.
- Haz clic en el ícono de campana en la esquina superior derecha de la barra de navegación para ver las notificaciones más recientes.
- Haz clic en la flecha que aparece junto a una notificación para ver más información sobre la actividad.
Cómo suscribirse a las actualizaciones de estado
Puedes suscribirte a las actualizaciones de estado y versiones de Apigee en status.apigee.com. Haz clic en Suscribirse a actualizaciones, ingresa tu información de contacto, como la dirección de correo electrónico, cuando se te solicite y haz clic en Suscribirse. En la página de administración de notificaciones por correo electrónico, asegúrate de que esté seleccionada la opción Developer Portal, activa o desactiva otros parámetros de configuración de notificaciones según sea necesario y haz clic en Update Preferences.
Puedes suscribirte a las actualizaciones de estado de Acquia para recibir notificaciones sobre interrupciones del servicio, mantenimientos de emergencia o actualizaciones de seguridad que se realicen en la plataforma. Para suscribirte a las actualizaciones de Acquia Cloud, sigue estos pasos:
- Navega a la página de estado de Acquia.
- Haz clic en Suscribirse a actualizaciones.
- Selecciona el método que quieras usar para recibir actualizaciones (correo electrónico, SMS, etcétera).
- En la página Notificaciones, selecciona los productos para los que deseas recibir actualizaciones de estado. Por ejemplo, Acquia Cloud Enterprise.
- Haz clic en Actualizar preferencias.