Requisitos del portal de servicios para desarrolladores

Portal de servicios para desarrolladores v. 4.16.05

A continuación, se indican los requisitos de hardware y software para la instalación.

Hardware

Requisito

Sistema operativo

Estas instrucciones de instalación y los archivos de instalación proporcionados se probaron en los sistemas operativos que se indican aquí: https://apigee.com/docs/api-services/reference/supported-software

RAM

1 GB

Disco duro

10 GB

Interfaz de red

Se requiere una conexión a Internet activa.

Como parte del proceso de instalación, el instalador descarga recursos de la Web. Si tu entorno está configurado para enviar solicitudes HTTP y HTTPS salientes a través de un proxy, este debe estar configurado para controlar correctamente las solicitudes redireccionadas que puedan ocurrir durante una descarga.

Por ejemplo, una solicitud a https://drupal.org/ devuelve un código de estado HTTP 301 y redirecciona a https://www.drupal.org/.

Tu proxy debe estar configurado para devolver un código de estado HTTP 200 con el contenido solicitado de la redirección.

En el caso de las instalaciones de SAP, si tu entorno está configurado para enviar solicitudes HTTPS salientes a través de un proxy, este debe admitir TLSv1.0. OpenSSL 0.9.8 no admite TLSv1.1 ni TLSv1.2, solo TLSv1.0.

Requisitos de la base de datos de MySQL

Si eliges instalar el servidor de MySQL en la misma máquina que los servicios del canal para desarrolladores, la topología de una sola máquina, el instalador de los servicios del canal para desarrolladores te solicitará que ingreses el nombre de la base de datos y el usuario de la base de datos. Luego, instalará el servidor de MySQL y creará el esquema de la base de datos por ti. La versión instalada es la última versión disponible para tu SO.

Si deseas que el servidor de MySQL se instale en un sistema independiente, debes haber instalado el servidor de MySQL en ese sistema antes de iniciar el instalador de los Servicios del canal para desarrolladores. Debes tener instalado MySQL 5.0.15 o una versión posterior.

El instalador de Developer Channel Services requiere que MySQL Server contenga una base de datos con un esquema de base de datos vacío. El instalador de Developer Channel Services te solicita el nombre de host, el nombre y el usuario de la base de datos. Luego, el instalador se conecta a la base de datos para crear las tablas y los datos predeterminados de la base de datos.

Los servicios de canal para desarrolladores usan el usuario de la base de datos para conectarse a la base de datos y deben tener los siguientes privilegios: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES.

Por ejemplo, para crear una base de datos llamada devportal y un usuario llamado devportal, haz lo siguiente:

  1. Instala el servidor MySQL en el sistema.
  2. Accede a MySQL como usuario raíz con el siguiente comando:
    > mysql -u root -p
  3. Ingresa la contraseña raíz cuando se te solicite.
  4. En el mensaje mysql>, ingresa lo siguiente para crear el usuario de devportal:
    mysql>create user 'devportal'@'localhost' identified by 'devportal';
    mysql> grant all privileges on *.* to 'devportal'@'localhost';
    mysql> flush privileges;
    mysql> quit
  5. En el mensaje del sistema, crea la base de datos devportal:
    > mysqladmin -u devportal -p create devportal

    Ingresa la contraseña de devportal.
  6. Accede a MySQL y otorga acceso a devportal desde la IP del servidor del portal:
    mysql> GRANT ALL ON devportal.* TO devportal@'portalIP' IDENTIFIED BY 'devportalPW';

    en el que portalIP es la dirección IP del servidor del portal y devportalPW es la contraseña del usuario devportal.
  7. Edita /etc/my.cnf para establecer bind-address en la dirección IP del servidor de MySQL.
  8. Reinicia MySQL:
    > /etc/init.d/mysqld restart
  9. Asegúrate de que el puerto 3306 esté abierto en el servidor de MySQL. Este procedimiento se basa en tu sistema operativo. Por ejemplo, para Linux, usa el comando:
    > /sbin/iptables -A INPUT -i eth0 -p tcp --destination-port 3306 -j ACCEPT

Cuando instales Developer Channel Services, especifica que no se instale el servidor de MySQL de forma local. Luego, se te pedirá que ingreses la dirección IP, el nombre de usuario y el nombre de la base de datos remota.

Requisitos de Red Hat Enterprise Linux (RHEL)

RHEL tiene requisitos adicionales debido a que se necesita una suscripción para acceder a las descargas de software de Red Hat. El servidor debe poder conectarse a Internet para descargar RPM a través de yum. Si usas RHEL, el servidor debe estar registrado en Red Hat Network (RHN) y en el canal opcional del servidor.

