Se usó la API de Cloud Translation para traducir esta página.

Instalación del portal de servicios para desarrolladores

Portal de servicios para desarrolladores v. 4.16.05

Sigue estos pasos para instalar el portal de servicios de canal para desarrolladores.

Antes de continuar con la instalación, crea una copia de seguridad de toda la raíz web de Drupal . La ubicación de instalación predeterminada es /var/www/html, pero es posible que la hayas cambiado. durante la instalación. Luego de realizar los pasos de instalación que se describen a continuación, puedes restablecer tu de la copia de seguridad.

1. Obtén el paquete de servicios de canal para desarrolladores

Vaya a http://community.apigee.com/content/apigee-customer-support y selecciona Acceder a tu Portal de asistencia para solicitar el archivo .tar de los Servicios de canal del desarrollador en una de estas dos maneras:

Solicita acceso al directorio de descarga de Edge para la nube privada.
Solicita una URL al archivo .tar de los Servicios de canal para desarrolladores.

2. Asegúrate de que tu sistema cumpla con las requisitos

Antes de instalar el portal, tu servidor debe cumplir con los siguientes requisitos:

Asegúrate de realizar la instalación en la versión de 64 bits de una versión compatible de Red Hat Enterprise Linux, Oracle o CentOS. Consulta la lista de versiones compatibles aquí.
Asegúrate de que Yum esté instalado.
(Para la instalación en un servidor sin conexión a Internet) Debes hacer lo siguiente: primero descarga todos los archivos necesarios en un servidor con conexión a Internet como una sola .tar.gz. Luego, copia ese archivo .tar.gz en el servidor sin conexión a Internet para realizar la instalación.
1. Accede a un servidor con una conexión a Internet como raíz o como superusuario.
2. Crea un directorio para los archivos de instalación, como portal_tar.
3. Agrega el CD al directorio nuevo y descarga los servicios de canal para desarrolladores DeveloperServices_x.y.z.tar en el que x.y.z corresponde al número de versión del portal.
4. Extrae el contenido del archivo .tar de los servicios de canal del desarrollador con el comando:
  > tar -xvf <tar file>
5. CD a DeveloperServices-4.x.y.z.
6. Crea el archivo .tar.gz del portal con el comando:
  > ./non-networked-install.sh
  
  Ese comando descarga todos los archivos necesarios y los carga en un solo archivo .tar.gz. Tú Luego, copia ese archivo .tar.gz en tu servidor que no tenga conexión a Internet para completar instalar.
Para probar tu conexión con el servidor de administración perimetral, ejecuta el siguiente comando cURL desde un símbolo del sistema en el servidor del portal:
> curl -u {EMAIL}:{PASSWORD} https://{hostname}:8080/v1/organizations/{ORGNAME}

Donde EMAIL y PASSWORD son el correo electrónico dirección y contraseña del administrador de ORGNAME.

Asegúrate de especificar el nombre de host y el número de puerto específicos de tu instalación de Edge. Puerto El puerto predeterminado que usa Edge es 8080. Si te estás conectando a una organización en la nube, entonces la URL de la solicitud es:
https://api.enterprise.apigee.com/v1/organizations/{ORGNAME}

Si se ejecuta de forma correcta, este comando muestra una respuesta similar a la siguiente:
{
“creado en” : 1348689232699,
"creadoPor" : "USERNAME",
"displayName" : “cg”,
"entornos" : [ "prueba", "prod" ],
“lastModifiedAt” : 1348689232699,
“lastModifiedBy” : "foo@bar.com",
"nombre" : “cg”,
"propiedades" : {
"propiedad" : [ ]
},
"tipo" : “prueba”
}

3. Instala el desarrollador Servicios de canal con la secuencia de comandos de instalación automática

Usa el siguiente procedimiento para instalar el portal con la secuencia de comandos de instalación automática. Esta funciona para servidores con o sin conexión externa a Internet.

