Estás viendo la documentación de Apigee Edge.
Ve a la
Documentación de Apigee X. información
Apigee usa Pantheon, un servicio de administración de sitios web, para alojar versiones basadas en la nube del portal de servicios para desarrolladores. Pantheon está diseñado para funcionar con Usa Drupal para desarrollar, probar y publicar tu portal en un entorno seguro. Sitio web de Pantheon de Google Cloud para clientes con necesidades de hosting y operaciones de desarrollo en el mundo.
En las siguientes secciones, se describe cómo usar Pantheon para desarrollar y administrar tu portal.
Accede al panel de Pantheon
Cuando Apigee te envíe la URL de tu portal, también recibirás la URL del Pantheon Panel: https://dashboard.getpantheon.com/.
Cuando accedes por primera vez al panel de Pantheon, llegas a la página Sitios como se muestra a continuación:
Desde el panel, puedes acceder al sitio, configurar tu cuenta y realizar otras las operaciones.
Selecciona la imagen de tu sitio (por ejemplo, apigeedocs) para abrir el panel de ese sitio. sitio:
Administra tus entornos
En el panel de Pantheon, se muestran tres entornos en la parte superior de la página: Dev, Probar y transmitir en vivo. Cada una se describe en la siguiente tabla.
|
Entorno |
Descripción |
|---|---|
|
Desarrollo |
El entorno Dev está conectado a tu repositorio de Git. Cualquiera cambios que envías a Git aparecen inmediatamente en el entorno Dev. La URL de este sitio tiene el siguiente formulario, donde org_name es el nombre de tu organización: http://dev-{org_name}.devportal.apigee.io/ |
|
Prueba |
El entorno de pruebas sirve para probar el código más reciente con un copia de los datos del entorno En vivo. Este entorno es en la que se prueban los cambios de código antes de enviarlos el entorno Live. La URL de este sitio tiene el siguiente formulario, donde org_name es el nombre de tu organización: http://test-{org_name}.devportal.apigee.io/ |
|
Live |
El entorno En vivo es el entorno de producción que que pones a disposición de tus clientes. La URL de este sitio tiene el siguiente formulario, donde org_name es el nombre de tu organización: http://live-{org_name}.devportal.apigee.io/ |
Desarrollo del contenido de tu portal
En las siguientes secciones, se describe cómo desarrollar el contenido de tu portal.
- Descripción general del repositorio de Git
- Cómo acceder a tu código
- Implementa código en tu portal entornos
- Cómo agregar módulos y temas personalizados
- Anular módulos de perfiles de Drupal y temas
Además, consulta las siguientes secciones para obtener más detalles sobre cómo personalizar tus portal.
|
Si deseas... |
También puedes |
Más información |
|---|---|---|
|
Cambiar la apariencia del sitio |
Básica: Usa la entrada del menú Apariencia. en el sitio del portal para realizar cambios, como modificar el logotipo y los colores del sitio. |
Consulta Personalizar el aspecto: |
|
Avanzada: Para realizar modificaciones en el aspecto completo. del sitio, extender el tema de Apigee Responsivo. |
Consulta la sección Personalización del tema |
|
|
Cambiar el comportamiento de las funciones del sitio |
Básico: Usa la configuración del administrador en el portal para cambiar o establecer la configuración. la forma en que se comporta el sitio. |
Consulta la documentación de Apigee que comienza aquí |
|
Advanced: Crea un módulo personalizado para cambiar cualquier comportamiento del . |
Consulta Creación de cuentas módulos 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 está organizado usando la siguiente estructura.
Nota: Solo modifica el contenido dentro del directorio /sites/all. Si
si modificas el contenido que está fuera del directorio /sites/all, tendrás problemas
al actualizar a nuevas versiones y pueden surgir conflictos de combinación al comprobar los cambios de
Git
|
Carpeta en el repositorio de Git |
Descripción |
|---|---|
/profiles/apigee |
Apigee mantuvo módulos y temas, incluidos los siguientes:
Nota: No modifiques el contenido del directorio /profiles/apigee o tendrás problemas. al actualizar a nuevas versiones y puede haber conflictos de combinación al realizar el registro. cambios a 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 en esta carpeta; consulta Cómo agregar módulos personalizados y temas, y Cómo anular los módulos de perfiles de Drupal, y temas. Nota: Solo modifica el contenido dentro 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 el las siguientes secciones:
Consulte también ¿Cómo accedo al código fuente del portal para desarrolladores de Drupal 7?
Cómo habilitar 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 subiendo una clave SSH a Pantheon.
Para habilitar el acceso SSH a tu servidor, sigue estos pasos:
- Accede a Pantheon en https://dashboard.getpantheon.com/.
- En el panel, selecciona Cuenta.
- Selecciona Llaves SSH en el menú de la izquierda.
- Agrega tu llave y selecciona Agregar llave.
Si necesitas ayuda, selecciona Aprender a generar una conexión SSH Clave.
Accede a tu repositorio de código en Git
Nota: Consulta la descripción general de Git de Terraform para obtener una descripción general de la estructura del repositorio de Git.
Para acceder a tu repositorio de código en Git, haz lo siguiente:
- Accede al panel de Pantheon.
- En la página principal de Sites, selecciona el ícono de tu portal.
- La URL del repositorio Git aparece en la página a la derecha de Connection Mode, como se muestra en la imagen anterior.
- Copia la URL de tu repositorio de Git y clónala a tu entorno de desarrollo local con
el comando
> Git clonar gitURL sitename
Por ejemplo:
> git clone ssh://codeserver.dev.12@codeserver.dev.12.drush.in:2222/~/repository.git devportal
Cualquier cambio de código que envíes al repositorio Git aparecerá inmediatamente en el entorno de desarrollo de tu portal.
Implementa el código en tu portal entornos
Para codificar en los entornos de tu portal, haz lo siguiente:
- Enviar las actualizaciones de código a Git, que actualiza inmediatamente el archivo Dev en un entorno de nube.
- Accede a Pantheon y selecciona tu sitio.
- Selecciona el entorno Dev.
- Selecciona </>Código en el menú de la izquierda para ver un mensaje acerca de tu
Cambio de código en el Registro de confirmación:
- Selecciona el entorno Prueba en la parte superior de la página.
- Si todavía no subiste Desarrollo a la Prueba, tienes lo siguiente: que lo hagas ahora.
- Si ya tienes un entorno de prueba, aparecerá un mensaje que te indicará
que hay una confirmación de Dev lista para implementarse:
- Si ya enviaste un sitio al entorno Publicado, puedes De manera opcional, selecciona la tercera casilla de verificación para copiar la base de datos en vivo y los archivos que haya subido desarrolladores pueden realizar pruebas desde Live. Esto es útil si quieres Prueba los cambios de tu código con los datos más recientes disponibles en En vivo.
- Selecciona el botón Deploy Code from Development.
- Prueba el portal en el entorno de prueba.
- Realiza las correcciones de código en el entorno de Dev (Dev) y vuelve a enviar los archivos al Realiza pruebas.
- Cuando se completen las pruebas, selecciona el entorno En vivo en la parte superior de la
.
- Si aún no has subido Prueba a En vivo, tienes lo siguiente: que lo hagas ahora.
- Si ya tienes un entorno En vivo, aparecerá un mensaje que te indicará que haya una confirmación de Test lista para implementarse. Implementa esos cambios de la misma manera en que las implementaste para probar desde Dev (Desarrollo). Cuando cuando termine la prueba, envía el código al entorno Live.
Obtenga más información:
- Pantheon proporciona un conjunto de Ir Artículos publicados sobre este proceso que puedes ver. Una de las más importantes es la sección Uso del panteón Workflow, que ofrece una descripción general sobre cómo desarrollar, probar y enviar .
Cómo agregar módulos y temas personalizados
Puedes expandir la funcionalidad del portal agregando tus propios módulos y temas personalizados a las carpetas que aparecen en la siguiente tabla.
Nota: Solo modifica el contenido dentro del directorio /sites/all. Si modificas contenido que está fuera del directorio /sites/all, también puedes experimenten conflictos de combinación cuando se verifiquen 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 |
Creación de cuentas módulos |
| Temas personalizados | sites/all/themes |
La personalización del
tema Temas de Drupal 7 |
Después de agregar el módulo o tema personalizado al entorno Dev, puedes puedes implementarlo en Test para realizar pruebas y, luego, en el entorno En vivo para la producción, como se describe en Implementa el código en los entornos de tu portal.
Cómo anular módulos y temas de perfiles de Drupal
Los módulos y temas de los siguientes directorios anulan los módulos de perfil de Drupal y
temas que mantiene y distribuye Apigee en /profiles/apigee.
Consulta Descripción general de tu repositorio de Git.
Por ejemplo, quizás quieras anular un módulo en la distribución de Drupal de Apigee en el las siguientes situaciones:
- Quieres usar una versión diferente de un módulo en particular.
- Quieres implementar una actualización de seguridad antes de la próxima versión programada de Apigee.
| Módulo o tema | Carpeta en el repositorio de Git | Más información (documentación de Drupal) |
| Módulos contribuidos con Drupal |
Nota: Los módulos almacenados en cualquier parte de |
Módulos que contribuyeron a la publicación
Nota: Los módulos que aportó Drupal en este directorio anulan los módulos equivalentes.
que Apigee mantiene y distribuye en |
| Temas que contribuyen a Drupal | sites/all/themes |
Temas aportados
Nota: Los temas aportados por Drupal en este directorio anulan los módulos equivalentes.
que Apigee mantiene y distribuye,
en |
Acerca del archivo settings.php
El settings.php de Drupal se confirma en el repositorio de Git ascendente del portal para desarrolladores de Apigee de Drupal. Si quieres realizar cambios en el archivo sites/default/settings.php, no lo edites directamente.
En su lugar, crea un archivo llamado sites/default/settings.local.php y coloca tu código personalizado allí. El archivo settings.php incluye sites/default/settings.local.php.
Por ejemplo, cuando configures un dominio personalizado para un sitio publicado según las instrucciones que proporciona Pantheon, en lugar de modificar el archivo settings.php directamente, agrega las actualizaciones necesarias en sites/default/settings.local.php.
Asegura tu portal
Los sitios del portal asociados con las plataformas de desarrollo, prueba y Los entornos en vivo son de acceso público de forma predeterminada. Eso significa que cualquier persona con el La URL del sitio tiene acceso, aunque es posible que no puedan registrar una cuenta o iniciar sesión en del sitio. Para obtener más información sobre cómo controlar el registro de usuarios, consulta Agregar y administrar usuarios .
Es probable que quieras ocultar tus sitios de Desarrollo y Pruebas del público y quieres ocultar tu sitio Publicado hasta que completes el desarrollo. Panteón te permite agregar un control de nombre de usuario y contraseña para bloquear un sitio y que solo las personas que tengan credenciales pueden acceder a él.
Para agregar bloqueo a cualquiera de los tres entornos, selecciona Seguridad en la menú de la izquierda para el entorno. Para obtener más información, consulta Cómo bloquear tu sitio.
Si quieres habilitar TLS/SSL para tu sitio, consulta Cómo usar TLS en el portal.
Aplica una actualización de Apigee a tu portal
Cuando Apigee publica una nueva versión del portal, aparece un mensaje en Pantheon Panel de control.
Por lo general, debes aplicar la actualización al entorno para Dev y, luego, probarlas cambios de la misma forma en que pruebas tus propios cambios de código. Por ejemplo, envía el Dev (Desarrollo) para realizar pruebas, enviar los datos en vivo desde En vivo para Probar y, luego, prueba la actualización.
Para aplicar una actualización, haz lo siguiente:
- Accede a Pantheon en https://dashboard.getpantheon.com/ y selecciona tu sitio.
- Selecciona el entorno Dev.
- Selecciona la entrada de menú </>Código que se encuentra a la izquierda. Si alguna actualización de Apigee disponibles, están enumerados.
- Aplica la actualización:
-
Selecciona la casilla de verificación Run update.php after pulling code.
-
Si está disponible, selecciona el código Clear caches after pulling (Borrar cachés después de extraerlo). .
-
Selecciona el botón Implementar código.
-
- Cuando se complete la actualización, selecciona el elemento de menú Estado en la a la izquierda del panel.
- En el área Estado de un entorno, es posible que veas un error de
actualización de la base de datos, como se muestra a continuación:
Si ves este error en cualquier entorno, actualiza la base de datos de forma manual:
- Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
- Selecciona el ícono de la página principal > Ejecuta actualizaciones en la esquina superior izquierda de la portal.
- Sigue las instrucciones para actualizar tu base de datos.
- Envía los cambios de código al entorno de Test y, luego, al Publicada, tal como se describió anteriormente.
Migra tus funciones personalizadas
Si agregas código personalizado o funciones al portal, debes decidir cómo mantenerlos y cómo pasar de la etapa de desarrollo a prueba y la de en vivo entornos de prueba.
Para el código del repositorio de Git, puedes usar el proceso que se describe en Implementa código en los entornos de tu portal para migrar el código de Dev a Test y Live.
Si creaste una configuración personalizada, usa uno de los siguientes métodos para migrar con ellos:
| Método | Descripción |
| Exporta tu configuración al código | Muchas configuraciones comunes son “exportables” al codificar con el módulo Funciones. Por ejemplo: vistas, paneles, caché de imágenes, etcétera. |
Implementa la función hook_update_N() |
Drupal administra los cambios en la base de datos y la configuración con la función hook_update_N().
Si tienes un módulo personalizado, puedes hacer lo siguiente:
|
Consulta también Cómo usar el Panteón Flujo de trabajo, que proporciona una descripción general sobre cómo desarrollar, probar y enviar tu sitio. Incluido en ese artículo es la sección en Administración de configuración.
Configura un dominio personalizado
Los nombres de dominio que Apigee proporciona para un portal de forma predeterminada es apigee.io, como
descritos en Cómo administrar tus entornos, que puede no ser lo que
que deseas exponer a tus clientes.
Con los planes de portales pagados, se puede configurar un nombre de dominio personalizado para el portal (desarrollador o no pueden crear un dominio personalizado). Para usar un dominio personalizado, crea un CNAME en tu DNS y dirigir tu dominio a edge.apigee.getpantheon.com
Por ejemplo, para configurar el dominio personalizado de una empresa llamada Mytech, sigue estos pasos:
- Establece la siguiente configuración de DNS:
developer.mytech.com. 3600 EN CNAME Edge.apigee.getpantheon.com
Este cambio de DNS puede tardar hasta 48 horas en aplicarse en todos los dispositivos cliente. - Use la entrada del menú Dominios / SSL ubicada del lado izquierdo de la
para agregar este dominio a tu panel de Pantheon para
solo en el entorno Live.
En la mayoría de los casos, solo se configura el DNS para el entorno En vivo, no para para Dev y Test. No debes usar los entornos de Dev o Test para producción.
Para obtener más información, consulta la documentación de Pantheon aquí.
Agrega administradores del portal
Cuando recibas el correo electrónico de Apigee que indica que tu portal está listo, Apigee ya tendrá configuró la lista de administradores del portal. Para ver esa lista, selecciona el vínculo Equipo ubicado en la esquina superior derecha del panel del sitio.
Para agregar administradores adicionales, consulta Cómo crear usuarios administradores.
Creando una copia de seguridad de tu portal
Para crear una copia de seguridad de tu portal, usa la pestaña Backups (Copias de seguridad) en el panel de Pantheon. Tú puede crear copias de seguridad automáticas o a pedido. En Pantheon, una copia de seguridad consta de tres archivos: base de datos, archivos y código.
Para obtener más información, consulta Copias de seguridad. Herramienta en la documentación de Pantheon.
Cómo suscribirse a las actualizaciones de estado
Puedes suscribirte a las actualizaciones de estado y versión de Apigee en status.apigee.com. Haz clic en Suscribirse a actualizaciones y, luego, ingresa tu información de contacto, como el correo electrónico. y haz clic en Suscribirse. En la notificación por correo electrónico página de administración, asegúrate de que esté seleccionada la opción Portal para desarrolladores, activa otros parámetros de configuración de notificaciones según sea necesario y haz clic en Actualizar preferencias.
Puedes suscribirte a las actualizaciones de estado y a los informes de incidentes de Pantheon. como cuando se produce una interrupción, en http://status.getpantheon.com. Haz clic en Suscribirse a Actualizaciones para registrarse.