Edge'deki sanal ana makine, bir API proxy'sinin kullanıma sunulduğu alanları ve Edge Router bağlantı noktalarını ve dolayısıyla uygulamaların bir API proxy'sine erişmek için kullandığı URL'yi tanımlar. Sanal ana makine, API proxy'sine HTTP protokolü kullanılarak mı yoksa şifrelenmiş HTTPS protokolü kullanılarak mı erişileceğini de tanımlar.
Edge'e ilk katılım süreci kapsamında bir kuruluş, ortam ve sanal ana makine oluşturmanız gerekir. Edge, yeni kullanıcılar için bu süreci kolaylaştırmak amacıyla setup-org komutunu sunar.
Sanal ana makineyi oluştururken aşağıdaki bilgileri belirtmeniz gerekir:
- API proxy'lerinizde referans vermek için kullandığınız sanal ana makinenin adı.
- Sanal ana makine için yönlendiricideki bağlantı noktası. Bu bağlantı noktaları genellikle 9001'den başlar ve her yeni sanal ana makine için birer birer artar.
- Sanal ana makinenin ana makine takma adı. Genellikle sanal ana makinenin DNS adıdır.
Örneğin, setup-org komutuna iletilen bir yapılandırma dosyasında bu bilgileri şu şekilde belirtebilirsiniz:
# 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
Edge Router, isteği işleyen API proxy'sini belirlemek için gelen isteğin Host başlığını mevcut ana makine takma adları listesiyle karşılaştırır. Sanal ana makine üzerinden istekte bulunurken sanal ana makinenin ana makine takma adıyla eşleşen bir alan adı belirtin veya yönlendiricinin IP adresini ve ana makine takma adını içeren Host üstbilgisini belirtin.
Örneğin, 9001 numaralı bağlantı noktasında myapis.apigee.net ana makine takma adına sahip bir sanal ana makine oluşturduysanız bu sanal ana makine üzerinden bir API'ye gönderilen cURL isteği aşağıdaki biçimlerden birini kullanabilir:
- myapis.apigee.net için bir DNS girişiniz varsa:
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
- myapis.apigee.net için DNS girişiniz yoksa:
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
Bu formda, yönlendiricinin IP adresini belirtir ve ana makine takma adını
Hostüstbilgisinde iletirsiniz.
Sanal ana makine için DNS girişiniz yoksa kullanabileceğiniz seçenekler
DNS girişiniz yoksa ana makine takma adını, yönlendiricinin IP adresine ve sanal ana makinenin bağlantı noktasına (routerIP:port) ayarlayabilirsiniz. Örneğin:
VHOST_ALIAS=192.168.1.31:9001
Ardından aşağıdaki biçimde bir curl komutu oluşturun:
curl http://routerIP:9001/proxy-base-path/resource-path
Yeni Edge kullanıcı arayüzüyle iyi çalıştığı için bu seçenek tercih edilir.
Birden fazla yönlendiriciniz varsa her yönlendirici için bir ana makine takma adı ekleyin ve her yönlendiricinin IP adresini ve sanal ana makinenin bağlantı noktasını belirtin:
# 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"
Alternatif olarak, ana makine takma adını temp.hostalias.com gibi bir değere ayarlayabilirsiniz.
Ardından, her istekte Host üstbilgisini iletmeniz gerekir:
curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'host: temp.hostalias.com'
Alternatif olarak, ana makine takma adını /etc/hosts dosyanıza ekleyebilirsiniz. Örneğin, /etc/hosts alanına şu satırı ekleyin:
192.168.1.31 temp.hostalias.com
Ardından, DNS girişi varmış gibi istekte bulunabilirsiniz:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path