Accede al servidor como raíz o como superusuario.
Crea un directorio para los archivos de instalación, como portal.
En un servidor con conexión a Internet:
1. CD al nuevo portal y descarga el archivo de Servicios de canal para desarrolladores DeveloperServices_x.y.z.tar en el que x.y.z corresponde al número de versión del portal.
  
  Puedes descargar un archivo desde el vínculo que te envió Apigee en un navegador o copiarlo. y, luego, agregarla al siguiente comando cURL:
  > curl -kOL <paste link here>
2. Extrae el contenido del archivo .tar de los servicios de canal del desarrollador con el comando:
  > tar -xvf <tar file>
3. CD a DeveloperServices-4.x.y.z.
4. Ejecuta la secuencia de comandos de instalación con el siguiente comando:
  > ./networked-install.sh
En un servidor sin conexión a Internet:
1. Copia el archivo .tar.gz que creaste en la sección 2. Asegúrate de que tu sistema cumpla con los requisitos del sistema.
2. Extrae el contenido del archivo .tar.gz con el siguiente comando:
  > tar -xvf <tar file>
3. CD al directorio que creó el comando tar.
4. Configura los permisos en la secuencia de comandos install-from-rpm-bundle.sh:
  > chmod 755 install-from-rpm-bundle.sh
5. Ejecuta la secuencia de comandos install-from-rpm-bundle.sh de la siguiente manera: con el comando:
  > ./install-from-rpm-bundle.sh
Responde las indicaciones.
Una vez finalizada la instalación, navega a la URL del servidor en un navegador, como como:
http://localhost. O bien, si tienes una dirección IP o DNS ve a http://IP_address o http://DNS_name.

Se te redireccionará a la página de configuración de la base de datos del perfil de Apigee.

Nota: Por lo general, ya habrás configurado un nombre de host y lo registraste. con tu servidor DNS para que no tengas que usar http://localhost.
Configurar la conexión a MySQL Si MySQL está en una máquina remota, expande el Opciones avanzadas y, luego, ingresa la información de conexión a esa máquina. Luego, selecciona Guardar y continuar.
Ingresa la siguiente información para configurar la conexión con el extremo de Apigee. Luego, selecciona Guardar:
Para obtener más información sobre estos valores, consulta "Información necesaria antes de iniciar la instalación" en el portal de servicios para desarrolladores empresariales.
1. Organización del portal para desarrolladores
2. URL del extremo del portal para desarrolladores
3. Usuario autenticado del extremo
4. Usuarios autenticados Contraseña
Cuando se te solicite, selecciona el botón Install Sample SmartDocs WADL para instalar el WADL de SmartDocs de muestra. Si omites este paso, la API de SmartDocs de ejemplo no en tu portal.
Nota: Si tu portal se conecta a una instalación de Apigee Edge for Private Cloud y esa instalación de Edge no tiene conexión externa a Internet, debes realizar configuración adicional del módulo SmartDocs antes de poder usar SmartDocs. Para ver más para obtener más información sobre SmartDocs, consulte http://apigee.com/docs/developer-services/content/using-smartdocs-document-apis.
Establece la configuración del servidor SMTP. Apigee requiere que configures un Servidor SMTP para enviar mensajes de correo electrónico desde el portal.
Para obtener más información, consulta http://apigee.com/docs/developer-services/content/configuring-email.
Para configurar el usuario administrador, ingresa la siguiente información y, luego, selecciona Guardar. Ten en cuenta que Drupal creó un usuario administrador llamado "admin" de forma predeterminada, no uses “admin” como el nombre de usuario.
Si omites este paso, podrás usar Drush para crear un administrador como se describe a continuación. en 4. Crea un usuario administrador.
1. Nombre y apellido del desarrollador
2. Nombre de usuario del portal del desarrollador
3. Contraseña
4. Dirección de correo electrónico
Una vez finalizada la instalación, configura los permisos en el archivo settings.php:
> chmod 640 /var/www/html/sites/default/settings.php
Navega a la página principal del portal en http://localhost/ o al nombre de DNS de tu portal.
Accede al portal con las credenciales de administrador.

