Cómo trabajar con Acquia

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 application-name es el nombre de tu aplicación y xxxxxx es una cadena única de caracteres que se usa para diferenciar Dev y Stage.

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 application-name es el nombre de tu aplicación y yyyyyy es una cadena única de caracteres que se usa para diferenciar Dev y Stage.

Producción Publica tu portal en producción (en vivo). http://{application-name}.devcloud.acquia-sites.com/

Donde application-name es el nombre de tu aplicación.

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.

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:

  • /profiles/apigee/modules/contrib: Módulos de Drupal contrib mantenidos por Apigee
  • /profiles/apigee/themes/contrib: Temas de Drupal contrib mantenidos por Apigee
  • /profiles/apigee/modules/custom: Módulos personalizados creados por Apigee
  • /profiles/apigee/themes/custom: Temas personalizados creados por Apigee

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:

  1. Accede a la interfaz de Acquia Accounts en https://accounts.acquia.com.
  2. Haz clic en Credenciales.
  3. Si se te solicita, vuelve a ingresar tu contraseña para confirmar tu identidad.
  4. En Claves SSH, haz clic en Agregar clave SSH.
  5. 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.

  6. 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:

  1. Accede a la interfaz de Acquia Cloud en https://cloud.acquia.com/.
  2. En la página Aplicaciones, haz clic en Administrar para ver los detalles del portal.
  3. Haz clic en Información de la aplicación en la barra de navegación.

  4. Copia el comando de clonación en el cuadro de diálogo Información de la aplicación.
  5. 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]

  6. 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 /sites/all/modules anularán los módulos de distribución de Drupal de Apigee.

Módulos enviados

Nota: Los módulos que Drupal contribuyó en este directorio anula los módulos equivalentes que Apigee mantiene y distribuye en /profiles/apigee/modules. Quita los módulos duplicados que agregaste a esta carpeta si deseas usar los módulos de perfil de Drupal mantenidos por Apigee.

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 /profiles/apigee/themes. Quita los módulos duplicados que agregaste a esta carpeta si deseas usar los temas de perfil mantenidos por Apigee.

Habilita SSL

Para habilitar el acceso seguro a tu sitio con HTTPS, debes habilitar SSL.

Para habilitar SSL, sigue estos pasos:

  1. Obtén un certificado SSL de una autoridad certificadora (AC) o un proveedor de certificados SSL. Consulta Habilita SSL.
  2. 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:

  1. Accede a la interfaz de Acquia Cloud en https://cloud.acquia.com/.
  2. En la página Aplicaciones, haz clic en Administrar para ver los detalles del sitio de tu portal.
  3. Haz clic en Prod para ver los detalles del entorno de producción.
  4. Haz clic en Modo de producción en la barra de navegación.
  5. 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:

  • Agrega funciones hook_update_N() al archivo .install del módulo para procesar los cambios.
  • Implementa estos cambios junto con tu código.
  • Ejecuta update.php para migrar los cambios en los entornos de Stage y Prod.

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:

  1. Agrega tu dominio al entorno del sitio del portal. Consulta Cómo administrar dominios en la documentación de Acquia Cloud.
  2. 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
  • Un sistema de control de versión mantiene el código y lo etiqueta cada vez que realizas una confirmación.
  • Sincronizar o revertir a una etiqueta específica en cualquier momento
Base de datos
  • Las copias de seguridad diarias se realizan y se mantienen durante tres días.
  • Programa copias de seguridad automáticas y a pedido.
  • Se toman instantáneas internas de todos los datos cada hora.
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:
  • Copia tus archivos con un cliente de FTP o herramientas de línea de comandos (rsync y scp).
  • Crea un archivo comprimido con Drush.

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:

  1. Accede a la interfaz de Acquia Cloud en https://cloud.acquia.com/.
  2. En la página Aplicaciones, haz clic en Administrar para ver los detalles del sitio de tu portal.
  3. 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.

  4. 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:

  1. Navega a la página de estado de Acquia.
  2. Haz clic en Suscribirse a actualizaciones.
  3. Selecciona el método que quieras usar para recibir actualizaciones (correo electrónico, SMS, etcétera).
  4. En la página Notificaciones, selecciona los productos para los que deseas recibir actualizaciones de estado. Por ejemplo, Acquia Cloud Enterprise.
  5. Haz clic en Actualizar preferencias.