Edge for Private Cloud w wersji 4.17.09
Host wirtualny w Edge definiuje domeny i porty przełącznika Edge, na których jest dostępne serwera proxy API, a także, w rozszerzeniu, adres URL, którego aplikacje używają do uzyskiwania dostępu do serwera proxy API. Host wirtualny określa też, czy dostęp do serwera proxy API jest uzyskiwany za pomocą protokołu HTTP, czy szyfrowanego protokołu HTTPS.
W ramach procesu wdrażania Edge musisz utworzyć organizację, środowisko i host wirtualny. Aby ułatwić ten proces nowym użytkownikom, Edge udostępnia polecenie setup-org.
Podczas tworzenia hosta wirtualnego musisz podać te informacje:
- Nazwa hosta wirtualnego, którego używasz w odniesieniu do niego na serwerach proxy interfejsu API.
- Port na routerze dla hosta wirtualnego. Zwykle liczba portów zaczyna się od 9001 i zwiększa się o 1 dla każdego nowego hosta wirtualnego.
- Alias hosta wirtualnego hosta. Zwykle jest to nazwa DNS wirtualnego hosta.
Na przykład w pliku konfiguracyjnym przekazanym do polecenia setup-org możesz podać te informacje w ten sposób:
# Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myapis.apigee.net
W ramach określania proxy interfejsu API, które ma obsłużyć żądanie, Edge Router porównuje nagłówek Host przychodzącego żądania z listą dostępnych aliasów hosta. Gdy wysyłasz żądanie za pomocą hosta wirtualnego, podaj nazwę domeny, która odpowiada aliasowi hosta hosta wirtualnego, lub podaj adres IP routera i nagłówek Host zawierający alias hosta.
Jeśli na przykład utworzysz hosta wirtualnego z aliasem hosta myapis.apigee.net na porcie 9001, żądanie cURL do interfejsu API za pomocą tego hosta wirtualnego może mieć jeden z tych formatów:
- Jeśli masz wpis DNS dla myapis.apigee.net:
curlhttp://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - Jeśli nie masz rekordu DNS dla adresu myapis.apigee.net:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
W tym formularzu podajesz adres IP routera i przekazujesz alias hosta w polu nagłówka Host.
Uwaga: komenda cURL, większość przeglądarek i wiele innych narzędzi automatycznie dołącza nagłówek Host z domeną jako część żądania, więc możesz użyć komendy cURL w formie:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Opcje, gdy nie masz rekordu DNS dla hosta wirtualnego
Jeśli nie masz wpisu DNS, możesz ustawić alias hosta jako adres IP routera i port hosta wirtualnego w formacie <adresIP routera>:port. Przykład:
VHOST_ALIAS=192.168.1.31:9001
Następnie utwórz polecenie curl w postaci:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Ta opcja jest preferowana, ponieważ dobrze współpracuje z interfejsem Edge.
Jeśli masz kilka routerów, dodaj alias hosta dla każdego z nich, podając adres IP każdego routera i port hosta wirtualnego:
# Specify the IP and port of each router as a space-separated list enclosed in quotes: # VHOST_ALIAS="192.168.1.31:9001 192.168.1.32:9001"
Możesz też ustawić alias hosta na wartość, np. temp.hostalias.com. Wtedy musisz przekazać nagłówek Host w każdym żądaniu:
curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'host: temp.hostalias.com'
Możesz też dodać alias hosta do pliku /etc/hosts. Na przykład dodaj ten wiersz do pliku /etc/hosts:
192.168.1.31 temp.hostalias.com
Następnie możesz wysłać żądanie tak, jakby miał wpis DNS:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}