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

Kurulum yerel bir ortamdaysa sanal ana makineler üzerinde tam kontrole sahip olursunuz. TLS'yi kullanarak veya kullanmadan, herhangi bir ortamda, herhangi bir kuruluş için sanal ana makine oluşturabilirsiniz.

Bu dokümanda, basit bir sanal ana makinenin nasıl oluşturulacağı açıklanmaktadır. Yani, TLS'yi desteklemeyen bir yöntemdir. TLS'yi destekleyen sanal ana makineler oluşturmayla ilgili örnekler de dahil olmak üzere daha fazla örnek için Özel Bulut için bir API'ye TLS erişimini yapılandırma başlıklı makaleyi inceleyin.

Daha fazla bilgi:

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

Sanal ana makineyi oluştururken sanal ana makinenin ana makine takma adını belirtmeniz gerekir. Bu genellikle sanal ana makinenin DNS adıdır.

Uç Yönlendirici, isteği işleyen API proxy'sini belirlemenin bir parçası olarak gelen isteğin Host başlığını, mevcut ana makine takma adları listesiyle karşılaştırır. Sanal ana makine üzerinden istek gönderirken sanal ana makinenin ana makine takma adıyla eşleşen bir alan adı belirtin veya Yönlendirici'nin IP adresini ve ana makine takma adını içeren Host üstbilgisini belirtin.

Örneğin, 9001 bağlantı noktasında myapis.Apigee.net ana makine takma adıyla bir sanal ana makine oluşturduysanız bu sanal ana makine üzerinden bir API'ye gönderilen cURL isteği, aşağıdaki formlardan 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 başlığında iletirsiniz.

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

Sanal ana makine için DNS girişiniz yoksa kullanabileceğiniz seçenekler

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

192.168.1.31:9001

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

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

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

Birden fazla Yönlendiriciniz varsa her bir Yönlendiricinin IP adresini ve sanal ana makine 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 üst bilgisini 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 ekleyin. Örneğin, şu satırı /etc/hosts öğesine ekleyin:

192.168.1.31 temp.hostalias.com

Ardından, DNS girişiniz varmış gibi bir istek gönderebilirsiniz:

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, 9001 numaralı bağlantı noktası.

Özel Bulut için Apigee 4.16.01 ve sonraki sürümlerde, Yönlendirici varsayılan olarak "apigee" kullanıcısı olarak çalışır. Bu kullanıcı, ayrıcalıklı bağlantı noktalarına (genellikle 1024 ve altı bağlantı noktaları) erişemez. Yönlendiriciyi korumalı bir bağlantı noktasına bağlayan sanal bir 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 oluşturma başlıklı makaleyi inceleyin.

Sanal ana makineler oluşturma

Bu bölümde, Private Cloud için Apigee Edge'te 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'yi 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ı (yalnızca Edge kullanıcı arayüzü) kullanılarak sanal ana makinenin nasıl oluşturulacağı 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.
Yönetici > Sanal Ana Makineler'i seçin.
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 + Sanal Ana Makine'yi seçin.
Edge, 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 protokolü içermesi gerektiğini unutmayın (yani alanın değerinin başına "http://" veya "https://" eklenmelidir).
Ayrıca şunlara dikkat edin:
- Oluşturabileceğiniz sanal ana makine sayısıyla ilgili bir sınır yoktur.
- İsteğe bağlı olan TLS 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 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. Bir API proxy'sini sanal ana makineyi kullanacak şekilde yapılandırmak için name özelliğinin değerini kullanırsınız.

Ardından, aşağıdaki adreslere istek göndererek bu sanal ana makine üzerinden 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'yi 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ıyla 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 başlığında ilettiği dizeyle eşleşmelidir. Yukarıdaki örnekte, api.myCompany.com 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 gerçekleştirin:

Create a Virtual Host API'yi 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

Sanal ana makine için ana makine takma adıyla eşleşen 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. API proxy'sini sanal ana makine kullanacak şekilde yapılandırma başlıklı makaleyi inceleyin.
Uyarı: Tüm sanal ana makineler, tüm yeni API proxy'lerine otomatik olarak 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'inden kaldırmak için API proxy'sini düzenlemeniz gerekir.

Sanal ana makineyi değiştirme

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

Update a Virtual Host API (Sanal Ana Makine Güncelle) API'sini kullanarak sanal ana makineyi güncelleyin. Burada <ms-IP>, Yönetim Sunucusu düğümünün IP adresi veya alan adıdır. Yalnızca değiştirmek istediğiniz öğeleri değil, istek gövdesinde 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 Private Cloud için Edge 4.16.01 ve 4.16.05 sürümleri için, Mevcut bir sanal ana makineyi değiştirirseniz ve bağlantı noktası numarasını değiştirmeden TLS'yi etkinleştirirseniz veya 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 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.