4. Crea un usuario administrador

Usa Drush para crear un usuario administrativo para la instalación de los Servicios de canal del desarrollador. Drupal crea automáticamente un usuario administrador llamado "admin" de forma predeterminada, no uses “admin” como nombre de usuario.

CD a tu directorio drupal_root/sites/default. La ubicación estándar de la raíz de Drupal el directorio es /var/www/html:
> cd <drupal_root>/sites/default
Asegúrate de tener permisos de escritura en los archivos privados de Drupal:
> drush vget file_private_path

Este comando muestra la ruta de acceso a los archivos privados de Drupal, por ejemplo:
file_private_path: “sites/default/private”

Corresponde a /var/www/html/sites/default/private/. Usa el siguiente comando para asegurarte de que El propietario y el grupo pueden escribir en este directorio:
chmod -R g+w dirPathAndName
chmod -R o+r dirPathAndName
Ingresa los siguientes comandos para crear un usuario administrador; reemplaza los comandos en “< >”. por tus valores:
> crear usuario-drush <nombredeusuario> --mail="<email-address>" --password="<password>"
> drush Administrador de agregar rol de usuario <nombre de usuario>
Accede al portal para desarrolladores como administrador con el nombre de usuario y la contraseña especificados. arriba.

5. Configura la contraseña raíz de MySQL

Si instalaste MySQL como parte de la instalación del portal, la secuencia de comandos de instalación deja el La contraseña raíz de MySQL se estableció en su valor predeterminado, que está en blanco.

Usa el siguiente comando para establecer la contraseña raíz:

> mysqladmin -u root password NEWPASSWORD

Si ya configuraste la contraseña raíz y quieres cambiarla, usa el siguiente comando: :

> mysqladmin -u root -p'OLDPASSWORD' password NEWPASSWORD

También debes actualizar la contraseña en el archivo /var/www/html/sites/default/settings.php .

6. Asegúrate de que el módulo Administrador de actualizaciones esté habilitado

Para recibir notificaciones sobre actualizaciones de Drupal, asegúrate de que el módulo del administrador de actualizaciones de Drupal esté habilitado. En el menú de Drupal, selecciona Módulos y desplázate hacia abajo hasta Administrador de actualizaciones. Si no está habilitada, habilítala.

Una vez habilitadas, puedes ver las actualizaciones disponibles en Informes > Disponibles actualizaciones. También puedes usar el siguiente comando "Drush":

> drush pm-info update

Utiliza la pestaña Informes > Actualizaciones disponibles > Elemento de menú de configuración el módulo para enviarte un correo electrónico cuando haya actualizaciones disponibles y para establecer la frecuencia de la búsqueda actualizaciones.

7. Opcional: Implementa en una producción servidor

Si implementas el portal en un servidor de producción, debes aplicar medidas de seguridad adicionales pasos, como los siguientes:

Ejecuta la siguiente secuencia de comandos para proteger tu instalación de MySQL:
> /usr/bin/mysql_secure_installation

Esta secuencia de comandos establece la contraseña raíz y te da la opción de restringir el acceso raíz solo a localhost y quitar las bases de datos de prueba y el usuario anónimo creado de forma predeterminada. Ejecutando esto para los servidores de producción.
Si tus políticas corporativas lo requieren, habilita y configura SELinux.

8. Configura Apache Solr (opcional) motor de búsqueda

De forma predeterminada, los módulos de Drupal que se conectan al motor de búsqueda Apache Solr se inhabilitan cuando instalas el portal. La mayoría de los portales usan el motor de búsqueda interno Drupal y, por lo tanto, no requieren los módulos de Drupal Solr.

Si decides usar Solr como motor de búsqueda, debes instalarlo de forma local en tu servidor. y, luego, habilitaremos y configuraremos los módulos de Drupal Solr en el portal.

Sigue estos pasos para habilitar los módulos de Drupal Solr:

