Bu sayfa, Cloud Translation API ile çevrilmiştir.

Private Cloud için sanal ana makineler yapılandırma

Apigee Edge belgelerini görüntülüyorsunuz.
. Git: Apigee X belgeleri. bilgi

Şirket içi yüklemelerde sanal ana makineler üzerinde tam denetime sahip olursunuz. Proje bilgilerini herhangi bir kuruluş için, herhangi bir ortamda, TLS kullanan veya kullanılmayan sanal ana makineler.

Bu dokümanda, basit bir sanal ana makinenin nasıl oluşturulacağı açıklanmaktadır. Yani, ihtiyaçlarınız TLS desteği sunar. TLS'yi destekleyen sanal ana makineler oluşturmayla ilgili örnekler de dahil olmak üzere daha fazla örnek için bkz. TLS'yi Yapılandırma Private Cloud için bir API'ye erişme.

Daha fazla bilgi:

Barındırıcı takma adları hakkında

Sanal ana makine oluşturduğunuzda, sanal ana makinenin ana makine takma adını belirtmeniz gerekir. Bu, genellikle sanal ana makinenin DNS adıdır.

Uç Yönlendirici, gelen isteğin Host üst bilgisini isteği işleyen API proxy'sini belirlemenin bir parçası olarak kullanılabilir ana makine takma adlarının listesine eklenir. Sanal ana makine üzerinden istekte bulunurken, ana makineyle eşleşen bir alan adı belirtin. takma adı kullanabilir veya Yönlendiricinin IP adresini ve ana makine takma adını içeren Host üstbilgisini belirtebilirsiniz.

Örneğin, ana makine takma adıyla bir sanal ana makine oluşturduysanız myapis.apigee.net bağlantı noktasında myapis.apigee.net bağlantısı, ardından bir API'ye cURL isteği aracılığıyla aşağıdaki biçimlerden birini kullanabilir:

myapis.apigee.net için 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 üstbilgisi.

Not: curl komutu, çoğu tarayıcı ve diğer birçok tarayıcı yardımcı programlar Host üstbilgisini otomatik olarak kullanabilirsiniz. Dolayısıyla, şu biçimde bir curl komutu kullanabilirsiniz:
```
curl http://routerIP:9001/proxy-base-path/resource-path
```

Bu durumda kullanabileceğiniz seçenekler sanal ana makine için bir DNS girişine sahip değil

DNS girişiniz yoksa kullanabileceğiniz seçeneklerden biri, ana makine takma adını Sanal ana makinenin yönlendiricisi ve bağlantı noktası (routerIP:port şeklinde). Örnek:

192.168.1.31:9001

Aşağıdaki formda bir curl komutu yaptığınızda:

curl http://routerIP:9001/proxy-base-path/resource-path

Edge kullanıcı arayüzüyle iyi çalıştığından bu seçenek tercih edilir.

Birden fazla Yönlendiriciniz varsa her bir Yönlendirici için IP adresini belirterek bir ana makine takma adı ekleyin. her Yönlendirici ve sanal ana makine bağlantı noktası.

Alternatif olarak, ana makine takma adını temp.hostalias.com. Ardından, her istekte Host başlığını iletmeniz gerekir:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

İsterseniz ana makine takma adını /etc/hosts dosyanıza da ekleyebilirsiniz. Örneğin, bu satırı /etc/hosts:

192.168.1.31 temp.hostalias.com

Ardından, DNS girişiniz varmış gibi bir istekte bulunabilirsiniz:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path

Edge'deki sanal ana makine bağlantı noktaları hakkında Private Cloud 4.16.01 ve sonraki sürümleri için

Sanal ana makine oluştururken sanal ana makine tarafından kullanılan Yönlendirici bağlantı noktasını belirtirsiniz. Örneğin, bağlantı noktası 9001 olduğunu varsayalım.

Apigee for Private Cloud'un 4.16.01 ve sonraki sürümlerinde varsayılan olarak Yönlendirici kullanıcı "Apigee" Ayrıcalıklı bağlantı noktalarına erişimi olmayan kullanıcılar içindir (genellikle 1024 ve önceki bağlantı noktaları). Eğer Yönlendirici'yi korumalı bir bağlantı noktasına bağlayan bir sanal ana makine oluşturmak isterseniz Yönlendirici'yi bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalışacak şekilde yapılandırın. Daha fazla bilgi için Sanal ana makine ayarlama başlıklı makaleye bakın.

Sanal ana makineler oluşturma

Bu bölümde, Private Cloud için Apigee Edge için sanal ana makinelerin nasıl oluşturulacağı açıklanmaktadır. Yeni bir kuruluş yöneticisi olmanız gerekir.

API veya Edge kullanıcı arayüzünü kullanarak Apigee Edge for Private Cloud için sanal ana makineler oluşturabilirsiniz. Bunlar: aşağıdaki bölümlerde açıklanmıştır.

Tarayıcı kullanarak sanal ana makine oluşturma

Bu bölümde, tarayıcı kullanarak sanal ana makine oluşturma hakkında bilgi verilmektedir (yalnızca Edge kullanıcı arayüzü).

Edge kullanıcı arayüzünde yeni bir sanal ana makine oluşturmak için:

Edge yönetim kullanıcı arayüzüne giriş yapın.
Yönetici > Sanal Ana Makineler bölümüne gidin.
Açılır listeden ortamı seçin.

