Cómo trabajar con Acquia

Estás consultando la documentación de Apigee Edge.
Consulta la documentación de Apigee X.
Información

Apigee usa Acquia, un servicio de administración de sitios web, para alojar versiones del portal de servicios para desarrolladores basadas en la nube. Acquia se diseñó para trabajar 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 el 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 Aplicaciones, como se muestra en la siguiente imagen.

En la página Aplicaciones, se muestran todas las aplicaciones a las que tienes acceso que están alojadas en Acquia Cloud. Una aplicación es la entidad de software que administras en Acquia Cloud, como tu sitio del 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 Accede a la interfaz de Acquia Cloud y Administra 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 al panel.

Para administrar el flujo de trabajo, se proporcionan tres entornos destinados a 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 de código o etiqueta, una base de datos, etcétera. Consulta Implementa código en los entornos del portal.

Entorno Descripción URL predeterminada
Desarrollo Desarrolla nuevas funciones y personaliza tu portal. http://{application-name}xxxxxx.devcloud.acquia-sites.com/

application-name es el nombre de la aplicación y xxxxxx es una string ú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/

application-name es el nombre de la aplicación y yyyyyy es una string ú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/

En el ejemplo anterior, application-name es el nombre de la aplicación.

Nota: Consulta también Cómo configurar un dominio personalizado.

Para obtener más información, consulta Trabaja con entornos en la documentación de Acquia Cloud.

Desarrollo de tu portal

En las siguientes secciones, se describe cómo desarrollar tu portal.

Además, consulta las siguientes secciones a fin de obtener más detalles para personalizar tu portal.

Si deseas...

Puedes

Más información

Cambiar la apariencia del sitio

Básica: Usa la entrada de menú Apariencia en el sitio del portal para hacer cambios, como modificar el logotipo y los colores del sitio.

Consulta Cómo personalizar la apariencia

Avanzado: Para realizar modificaciones en el aspecto completo del sitio, extiende el tema responsivo de Apigee.

Consulta Cómo personalizar el tema

Cómo cambiar el comportamiento de las funciones del sitio

Básica: Usa la configuración del administrador en el portal para cambiar o configurar el comportamiento del sitio.

Consulta la documentación de Apigee desde aquí

Advanced: Crea un módulo personalizado para cambiar cualquier comportamiento del sitio.

Consulta Crea 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 del 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 para actualizar a versiones nuevas y es posible que se produzcan conflictos de combinación cuando verifiques los cambios en Git.

Carpeta en el repositorio de Git

Descripción

/profiles/apigee

Módulos y temas que mantiene Apigee, incluidos los siguientes:

  • /profiles/apigee/modules/contrib: Módulos de contribución de Drupal que mantiene Apigee
  • /profiles/apigee/themes/contrib: Temas de contribución de Drupal que mantiene 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 verifiques los cambios en Git. Para conocer las prácticas recomendadas de Drupal, consulta Nunca hackear core.

/sites/all

Tus módulos y temas personalizados de Drupal 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 módulos y temas de perfiles de Drupal.

Nota: Solo modifica el contenido del directorio /sites/all.

Accede 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 puedo acceder al código fuente del portal para desarrolladores de Drupal 7?

Habilita el acceso SSH a tu servidor

Antes de poder usar Git para administrar tu código de Drupal, debes habilitar SSH para acceder a tu servidor. Para obtener más información, consulta Habilita el acceso SSH en la documentación de Acquia Cloud.

Para habilitar el acceso SSH, haz lo siguiente:

  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 la contraseña para confirmar tu identidad.
  4. En Llaves SSH, haz clic en Agregar clave SSH.
  5. Ingresa la siguiente información:
    Campo Descripción
    Apodo Sobrenombre de 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 Genera una clave pública SSH en la documentación de Acquia Cloud.

  6. Haga clic en Agregar clave.

Accede a tu repositorio de código en Git

El repositorio de Git contiene todo el código del sitio del portal. Puedes agregar código nuevo o personalizar el código existente para configurar tu portal. Para obtener más información, consulta Usa tu repositorio de código en la documentación de Acquia Cloud.