Accede a tu portal como un usuario con privilegios de administrador o de creación de contenido.
Selecciona Módulos en el menú de Drupal.
Habilitar el módulo del framework de Apache Solr y Apache Solr Search.
Guarda los cambios.
Configura Solr como se describe en https://drupal.org/node/1999280.

9. Opcional: Instala mod_ssl para admitir HTTPS

El servidor HTTP de Apache usa el módulo mod_ssl para entregar páginas web a través de HTTPS. Si si quieres usar HTTPS, usa el siguiente comando para instalar mod_ssl:

> yum install mod_ssl

Si desea obtener más información sobre cómo configurar el portal para usar SSL, consulte http://apigee.com/docs/developer-services/content/using-ssl-portal.

10. Opcional: instalar SmartDocs

SmartDocs te permite documentar tus APIs en el portal de servicios para desarrolladores de una manera que hace que documentación de API completamente interactiva. Sin embargo, para usar SmartDocs con el portal, primero debes instalar SmartDocs en Edge.

Si conectas el portal a una instalación de Edge Cloud, SmartDocs ya está y no es necesario configurarlo.
Si conectas el portal a un perímetro para instalar una nube privada, debes asegurarte que SmartDocs está instalado en Edge. Para obtener más información sobre cómo instalar Edge y SmartDocs, consulta Cómo instalar SmartDocs.

Para obtener más información sobre SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.

11. ¿Qué debo hacer?

Después de instalar el portal de servicios para desarrolladores, sigue los pasos que se indican a continuación: configurar y personalizar según tus requisitos específicos. La documentación del sitio web de Apigee contiene más información sobre la configuración, el estilo y la administración de un portal. Acceda a la documentación en http://apigee.com/docs/developer-services/content/what-developer-portal.

En la siguiente tabla, se enumeran algunas de las tareas más comunes que realizas después de la instalación: y se incluyen vínculos a la documentación de Apigee donde puedes encontrar más información:

Tarea	Descripción
La personalización del tema	El tema define la apariencia del portal, incluidos los colores, el estilo y otras aspectos visuales.
Personaliza apariencia	La página principal incluye el menú principal, el mensaje de bienvenida, el encabezado, el pie de página y el título.
Agregar y administrar cuentas de usuario	El proceso de registro controla cómo los nuevos desarrolladores registran una cuenta en la portal. Por ejemplo, ¿los desarrolladores nuevos obtienen acceso inmediato al portal?, un administrador debe verificarla. Este proceso también controla cómo se crea el administrador recibe una notificación cuando se crea una cuenta nueva.
Configuración correo electrónico	El portal envía correos electrónicos en respuesta a ciertos eventos. Por ejemplo, cuando un nuevo El desarrollador se registra en el portal y cuando pierde su contraseña.
Agregar y administrar cuentas de usuario	Agrega las Condiciones y página de condiciones que los desarrolladores deben aceptar para poder acceder al portal.
Agregar y administrar cuentas de usuario	En el portal, se implementa un modelo de autorización basado en roles. Antes de permitir que los desarrolladores de registro, definir los permisos y roles que usa el portal.
Agregar blog y publicaciones de foros	El portal tiene compatibilidad integrada con blogs y foros de múltiples conversaciones. Define los permisos para ver, agregar, editar y borrar entradas de blogs y foros.
Asegúrate de hacer copias de seguridad de la base de datos.	Asegúrate de crear una copia de seguridad de la base de datos de Drupal. Ten en cuenta que debido a que cada instalación es diferente, depende de ti determinar la mejor manera de respaldar el en la base de datos.
Configura un nombre de host	Si no configuras un nombre de host en tu servidor DNS, siempre podrás acceder al sitio a través de la dirección IP del servidor. Si quieres usar un nombre de host, puedes configurar el DNS para que debería funcionar correctamente sin ninguna otra configuración básica. Si configuras un balanceador de cargas o recibes URLs incorrectas en tu sitio para algunos Por otro lado, puedes configurar $base_url en el archivo settings.php del portal para desarrolladores. que se encuentra de forma predeterminada en el archivo /var/www/html/sites/default .