Los requisitos de Red Hat se verifican durante la instalación y el instalador del portal te indica si RHEL aún no está registrado. Si ya tienes credenciales de acceso de Red Hat, puedes usar el siguiente comando para registrar RHEL antes de comenzar el proceso de instalación:

> subscription-manager register --username=my_username --password=my_password --auto-attach 

Reemplaza my_username y my_password por tus credenciales de Red Hat.

Si tienes una versión de prueba de RHEL, puedes obtener una licencia de prueba de 30 días. Consulta https://access.redhat.com/solutions/32790 para obtener más información.

Requisitos de SMTP

De forma predeterminada, el portal envía correos electrónicos con la función mail() de PHP. PHP intenta enviar correos electrónicos con sendmail en el sistema local, que se puede configurar en el archivo php.ini de PHP.

En un entorno de producción, Apigee requiere que configures un servidor SMTP para enviar mensajes de correo electrónico desde el portal. Por lo tanto, debes asegurarte de que Drupal pueda acceder al puerto necesario en el servidor SMTP. Para SMTP sin TLS, el número de puerto suele ser 25. Para SMTP habilitado para TLS, suele ser 465, pero consulta con tu proveedor de SMTP.

Requisitos adicionales

Para realizar la instalación, el usuario que instala el software debe tener acceso raíz.

Requisitos de la arquitectura de implementación

Developer Channel Services tiene una sola interfaz con el servidor de administración de Apigee a través de una API de REST para almacenar y recuperar información sobre las aplicaciones de un usuario. Los servicios de canal para desarrolladores deberán poder conectarse al servidor de administración a través de HTTP o HTTPS, según la instalación.

Información necesaria antes de comenzar la instalación

Antes de comenzar la instalación, debes tener disponible la siguiente información:

  1. ¿Qué plataforma estás configurando: Red Hat o CentOS? Si se trata de una instalación de Red Hat, la máquina debe estar registrada en Red Hat Network para descargar los RPM.
  2. ¿Tienes pensado instalar MySQL en la máquina local? Algunas instalaciones de HA requieren que MySQL esté en una máquina diferente de la que entrega las páginas web del portal. Si este es el caso, no instales MySQL de forma local. Si deseas una instalación simple con todo en la misma máquina, instala MySQL de forma local.
  3. Si quieres acceder a un servidor MySQL remoto, el nombre de host, el puerto, el nombre de la base de datos, el nombre de usuario y la contraseña del servidor MySQL remoto. El servidor de MySQL remoto ya debería estar configurado antes de que inicies la instalación.
  4. ¿Cuál es el nombre de dominio completamente calificado del servidor web? (Esta información se agregará a /etc/hosts). Debe ser una dirección IP o un nombre de host, como portalserver.example.com. El valor predeterminado es localhost.
  5. ¿Quieres usar la configuración predeterminada de Apigee para el host virtual de Apache? Se crea un host virtual con el nombre de host que especificaste en el paso 7.
  6. Hay tres datos que permiten que tu portal se comunique con el servidor de administración de Apigee Edge. Esta información es la siguiente:
    1. URL del endpoint de API de Apigee Management: Será un nombre de host o una dirección IP. Este es el extremo de REST al que se realizan todas las llamadas para crear apps y registrar desarrolladores para las claves de app. El extremo predeterminado es https://api.enterprise.apigee.com/v1.

      Para una instalación de Edge para la nube privada, la URL tiene el siguiente formato:
      http://EdgeIp:8080/v1

      o:
      https://EdgeIp:SSLport/v1

      Donde EdgeIp es la dirección IP del servidor de administración de Edge y SSLport es el puerto SSL para la API de administración de Edge. Por ejemplo, 8443.
    2. Nombre de la organización de Apigee: Existe una relación entre los portales y las organizaciones de Apigee Edge. Configurarás la organización predeterminada cuando configures el extremo de la API de Management. El valor predeterminado es my-org.
    3. Nombre de usuario y contraseña para el endpoint de API de Management: Un administrador de tu organización debe realizar las llamadas del portal a Edge.

      Este nombre de usuario y contraseña son para un administrador de tu organización y solo deben usarse para conectarse a Edge desde el portal. Por ejemplo, si especificas las credenciales de un usuario y ese usuario se borra en Edge, el portal ya no podrá conectarse a Edge. Por lo tanto, crea un administrador en tu organización solo para esta conexión.

      Por ejemplo:
      dc_devportal+ORGNAME@apigee.com:MyP@ssw0rd