Sigue estos pasos para acceder a tu repositorio de código en el repositorio de Git:

  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. Clona el repositorio de Git en tu entorno local mediante la ejecución de uno de los siguientes comandos de Git:

    Sigue estos pasos para clonar el repositorio de Git y crear una rama nueva:

    > git clone --branch [branch] myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

    Sigue estos pasos para clonar el repositorio de Git desde la rama master:

    > git clone myportal@abcdef.devcloud.hosting.acquia.com:myportal.git [destination]

  6. Repite estos pasos cuando estés listo para habilitar a etapa, confirmar y enviar tus 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 tus entornos del portal

Para implementar, cambiar o revertir el código en un entorno de portal, mover el código entre entornos o, también, obtener más información sobre la estructura del repositorio y el flujo de trabajo recomendado, consulta Trabaja 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 necesarias de la base de datos.

Cómo agregar módulos y temas personalizados

Puedes expandir la funcionalidad del portal si agregas tus propios módulos y temas personalizados a las carpetas que se enumeran en la siguiente tabla.

Nota: Solo modifica el contenido del directorio /sites/all. Si modificas contenido que está fuera del directorio /sites/all, es posible que se generen conflictos de combinación cuando verifiques los cambios en Git.

Módulo/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 Personalización del tema
Temas de Drupal 7

Después de agregar el módulo o tema personalizado en el entorno de Dev, puedes implementarlo en Test para realizar pruebas y, luego, en el entorno Live para la producción, como se describe en Implementa código en los entornos del portal.

Anula módulos y temas de perfiles de Drupal

Los módulos y temas de los siguientes directorios anulan los temas y módulos de perfiles de Drupal que Apigee mantiene y distribuye en /profiles/apigee. Consulta Descripción general de tu repositorio de Git.

Por ejemplo, se recomienda anular un módulo en la distribución de Drupal de Apigee en las siguientes situaciones:

  • Deseas 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/Tema Carpeta en el repositorio de Git Más información (documentación de Drupal)
Módulos contribuidos de Drupal 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 Apigee Drupal.

Módulos contribuidos

Nota: Los módulos contribuidos de Drupal en este directorio anulan 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 perfiles de Drupal que mantiene Apigee.

Temas contribuidos de Drupal sites/all/themes Temas contribuidos

Nota: Los temas aportados por Drupal en este directorio anulan los módulos equivalentes que Apigee mantiene y distribuye en /profiles/apigee/themes. Quita los módulos duplicados que hayas agregado a esta carpeta si deseas usar los temas de perfiles mantenidos por Apigee.

Habilita SSL

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

Para habilitar SSL, haz lo siguiente:

  1. Obtén un certificado SSL de una autoridad certificadora (CA) o un proveedor de certificados SSL. Consulta Habilita SSL.
  2. Sube el certificado SSL en la página SSL en la interfaz de Acquia Cloud. Consulta Administra certificados SSL.

Cómo proteger tu entorno de producción

Cuando creas una aplicación por primera vez, puedes administrar con libertad el entorno de producción y propagar los cambios desde los entornos de desarrollo y 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. Si deseas obtener más información, consulta Usa 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 del portal.
  3. Haz clic en Producción para ver los detalles del entorno de producción.
  4. En la barra de navegación, haz clic en Modo de producción.
  5. Haz clic en Habilitar para habilitar el modo de producción.

Aplicar actualizaciones de módulos y temas al portal

Apigee actualiza de manera automática los módulos y temas de tu portal a la versión más reciente de forma automática. Las actualizaciones se realizan solo en el entorno Dev y están etiquetadas para indicar que deben migrarse 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ó desde otro proveedor de hosting a tu propia organización), debes permitir que Apigee acceda a tu repositorio de Git para recibir envíos automáticos de actualizaciones 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/Temas Descripción
Módulos de Apigee Edge

Apigee aplica actualizaciones de forma automática solo al entorno Dev.

Después de probar las actualizaciones, mígralas del entorno de Desarrollo a Etapa a Producción, como se describe en Implementa código en tus entornos de portal.

Tema responsivo de Apigee

Apigee aplica actualizaciones de forma automática solo al entorno de Dev.

Después de probar las actualizaciones, mígralas del entorno de Desarrollo a Etapa a Producción, como se describe en Implementa código en tus entornos de portal.

Núcleo de Drupal y módulos contribuidos

