WSO2 API Manager je brána API založená na Open Source, která umožňuje vývojovým týmům nasazovat a monitorovat rozhraní API a také poskytuje spotřebitelům možnost přihlásit se k odběru rozhraní API a využívat je podle svých potřeb. Proč by někdo potřeboval API Manager? No, to je dobrá otázka. Představte si organizaci, která zveřejňuje své základní procesy, data a služby jako rozhraní API, a externí agentury nebo strany mohou tato rozhraní API využívat k vytváření svých aplikací. Tímto způsobem může podnik zlepšit svůj růstový potenciál prostřednictvím svých API. Ale co když mají podniky příliš mnoho API vystavených veřejnosti? Jak je budou spravovat, zabezpečení, výkon, protokolování, monitorování, analýzy, zásady atd. K tomu jsou brány API a WSO2 API-M je jedním z oblíbených produktů v této doméně. API Manager usnadňuje kompletní správu API; Tvorba API, publikování, správa životního cyklu, verzování, zabezpečení, vyrovnávání zátěže a správa převzetí služeb při selhání, monetizace a analýzy. No, v tomto tutoriálu budeme instalovat WSO2 API Manager 4.0.0 a na CentOS 7.9.
Předpoklady:
- Minimálně 4 GB RAM a 10 GB místa na disku. Pokud instalujete na virtuální počítač, pak minimálně 2 VCPU.
- OpenJDK. Před instalací možná budete muset zkontrolovat kompatibilitu verze. Pro WSO2 verze 4.0.0 potřebujete OpenJDK verze 8, 11.
- Apache Ant 1.7.0 nebo novější
Instalace WSO2 API Manager na CentOS
Instalace předpokladů:
Instalace OpenJDK 11 na CentOS
Krok 1 :Připravte svůj počítač pomocí nejnovějšího úložiště balíčků
# yum update
Krok 2:Nainstalujte OpenJDK přes yum
# yum install java-11-openjdk-devel
Krok 3:Nainstalujte OpenJRE 11
# yum install java-11-openjdk
Krok 4:Ověřte, zda je Java úspěšně nainstalována
# 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)
Krok 5:Nastavte JAVA_HOME proměnná prostředí
# 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
Zkopírujte cestu Java z výše uvedeného výstupu a nastavte JAVA_HOME proměnná v /etc/bashrc nebo /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
Krok 6:Nainstalujte 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/
Krok 7:Nastavte ANT_HOME v bashrc nebo bash_profile
export ANT_HOME=/opt/apache-ant-1.10.11 export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$PATH
Zkontrolujte verzi Apache ANT
# ant -version Apache Ant(TM) version 1.10.11 compiled on July 10 2021
Krok 8:Vytvořte nového uživatele pro spuštění WSO2 API Manager
# adduser apigw
Krok 9:Přepněte na 'apigw' uživatele a Stáhněte si Správce rozhraní API
Navštivte tento odkaz a stáhněte si API Manager 4.0.
$ unzip wso2am-4.0.0.zip
Krok 10 :Nastavte název hostitele nebo název domény pro použití v /etc/hosts
127.0.0.1 localhost localhost.localdomain wso2.tg.com <local_ip_address> wso2.tg.com
Poznámka :Nezapomeňte nahradit <local_ip_address> se skutečnou IP adresou.
Krok 11:Konfigurace souboru deployment.toml
Ověřte konfigurace v wso2am-4.0.0/repository/conf/deployment.toml . Pokud nastavujete WSO2 úplně poprvé, možná nebudete muset v tomto souboru moc měnit kromě níže uvedeného.
[server] hostname = "<domain_name/hostname>"
např.
[server] hostname = "wso2.tg.com"
Krok 12:Spusťte API-Manager
Nezapomeňte spustit správce API jako místní uživatel (apigw) a ne jako „root“.
$ ./bin/api-manager.sh
Výše uvedený příkaz spustí správce API jako proces na popředí, který umožňuje zobrazit zprávy a chyby vytištěné na stdout . Když začnete v popředí, uvidíte chyby a v případě potřeby je opravíte.
V ideálním případě by však správce API měl být spuštěn jako démon s použitím možností spuštění a zastavení, jak je uvedeno níže:
$ ./bin/api-manager.sh -start
$ ./bin/api-manager.sh -stop
$ ./bin/api-manager.sh - restart
Podívejte se na soubory protokolů pod wso2am-4.0.0/repository/logs složka.
- wso2carbon.log
- wso2-apigw-errors.log
- wso2-apigw-service.log
- audit.log
- http_access_.2021-09-08.log
V případě, že se API manager nespustí, pak wso2carbon.log a wso2-apigw-errors.log poskytne více informací.
Zkontrolujte, zda API Manager funguje správně.
Zkuste přejít na následující adresy URL,
- Carbon – https://
:9443/carbon
- Adresa URL vydavatele – https://
:9443/publisher
- Portál pro vývojáře – https://
:9443/devportal
Pokud vše půjde dobře, měli byste vidět rozhraní. Výchozí uživatelské jméno je „admin“ a heslo je „admin“.
Poznámka :Výchozí databáze používaná ve WSO2 je H2. WSO2 by však měl být integrován s databází MySQL pro produkční prostředí. Tomu se budeme věnovat v samostatném článku.