WSO2 API Manager es una puerta de enlace de API basada en código abierto que permite a los equipos de desarrollo implementar y monitorear las API y también proporciona una instalación para que los consumidores se suscriban a las API y consuman para satisfacer sus necesidades. ¿Por qué alguien necesitaría un API Manager? Bueno, esa es una buena pregunta. Imagine una organización que expone sus procesos, datos y servicios centrales como API al público, y las agencias o partes externas pueden consumir estas API para crear sus aplicaciones. De esta forma el negocio puede mejorar sus potenciales de crecimiento a través de sus APIs. Pero, ¿qué pasa si las empresas tienen demasiadas API expuestas al público? ¿Cómo administrarán eso, la seguridad, el rendimiento, el registro, la supervisión, el análisis, las políticas, etc.? Las puertas de enlace API están destinadas a hacer eso y WSO2 API-M es uno de los productos populares en ese dominio. El administrador de API facilita el control completo de la API; Creación de API, publicación, gestión del ciclo de vida, control de versiones, seguridad, equilibrio de carga y gestión de conmutación por error, monetización y análisis. Bueno, en este tutorial instalaremos WSO2 API Manager 4.0.0 y en CentOS 7.9.
Requisitos previos:
- Mínimo de 4 GB de RAM y 10 GB de espacio en disco. Si está instalando en una VM, entonces un mínimo de 2 VCPU.
- OpenJDK. Es posible que deba verificar la compatibilidad de la versión antes de instalarlo. Para WSO2 versión 4.0.0, necesita OpenJDK versión 8, 11.
- Apache Ant 1.7.0 o posterior
Instalando WSO2 API Manager en CentOS
Instalando los requisitos previos:
Instalación de OpenJDK 11 en CentOS
# yum update
Paso 2:Instale OpenJDK a través de yum
# yum install java-11-openjdk-devel
Paso 3:Instale OpenJRE 11
# yum install java-11-openjdk
Paso 4:Verifique que Java se haya instalado correctamente
# java --version openjdk 11.0.12 2021-07-20 LTS OpenJDK Runtime Environment 18.9 (build 11.0.12+7-LTS) OpenJDK 64-Bit Server VM 18.9 (build 11.0.12+7-LTS, mixed mode, sharing)
Paso 5:Configure JAVA_HOME
variable de entorno
# update-alternatives --config java There are 2 programs which provide 'java'. Selection Command ----------------------------------------------- * 1 java-1.8.0-openjdk.x86_64 (/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.302.b08-0.el7_9.x86_64/jre/bin/java) + 2 java-11-openjdk.x86_64 (/usr/lib/jvm/java-11-openjdk-11.0.12.0.7-0.el7_9.x86_64/bin/java) Enter to keep the current selection[+], or type selection number: 2
Copie la ruta de Java de la salida anterior y configure el JAVA_HOME
variable en /etc/bashrc
o /etc/bash_profile
export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-11.0.12.0.7-0.el7_9.x86_64 export PATH=$JAVA_HOME/bin:$PATH
Paso 6:Instalar Apache ANT
# wget https://github.com/wso2/product-apim/releases/download/v4.0.0/wso2am-4.0.0.zip # unzip wso2am-4.0.0.zip # mv apache-ant-1.10.11 /opt/
Paso 7:Establecer ANT_HOME en bashrc o bash_profile
export ANT_HOME=/opt/apache-ant-1.10.11 export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
Comprobar la versión de Apache ANT
# ant -version Apache Ant(TM) version 1.10.11 compiled on July 10 2021
Paso 8:Cree un nuevo usuario para ejecutar WSO2 API Manager
# adduser apigw
Paso 9:Cambiar a 'apigw'
usuario y Descargar Administrador de API
Visite este enlace y descargue API Manager 4.0.
$ unzip wso2am-4.0.0.zip
Paso 10 :Establecer nombre de host o nombre de dominio para usar en /etc/hosts
127.0.0.1 localhost localhost.localdomain wso2.tg.com <local_ip_address> wso2.tg.com
Nota :Recuerde reemplazar el <local_ip_address>
con una dirección IP real.
Paso 11:Configure el archivo deployment.toml
Verifique las configuraciones en wso2am-4.0.0/repository/conf/deployment.toml
. Si está configurando WSO2 por primera vez, es posible que no deba cambiar mucho en este archivo, excepto lo siguiente.
[server] hostname = "<domain_name/hostname>"
por ejemplo,
[server] hostname = "wso2.tg.com"
Paso 12:Inicie el Administrador de API
Recuerde iniciar el administrador de API como usuario local (apigw) y no como 'root'.
$ ./bin/api-manager.sh
El comando anterior iniciará el administrador de API como un proceso de primer plano que permite ver los mensajes y errores impresos en stdout
. Al comenzar en primer plano, puede ver los errores y corregirlos si es necesario.
Pero idealmente, el administrador de API debe ejecutarse como un demonio usando las opciones de inicio y detención como se muestra a continuación:
$ ./bin/api-manager.sh -start
$ ./bin/api-manager.sh -stop
$ ./bin/api-manager.sh - restart
Busque los archivos de registro en wso2am-4.0.0/repository/logs
carpeta.
- wso2carbon.log
- wso2-apigw-errors.log
- wso2-apigw-service.log
- auditoría.log
- http_access_.2021-09-08.log
En caso de que el administrador de API no se inicie, entonces wso2carbon.log
y wso2-apigw-errors.log
proporcionará más información.
Compruebe si API Manager funciona correctamente.
Intente acceder a las siguientes URL,
- Carbono:https://
:9443/carbono
- URL del editor:https://
:9443/editor
- Portal para desarrolladores:https://
:9443/devportal
Si todo va bien, debería poder ver la interfaz. El nombre de usuario predeterminado es 'admin' y la contraseña es 'admin'.
Nota :La base de datos predeterminada utilizada en WSO2 es H2. Sin embargo, WSO2 debe integrarse con la base de datos MySQL para los entornos de producción. Discutiremos esto en un artículo separado.