Apigee aplica actualizaciones de forma automática solo al entorno de Dev.

Después de probar las actualizaciones, mígralas del entorno de Desarrollo a Etapa a Producción, como se describe en Implementa código en tus entornos de portal.

Módulos y temas 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, almacena en etapa intermedia, confirma y envía las actualizaciones al repositorio de Git. Después de probar las actualizaciones, mígralas del entorno de Desarrollo a Etapa a Producción, como se describe en Implementa código en tus entornos de portal.

Migra tus funciones personalizadas

Si agregas código personalizado o configuraciones al portal, debes mantenerlos y migrarlos de los entornos de Desarrollo a Etapa a Producción.

Para el código en el repositorio de Git, puedes usar el proceso descrito en Implementa código en los entornos del portal a fin de migrar el código de Dev (Desarrollo) a Stage (Etapa) a Producción (Prod).

Si creaste configuraciones personalizadas, usa uno de los siguientes métodos para migrarlas:

Método Descripción
Exporta tu configuración al código Muchas configuraciones comunes son "exportables" al código mediante 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 la base de datos mediante la función hook_update_N().

Si tienes un módulo personalizado, puedes hacer lo siguiente:

  • Agrega funciones hook_update_N() al archivo .install de tu 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 etapa de pruebas y producción.

Configura un dominio personalizado

Como se mencionó en Administra tus entornos, todos los nombres de dominio predeterminados para los entornos del 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, haz lo siguiente:

  1. Agrega tu dominio al entorno del sitio del portal. Consulta Administra dominios en la documentación de Acquia Cloud.
  2. Apunta la entrada del registro DNS de tu nombre de dominio a la dirección IP pública (no a un dominio acquia-sites.com) para configurar el dominio personalizado con tu proveedor de DNS. Consulta Cómo dirigir 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. Esto puede causar problemas de latencia o tiempo de inactividad en el sitio del portal.

Supervisa tu portal con Acquia Insight

Acquia Insight es un conjunto de herramientas que te permite supervisar tu rendimiento, seguridad y optimización para motores de búsqueda a fin de optimizar tu sitio de portal. Para obtener más información, consulta Acquia Insight.

Creando una copia de seguridad de tu portal

En las siguientes tablas, se resumen las opciones disponibles para crear una copia de seguridad de los componentes del portal.

Componente Detalles de la copia de seguridad Más información en los documentos de Acquia Cloud
Código
  • Un sistema de control de versión mantiene el código y lo etiqueta cada vez que lo confirmas.
  • Puedes sincronizar una etiqueta específica o revertirla en cualquier momento.
Base de datos
  • Las copias de seguridad diarias se realizan y mantienen durante tres días.
  • Programa copias de seguridad automáticas y a pedido.
  • Se toman instantáneas de desastres internos de todos los datos cada hora.
Files Realiza copias de seguridad manuales o programa un trabajo cron.
Aplicación completa Realiza una copia de seguridad manual con Drush.
.
Sistema de archivos de Drupal Realiza copias de seguridad manuales mediante una de las siguientes opciones:
  • Copia los archivos mediante un cliente FTP o las 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 realizar un seguimiento de las acciones significativas que ocurren con tu sitio de portal, como la instalación de código o la copia entre entornos, las actualizaciones y copias de seguridad de bases de datos, los cambios en los servidores y mucho más. Para obtener más información, consulta Visualiza notificaciones de actividad en la documentación de Acquia Cloud.

Para ver la lista de notificaciones, sigue estos pasos:

  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 tus notificaciones más recientes.

  4. Haz clic en la flecha junto a una notificación para ver más información sobre la actividad.

Suscribirse a las actualizaciones de estado

Puedes suscribirte a las actualizaciones de estado y de lanzamiento de Apigee en status.apigee.com. Haz clic en Suscribirse a las 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 Portal para desarrolladores, activa otras opciones de configuración de notificaciones según sea necesario y haz clic en Actualizar preferencias.

Puedes suscribirte a las actualizaciones de estado de Acquia para recibir notificaciones sobre cualquier interrupción del servicio, mantenimiento 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 las actualizaciones.
  3. Selecciona el método que deseas utilizar para recibir actualizaciones (correo electrónico, SMS, etc.).
  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.