WSO2 API Manager è un gateway API basato su Open Source che consente ai team di sviluppo di distribuire e monitorare le API e fornisce anche una struttura per i consumatori di abbonarsi alle API e consumare per soddisfare le loro esigenze. Perché qualcuno dovrebbe aver bisogno di un gestore API? Bene, questa è una buona domanda. Immagina un'organizzazione che espone al pubblico i suoi processi, dati e servizi principali come API e le agenzie o le parti esterne possono utilizzare queste API per creare le proprie applicazioni. In questo modo l'azienda può migliorare il proprio potenziale di crescita attraverso le sue API. Ma cosa succede se le aziende hanno troppe API esposte al pubblico? Come gestiranno quelli, la sicurezza, le prestazioni, la registrazione, il monitoraggio, l'analisi, le politiche, ecc... I gateway API hanno lo scopo di farlo e WSO2 API-M è uno dei prodotti popolari in quel dominio. L'API Manager facilita la completa governance dell'API; Creazione di API, pubblicazione, gestione del ciclo di vita, controllo delle versioni, sicurezza, bilanciamento del carico e gestione del failover, monetizzazione e analisi. Bene, in questo tutorial installeremo WSO2 API Manager 4.0.0 e su CentOS 7.9.
Prerequisiti:
- Minimo di 4 GB di RAM e 10 GB di spazio su disco. Se stai installando su una VM, almeno 2 VCPU.
- OpenJDK. Potrebbe essere necessario verificare la compatibilità della versione prima di installarla. Per WSO2 versione 4.0.0, è necessario OpenJDK versione 8, 11.
- Apache Ant 1.7.0 o successivo
Installazione di WSO2 API Manager su CentOS
Installazione dei prerequisiti:
Installazione di OpenJDK 11 su CentOS
Passaggio 1 :prepara la tua macchina con l'ultimo repository di pacchetti
# yum update
Passaggio 2:installa OpenJDK tramite yum
# yum install java-11-openjdk-devel
Passaggio 3:installa OpenJRE 11
# yum install java-11-openjdk
Passaggio 4:verifica che Java sia installato correttamente
# 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)
Passaggio 5:imposta JAVA_HOME variabile d'ambiente
# 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
Copia il percorso di Java dall'output sopra e imposta il JAVA_HOME variabile in /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
Passaggio 6:installa 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/
Passaggio 7:imposta ANT_HOME in bashrc o bash_profile
export ANT_HOME=/opt/apache-ant-1.10.11 export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
Controlla la versione di Apache ANT
# ant -version Apache Ant(TM) version 1.10.11 compiled on July 10 2021
Passaggio 8:crea un nuovo utente per eseguire WSO2 API Manager
# adduser apigw
Passaggio 9:passa a 'apigw' utente e Scarica Gestione API
Visita questo link e scarica API Manager 4.0.
$ unzip wso2am-4.0.0.zip
Passaggio 10 :imposta il nome host o il nome di dominio da utilizzare in /etc/hosts
127.0.0.1 localhost localhost.localdomain wso2.tg.com <local_ip_address> wso2.tg.com
Nota :Ricordarsi di sostituire <local_ip_address> con un indirizzo IP effettivo.
Passaggio 11:configura il file deployment.toml
Verifica le configurazioni in wso2am-4.0.0/repository/conf/deployment.toml . Se stai configurando WSO2 per la prima volta, potrebbe non essere necessario modificare molto in questo file tranne quanto segue.
[server] hostname = "<domain_name/hostname>"
ad esempio,
[server] hostname = "wso2.tg.com"
Passaggio 12:avvia API-Manager
Ricorda di avviare il gestore API come utente locale (apigw) e non come "root".
$ ./bin/api-manager.sh
Il comando precedente avvierà il gestore API come processo in primo piano consentendo di vedere i messaggi e gli errori stampati su stdout . Iniziando in primo piano, puoi vedere gli errori e correggerli se necessario.
Ma idealmente, il gestore API dovrebbe essere eseguito come un demone utilizzando le opzioni di avvio e arresto come mostrato di seguito:
$ ./bin/api-manager.sh -start
$ ./bin/api-manager.sh -stop
$ ./bin/api-manager.sh - restart
Cerca i file di log in wso2am-4.0.0/repository/logs cartella.
- wso2carbon.log
- wso2-apigw-errors.log
- wso2-apigw-service.log
- audit.log
- http_access_.2021-09-08.log
Nel caso in cui il gestore API non si avvii, allora wso2carbon.log e wso2-apigw-errors.log fornirà maggiori informazioni.
Verifica se API Manager funziona correttamente.
Prova ad accedere ai seguenti URL,
- Carbonio – https://
:9443/carbon
- URL dell'editore – https://
:9443/editore
- Portale per sviluppatori – https://
:9443/devportal
Se tutto va bene, dovresti essere in grado di vedere l'interfaccia. Il nome utente predefinito è "admin" e la password è "admin".
Nota :Il database predefinito utilizzato in WSO2 è H2. Tuttavia, WSO2 dovrebbe essere integrato con il database MySQL per gli ambienti di produzione. Ne discuteremo in un articolo separato.