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.
Apigee X belgelerine gidin. bilgi

Şirket içi yüklemelerde sanal ana makineler üzerinde tam kontrole sahip olursunuz. TLS kullanarak veya kullanmadan tüm kuruluşlar için sanal ana makineler oluşturabilirsiniz.

Bu dokümanda, basit bir sanal ana makinenin nasıl oluşturulacağı açıklanmaktadır. Diğer bir deyişle, TLS'yi desteklemeyen bir sistem kullanılır. TLS'yi destekleyen sanal ana makineler oluşturma örnekleri de dahil olmak üzere daha fazla örneği Private Cloud için bir API'ye TLS erişimini yapılandırma bölümünde görebilirsiniz.

Daha fazla bilgi:

Ana makine takma adları hakkında

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

Uç Yönlendirici, isteği işleyen API proxy'sini belirleme işleminin bir parçası olarak gelen isteğin Host üstbilgisini, mevcut ana makine takma adları listesiyle karşılaştırır. Bir sanal ana makine üzerinden istek yaparken, 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 üst bilgisini belirtin.

Örneğin, myapis.apigee.net 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 yapılan 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 bir 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 üst bilgisinde geçirirsiniz.

Not: curl komutu, çoğu tarayıcı ve diğer birçok yardımcı program, isteğin bir parçası olarak Host başlığını alan adıyla otomatik olarak ekler. Böylece, şu şekilde bir curl komutu kullanabilirsiniz:
```
curl http://routerIP:9001/proxy-base-path/resource-path
```

Sanal ana makine için DNS girişiniz olmadığında sunulan seçenekler

DNS girişiniz yoksa kullanabileceğiniz seçeneklerden biri, ana makine takma adını Yönlendiricinin IP adresi ve sanal ana makinenin bağlantı noktası olarak (routerIP:port gibi) ayarlamaktır. Örneğin:

192.168.1.31:9001

Aşağıdaki biçimde bir curl komutu yaptığınızda:

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

Bu seçenek, Edge kullanıcı arayüzü ile iyi çalıştığından tercih edilir.

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

Alternatif olarak, ana makine takma adını temp.hostalias.com gibi bir değere ayarlayabilirsiniz. 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'

Alternatif olarak /etc/hosts dosyanıza ana makine takma adını da ekleyebilirsiniz. Örneğin, şu satırı /etc/hosts dosyasına ekleyin:

192.168.1.31 temp.hostalias.com

Bu durumda, DNS girişiniz varmış gibi istekte bulunabilirsiniz:

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

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

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.

Private Cloud için Apigee 4.16.01 ve sonraki sürümlerinde Yönlendirici varsayılan olarak, ayrıcalıklı bağlantı noktalarına (genellikle 1024 ve önceki bağlantı noktalarına) erişimi olmayan "Apigee" kullanıcısı olarak çalışır. Yönlendiriciyi korumalı bir bağlantı noktasına bağlayan bir sanal ana makine oluşturmak istiyorsanız Yönlendiriciyi bu bağlantı noktalarına erişimi olan bir kullanıcı olarak çalışacak şekilde yapılandırmanız gerekir. 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'de sanal ana makinelerin nasıl oluşturulacağı açıklanmaktadır. Yeni bir sanal ana makine oluşturmak için kuruluş yöneticisi olmanız gerektiğini unutmayın.

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 (yalnızca Edge kullanıcı arayüzü) açıklanmaktadır.

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.
Admin > Virtual Hosts (Yönetici > Sanal Ana Bilgisayarlar) seçeneğini belirleyin.
Açılır listeden ortamı seçin.

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

Mevcut bir sanal ana makinenin adını tıklayarak da düzenleyebilirsiniz.
Yeni sanal ana makinenizi tanımlayın. Temel URL alanı protokolü içermelidir (ör. alanın değerinin önüne "http://" veya "https://" ekleyin).
Ayrıca, aşağıdaki noktalara 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 Oluştur düğmesini tıklayın.

API ile sanal ana makine oluşturma

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

<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ğinin değerini, sanal ana makineyi kullanmak üzere bir API proxy'si yapılandırmak için kullanırsınız.

Ardından, 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 TLS'yi destekleyecek şekilde yapılandırılmışsa 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'sini oluşturduğunuzda tanımlanır.

API'lerinizi genellikle 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 DNS girişinin alan adıyla eşleşen bir ana makine takma adı oluşturmanız gerekir. Ana makine takma adı, istemcinin Host üst bilgisinde ilettiği dizeyle eşleşmelidir. Yukarıdaki örnekte, api.myCompany.com alan adının ana makine takma adını 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 yapın:

Sanal Ana Makine Oluştur API'sini kullanarak sanal ana makineyi oluşturun. Burada ms-IP, Yönetim Sunucusu düğümünün IP adresi veya alan adıdır:

$ 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 Proxy Uç Noktası'ndaki <HTTPConnection> öğesine ekleyin. Sanal ana makine, tüm yeni API proxy'lerine otomatik olarak eklenir. Sanal ana makine kullanmak için API proxy'si yapılandırma bölümüne göz atın.
Uyarı: Tüm sanal ana makineler otomatik olarak tüm yeni API proxy'lerine eklenir. Bu nedenle, belirli bir sanal ana makine üzerinden erişilmemesi gereken yeni bir API proxy'si oluşturursanız bu sanal ana makineyi ProxyEndpoint'ten kaldırmak için API proxy'sini düzenlemeniz gerekir.

Sanal ana makineyi değiştirme

Bir sanal ana makineyi değiştirmek için aşağıdakileri yapın:

Virtual Host API'yi (Sanal Ana Makine Güncellemesi) kullanarak sanal ana makineyi güncelleyin. Burada <ms-IP>, Yönetim Sunucusu düğümünün IP adresi veya alan adıdır. İstek gövdesinde yalnızca değiştirmek istediğiniz öğeleri değil, sanal ana makinenin tam tanımını belirtmeniz gerekir. Bu örnekte, sanal ana makinenin bağlantı noktası numarasını 9008'den 9009'a değiştiriyorsunuz:
```
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
```
Yalnızca Edge for Private Cloud sürümleri 4.16.01 ve 4.16.05 için Mevcut bir sanal ana makineyi değiştirir ve TLS'yi etkinleştirir veya bağlantı noktası numarasını değiştirmeden TLS'yi devre dışı bırakırsanız:
1. Yönlendiriciyi durdurun:
```
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
```
2. /opt/nginx/conf.d klasöründeki tüm 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. Tüm Yönlendiriciler için bu işlemi tekrarlayın.