Edge, söz konusu ortam için sanal ana makinelerin listesini gösterir.
Yeni bir sanal ana makine oluşturmak için + Virtual Host'u (+ Sanal Ana Makine) seçin.
Edge, Create Virtual Host (Sanal Ana Makine Oluştur) formunu gösterir.

Düzenlemek için mevcut bir sanal ana makinenin adını da tıklayabilirsiniz.
Yeni sanal ana makinenizi tanımlayın. Temel URL alanının şu değeri içermesi gerektiğini unutmayın: protokolü (alan değerinin önüne "http://" veya "https://" ekleyin.)
Ayrıca şunlara dikkat edin:
- Oluşturabileceğiniz sanal ana makine sayısıyla ilgili bir sınır yoktur
- TLS isteğe bağlıdır ve 1.0, 1.1 veya 1.2 sürümü olabilir
- Sanal ana makinenin bağlantı noktası yapılandırılabilir
Yeni sanal ana makinenizi kaydetmek için Create (Oluştur) düğmesini tıklayın.

API ile sanal ana makine oluşturma

API ile sanal bir ana makine oluşturmak için API'yi tanımlayan bir XML nesnesi oluşturun: sanal ana makine. Örneğin, aşağıdaki XML nesnesi HTTP kullanan bir sanal ana makine tanımlar protokol:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>DNS_name_or_IP:port</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>9005</Port>
</VirtualHost>

Sanal ana makinenin bir name özelliği içerdiğine dikkat edin. name özelliğini kullanabilirsiniz.

Ardından, şunun için istekte bulunarak bu sanal ana makine üzerinden bir API proxy'sine erişebilirsiniz:

http://routerIP:port/proxy-base-path/resource-path
https://routerIP:port/proxy-base-path/resource-path

Burada:

http veya https: Sanal ana makine, HTTPS kullanın. Sanal ana makine TLS'yi desteklemiyorsa HTTP kullanın.
routerIP:port, sanal ana makinenin IP adresi ve bağlantı noktası numarasıdır.
proxy-base-path ve resource-path, API proxy'si.

Genelde API'lerinizi, IP adresi ve bağlantı noktası numarası olan müşterilere yayınlamazsınız. Bunun yerine, Yönlendirici ve bağlantı noktası için bir DNS girişi tanımlarsınız. Örneğin:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

DNS girişini tanımlarsanız sanal ana makine için bir ana makine takma adı oluşturmanız gerekir DNS girişinin alan adıyla eşleştiğinden emin olun. Barındırıcı takma adı, Host üstbilgisinden geçti. Yukarıdaki örnekte, api.myCompany.com için bir ana makine takma adı belirtirsiniz.

<VirtualHost name="myVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9005</Port>
</VirtualHost>

HTTP protokolünü kullanan bir sanal ana makine oluşturmak için aşağıdakileri gerçekleştirin:

Sanal ana makineyi oluşturmak için Oluştur: Sanal Ana Makine API'si, burada ms-IP Yönetim Sunucusu düğümünün IP adresi veya alan adı:

$ curl -X POST -H "Content-Type:application/xml" \
http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
-d '<VirtualHost name="newVHost">
    <HostAliases>
      <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9005</Port>
  </VirtualHost>' \
-u sysAdminEmail:password

Ana makine takma adıyla eşleşen sanal ana makine için DNS kaydını oluşturun.
Mevcut API proxy'leriniz varsa sanal ana makineyi <HTTPConnection> öğesine ekleyin proxy'sini kullanabilirsiniz. Sanal ana makine, tüm yeni API proxy'lerine otomatik olarak eklenir. Bkz. Sanal ana makine kullanmak için API proxy'si yapılandırma
Uyarı: Tüm sanal ana makineler, tüm yeni sanal makinelere API proxy'leri Bu nedenle, bu sanal ana makineyi şuradan kaldırmak için API proxy'sini düzenlemeniz gerekir: .

Sanal ana makineyi değiştirme

ziyaret edin.

Bir sanal ana makineyi değiştirmek için aşağıdaki adımları uygulayın:

Sanal ana makineyi güncellemek için Bir Virtual Host API'yi güncelleyin (<ms-IP>, IP adresidir). Yönetim Sunucusu düğümünün alan adını içerir. sanal ana makineyi (ör. sanal ana makine) kullanabilirsiniz. Burada sanal ana makinenin bağlantı noktası numarasını 9008'den 9009'a değiştirdiğinizde:

curl -X PUT -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
  -d '<VirtualHost name="newVHost">
    <HostAliases>
      <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>9009</Port>
  </VirtualHost>' \
  -u email:password

Edge için yalnızca Private Cloud'un 4.16.01 ve 4.16.05 sürümleri için ve bağlantı noktasını değiştirmeden TLS'yi etkinleştirin ya da TLS'yi devre dışı bırakın. numara, ardından:
1. Yönlendiriciyi durdurun:
```
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
```
2. /opt/nginx/conf.d klasöründeki dosyaları silin:
```
rm -f /opt/nginx/conf.d/*
```
3. Yönlendiriciyi başlatın:
```
/opt/apigee/apigee-service/bin/apigee-service edge-router start
```
4. Bu işlemi tüm Yönlendiriciler için tekrarlayın.