Edge Microgateway Hakkında SSS

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin. bilgi

Başlarken

Edge Microgateway'i nasıl yükleyebilirim?

Edge Microgateway'i yükleme başlıklı makaleyi inceleyin.

Edge Microgateway'i nasıl çalıştırabilirim?

Edge Microgateway'i kurma ve yapılandırma başlıklı makaleyi inceleyin.

Microgateway'i çalıştırmak için veritabanı gerekir mi?

Edge Microgateway üzerinden proxy'lenen API'ler, hedef hizmetin bir parçası olarak çalışan bir veritabanıyla etkileşime girebilir. Ancak Edge Microgateway, herhangi bir veritabanından veya arka uç veri deposundan bağımsız olarak çalışır.

İşlem

Edge'de hangi değişiklikler Edge Microgateway'in yeniden başlatılmasını gerektirir?

Edge Microgateway, Apigee Edge'de yapılan değişiklikleri (ör. mikro ağ geçidi uyumlu proxy'lerde, ürünlerde veya geliştirici uygulamalarında yapılan değişiklikler) otomatik olarak yoklar. Varsayılan yoklama aralığı 600 saniyedir ancak aralığı config_change_poll_interval yapılandırma ayarıyla değiştirebilirsiniz. edgemicro özellikleri konusunu inceleyin.

Yoklama aralığını beklemek istemiyorsanız en son değişiklikleri almak için edgemicro reload komutunu kullanın. Mikro ağ geçidi kümesini yeniden yükleme başlıklı makaleyi inceleyin.

Edge'de dağıtılan bir proxy ile Edge Microgateway'deki bir proxy arasında nasıl ayrım yapabilirim?

Edge Microgateway'i yapılandırdığınızda, Apigee Edge'e dağıtılan mikro ağ geçidi uyumlu proxy'lerin listesi Edge Microgateway'in yerel yapılandırmasına indirilir. Microgateway'e duyarlı proxy'ler, edgemicro_ önekiyle adlandırılan proxy'lerdir.

Edge Microgateway ile günlük kaydı için seçeneklerim nelerdir?

Edge Microgateway'de yerleşik bir günlük kaydı özelliği bulunur. Ayrıntılı bilgi için Günlük dosyalarını yönetme başlıklı makaleyi inceleyin.

Ayrıca, Edge Microgateway ile üçüncü taraf günlük hizmetini kullanmak için özel bir eklenti de yazabilirsiniz. Edge Microgateway'in çalışma şekli nedeniyle, Edge Microgateway'deki mesajları günlüğe kaydetmek için Apigee Edge Message Logging politikası kullanılamaz. Ayrıca Logging Plugin for Microgateway başlıklı topluluk makalesini de inceleyin.

Edge Microgateway örnekleri arasında anahtar/gizli dizi kombinasyonlarını yeniden kullanabilir miyim?

Mikro ağ geçidi örnekleri için kuruluş ve ortam aynı olduğu sürece yapılandırma sırasında oluşturulan anahtar/gizli dizi çiftini yeniden kullanabilirsiniz.

Edge Microgateway'i üretim ortamında başlatılacak şekilde nasıl yapılandırabilirim?

Başlangıç komutu parametreleri için ortam değişkenlerini ayarlayabilirsiniz. Örneğin, EDGEMICRO_KEY, EDGEMICRO_SECRET, EDGEMICRO_ORG ve EDGEMICRO_ENV. Bu (ve diğer) değişkenlerle Edge Microgateway'i tek bir edgemicro start komutuyla başlatabilirsiniz. Ayrıca Ortam değişkenlerini ayarlama başlıklı makaleyi de inceleyin.

Edge Microgateway ile özel ürün veya geliştirici uygulaması özellikleri kullanabilir miyim?

Hayır. Edge Microgateway, varsayılan olarak yalnızca temel yönlendirme ve güvenlik ile ilgili özelliklere göre işlem yapar. Ancak geçici çözüm olarak aşağıdaki seçeneği kullanabilirsiniz:

1. Edge Microgateway'in Apigee Edge'e dağıttığı edgemicro-auth proxy'sine özel özellikler ekleyin. Bu özellikler, API anahtarı veya OAuth jetonu güvenliği kullanılırken kullanılabilir.
2. OAuth eklentisini bu özelliklere göre işlem yapacak şekilde değiştirin.

İstek başlığı boyutuyla ilgili bir sınır var mı?

Node.js'yi v8.14.0 veya sonraki bir sürüme yükseltirseniz isteklerde izin verilen maksimum başlık boyutunun 80 KB'tan 8 KB'a düşürüldüğünü unutmayın. 8 KB'ı aşan başlıklar HTTP 431 hatasına neden olur.

Node.js v11.6.0'da eklenen bir Node.js yapılandırma seçeneği, varsayılan maksimum başlık boyutunu değiştirmenize olanak tanır. Bu parametre (--max-http-header-size), HTTP üstbilgilerinin bayt cinsinden maksimum boyutunu belirtmenize olanak tanır.

Varsayılan yapılandırmayı değiştirmek için komut satırında NODE_OPTIONS ortam değişkeninin değerini aşağıdaki gibi ayarlayın: değişkenini komut satırında aşağıdaki gibi ayarlayın:

NODE_OPTIONS=--max-http-header-size=NUM_BYTES

Örneğin:

NODE_OPTIONS=--max-http-header-size=80000

Edge Microgateway hangi yönetim API'lerini kullanır?

Dağıtım

Hedef hizmetimin çalıştığı sunucuya Edge Microgateway'i dağıtabilir miyim?

Evet. Edge Microgateway, aynı makine de dahil olmak üzere hedef hizmetinize yakın çalıştırılabilen hafif bir işlemdir.

Mevcut bir Edge proxy paketini Edge Microgateway dağıtımı olarak dağıtabilir miyim?

Hayır. Edge Microgateway'e duyarlı proxy'lerin belirli şartları vardır ve normal Edge proxy'lerinin tüm özelliklerini desteklemezler. Bölüm 2: Apigee Edge'de varlık oluşturma başlıklı makaleyi inceleyin.

Aynı API proxy'si için bir Edge proxy paketi dağıtımı ile Edge Microgateway dağıtımı arasında yük devretmeyi etkinleştirebilir miyim?

Hayır. Edge Microgateway, Apigee Edge'deki microgateway dışı API proxy dağıtımları hakkında bilgi sahibi değildir.

Edge Microgateway için yüksek kullanılabilirlik dağıtım modeli nedir?

Yük dengeleyici olarak NGINX kullanılarak Edge Microgateway'in nasıl çalıştırılacağıyla ilgili iyi bir tartışma için Apigee Edge Microgateway ve NGINX ile API'leri yönetme başlıklı makaleyi inceleyin.

Edge Microgateway ile hangi yük dengeleyicileri kullanabilirim?

Edge Microgateway, herhangi bir yük dengeleyiciyle çalışabilir.

Dağıtabileceğim Edge Microgateway proxy'lerinin sayısı sınırlı mı?

Normal Edge proxy'leri için belirtilen ürün yapılandırma sınırlarına bakın. Bir Apigee Edge kuruluşunda ve ortamında dağıtabileceğiniz ve Edge Microgateway üzerinden çağırabileceğiniz Edge Microgateway'e duyarlı proxy'lerin sayısı da aynı sınırlara uymalıdır.

Edge Microgateway dağıtımımı belirli bir kuruluş ve ortamla ilişkilendirebilir miyim?

Bir Edge Microgateway örneğini yapılandırırken bunu belirli bir Edge kuruluşu ve ortamıyla ilişkilendirmeniz gerekir.

Edge Microgateway dağıtımımı belirli bir bölgeyle ilişkilendirebilir miyim (çok bölgeli bir müşteri isem)?

Edge Microgateway, Apigee Edge ile etkileşimi için en iyi bölgeyi otomatik olarak seçer. Hizmet vermek istediğiniz her bölgede Edge Microgateway örnekleri dağıtabilirsiniz.

Yönetim

Edge Microgateway'i yapılandırmak ve dağıtmak için kuruluş yöneticisi olmam gerekir mi?

Evet. Edge Microgateway'i yapılandırmak ve dağıtmak için kuruluş yöneticisi kimlik bilgilerine sahip olmanız gerekir.

Edge Microgateway'i çalıştırmak için kuruluş yöneticisi olmam gerekir mi?

Hayır. Edge Microgateway bir Node.js uygulamasıdır ve belirli bir makinede bu tür uygulamaları çalıştırma izni olan herkes tarafından çalıştırılabilir.

Kuruluşumdaki kullanıcılar Edge Microgateway'i kullanabilir mi?

Edge Microgateway üzerinden API çağrıları yapmak için Apigee Edge kuruluş kullanıcısı olmanız gerekmez. Ancak Edge'de dağıtılan Edge Microgateway'e duyarlı proxy'ler oluşturmak veya değiştirmek için kuruluş düzeyinde izinlere sahip olmanız gerekir.

Performans

Edge Microgateway'i kullanırken performansla ilgili nelere dikkat etmeliyim?

Edge Microgateway'i hedef uygulamayla birlikte çalıştırıyorsanız sunucunun yeterli kapasiteye sahip olduğundan emin olun.

Edge Microgateway'i geniş ölçekte çalıştırmayla ilgili en iyi uygulamalar nelerdir?

Apigee, NGINX gibi yük dengeleyiciler tarafından desteklenen farklı sunucularda Edge Microgateway'in birden fazla örneğini çalıştırmanızı önerir. Ayrıca, Apigee Topluluğu'nda Apigee Edge Microgateway ve NGINX ile API'leri yönetme ve Dikey ve yatay ölçeklendirme başlıklı makaleleri inceleyin.

Edge Microgateway'in varsayılan TPS değeri nedir ve bir Microgateway örneği için gereken donanım gereksinimleri nelerdir?

Donanım gereksinimleri ve TPS ölçümleri, Edge Microgateway ile ölçmek zordur. Bu, Edge Microgateway'i ayarlama, eklenti kullanımı, özel eklentiler ve TLS gibi diğer öğeleri yapılandırma kombinasyonu olan kurulumunuza bağlıdır. Apigee genellikle bu öğe kombinasyonu hakkında fikir edinmenizi ve özel kurulumunuzla performans testi yapmanızı önerir.

Özel bulut dağıtımı

Edge Microgateway, Edge for Private Cloud ile çalışır mı?

Evet. Ayrıntılar için Apigee Private Cloud yapılandırma adımları başlıklı makaleyi inceleyin.

Eklentiler

Edge Microgateway ile kota nasıl uygulanır?

İsteğe bağlı olarak Edge Microgateway örneğinize bir kota eklentisi ekleyebilirsiniz. Ayrıntılı bilgi için Kota eklentisini kullanma başlıklı makaleyi inceleyin.

Spike Arrest, Edge Microgateway ile nasıl uygulanır?

Dilerseniz Edge Microgateway örneğinize ani artışları önleme eklentisi ekleyebilirsiniz. Ayrıntılı bilgi için Spike Arrest eklentisini kullanma başlıklı makaleyi inceleyin.

Edge Microgateway için Node.js dışında eklenti yazmanın başka yolları var mı?

Hayır. Eklentiler Node.js ile yazılmalıdır.

Edge Microgateway, Analytics verilerini Edge'e yükleyemediğinde ne olur?

Edge Microgateway'de bellek içi arabellek bulunur. Arabellek dolarsa API trafiğinin sorunsuz akması için eski yükler bırakılır.

Edge Microgateway'e politika ekleyebilir miyim?

Apigee Edge'de microgateway'e duyarlı proxy'lere normal Apigee Edge politikaları eklerseniz bu politikalar yoksayılır. Bunun yerine Edge Microgateway, Edge'deki politikalara benzer işlevler (ör. kota, ani artışları önleme, API anahtarı güvenliği ve OAuth2 güvenliği) sağlamak için eklentileri kullanır. Özel eklentiler de yazabilirsiniz. Eklentileri kullanma ve Özel eklentiler geliştirme başlıklı makaleleri inceleyin.

Aşağıdaki Apigee Community gönderilerinde ve bloglarında ek eklenti kullanım alanları ele alınmaktadır:

• Edge Microgateway'de varsayılan URL'yi geçersiz kılma
• Edge Microgateway'de kotanın çalışmasını sağlama
• Edge Microgateway'e günlük kaydedici eklentisi ekleme

Güvenlik

/products kaynağını nasıl koruyabilirim?

Genel Bakış

Edge Microgateway'i yapılandırdığınızda, edgemicro-auth adlı bir API proxy'si Apigee Edge'deki kuruluşunuza:ortamınıza dağıtılır. Bu proxy, API ürünlerinin listesini döndüren bir /products uç noktası sunar. Edge Microgateway'i 5 Ekim 2018'de veya öncesinde yüklediyseniz Apigee, bu uç noktayı korumak için gerekli adımları atmanızı önerir. Bunun nedeni, yanıtta Apigee kuruluşunuzdaki API ürünlerini oluşturan ve değiştiren geliştiricinin e-posta adresinin yer almasıdır.

Edge Microgateway'i yükselterek veya karşılıklı TLS'yi yapılandırarak uç noktayı koruyabilirsiniz. Bu seçeneklerin her ikisi de aşağıda açıklanmıştır.

/products uç noktasının korunup korunmadığını kontrol edin.

/products uç noktasının korunup korunmadığından emin değilseniz /products kaynağının korunduğunu doğrulama bölümüne gidin ve devam etmeden önce oradaki adımları uygulayın.

1. seçenek: Edge Microgateway'i yükseltme

Edge Microgateway'i 5 Ekim 2018'de veya daha önce yüklediyseniz Apigee, Edge Microgateway'in en son sürümüne yükseltmenizi önerir. İnternet bağlantınız varsa Edge Microgateway'i yükseltme bölümündeki adımları uygulayın.

Şu anda yükseltme yapamıyorsanız 2. seçeneğe gidin.

2. seçenek: Karşılıklı TLS'yi yapılandırma

Şu anda Edge Microgateway'i yükseltemiyorsanız Apigee, Edge Microgateway ile edgemicro-auth proxy arasındaki iletişimi karşılıklı TLS (iki yönlü TLS olarak da bilinir) ile korumanızı önerir.

1. Dosyayı açın $HOME/.edgemicro/org-env-config.yaml. Bu dosyayı bulamıyorsanız Edge Microgateway nereye yüklenir? başlıklı makaleye bakın.
2. Edge Microgateway ile Apigee Edge arasında karşılıklı TLS'yi etkinleştirmek için tlsOptions bloğunu org-env-config.yaml dosyasına ekleyin:

   edge_config:
     bootstrap: >-
       https://domain/edgemicro/bootstrap/organization/org/environment/env
     jwt_public_key: 'https://domain/edgemicro-auth/publicKey'
     managementUri: 'https://api.enterprise.apigee.com'
     tlsOptions:
       agentOptions:
         requestCert: true
         cert: 'path/to/cert'
         key: 'path/to/key'

   Örneğin:

   tlsOptions:
     agentOptions:
       requestCert: true
       cert: '/Users/jdoe/twowayssl/ssl/client.key'
       key: '/Users/jdoe/twowayssl/ssl/ca.crt'

   Aşağıdaki isteğe bağlı agentOptions parametrelerini de ekleyebilirsiniz:

   • ca: Sertifika yetkilisinin yolunu belirtir.
   • pfx: Sertifika ve anahtar yerine p12/pfx dosyası kullanmak istiyorsanız ekleyin.
   • passphrase: PFX dosyasının parola ifadesi.
   • ciphers: TLS şifrelerini belirtir.
3. edgemicro-auth proxy'sinin dağıtıldığı sanal ana makinede karşılıklı TLS'nin etkinleştirildiğinden emin olun. Ayrıntılar için Apigee Edge belgelerindeki İki yönlü TLS için sanal ana makine tanımlama bölümüne bakın.

   Aşağıdaki ekran görüntüsünde, Apigee Edge kullanıcı arayüzünde sanal bir ana makinede karşılıklı TLS'nin nasıl etkinleştirileceği gösterilmektedir:

   
4. Edge kullanıcı arayüzündeki edgemicro-auth API proxy'sine bakın ve proxy yapılandırmasında doğru sanal ana makinenin belirtildiğinden emin olun. Örneğin, mutualtls adlı bir TLS özellikli sanal ana makine oluşturduysanız vekil sunucunun HTTPProxyConnection stanza'sı şu şekilde görünmelidir:

   <HTTPProxyConnection>
       <BasePath>/edgemicro-auth</BasePath>
       <Properties/>
       <VirtualHost>mutualtls</VirtualHost>
   </HTTPProxyConnection>

curl -v https://your_domain/edgemicro-auth/products

{
  "error":"unauthorized",
  "error_description": "authentication failed"
}

curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number

{
   "apiProduct":[
      {
         "apiResources":[
            "/",
            "/**"
         ],
         "approvalType":"auto",
         "attributes":[

         ],
         "createdAt":1537374680948,
         "createdBy":"jdoe@foo.com",
         "description":"",
         "displayName":"mock",
         "environments":[
            "test"
         ],
         "lastModifiedAt":1537374680948,
         "lastModifiedBy":"test@test.com",
         "name":"mock",
         "proxies":[
            "edgemicro-auth",
            "edgemicro_mock"
         ],
         "quota":"null",
         "quotaInterval":"null",
         "quotaTimeUnit":"null",
         "scopes":[
            ""
         ]
      }
   ]
}

curl -v http://your_domain/edgemicro-auth/products

Test etme ve hata ayıklama

Yük testi sırasında "çok fazla dosya açık" hatalarını nasıl önleyebilirim?

Bazı durumlarda sisteminiz çok fazla açık dosya bağlantısı olan bir durumla karşılaşabilir ve bu durum Edge Micro'nun kilitlenmesine neden olabilir. Varsayılan günlük kaydı, Microgateway üzerinden gelen ve giden işlemler için iki HTTP bağlantısı gerektirir.

Apigee, test ve karşılaştırma amacıyla sisteminizin ulimit komutunu sınırsız olarak ayarlamanızı önerir: ulimit -n unlimited. Apigee Topluluğu'ndaki Edge Microgateway error during load testing (Yük testi sırasında Edge Microgateway hatası) başlıklı makaleyi de inceleyin.

Hızlı geliştirme ve hata ayıklama ile ilgili ipuçları

Edge Microgateway için eklentiler geliştiriyorsanız hızlı geliştirme desteğinin sınırlı olduğunu görebilirsiniz.

Şimdilik aşağıdaki ipuçlarından yararlanabilirsiniz:

• Edge Microgateway'i başlatmak için EDGEMICRO_KEY ve EDGEMICRO_SECRET ortam değişkenlerini Microgateway başlatma komutu için gereken anahtar/gizli dizi çiftine ayarlayabilirsiniz. Bu sayede, komut satırına anahtar/gizli dizi girmeden Edge Microgateway'i başlatabilirsiniz. Ayrıca Edge Microgateway belgelerindeki Ortam değişkenlerini ayarlama bölümüne bakın.
• Komut terminalinde ek çıktı görmek için Edge Microgateway'i DEBUG modunda başlatın: DEBUG=* edgemicro start -o [org] -e [env] -k [key] -s [secret]

İşletme ve lisanslama

Apigee-127 ile Edge Microgateway destek modelleri arasındaki ilişki nedir?

Apigee-127, açık kaynak modelinde desteklenen açık kaynaklı bir yazılım projesidir. Yani GitHub projesinde sorun bildirebilir ve bir şeyi düzeltmeye çalışırsanız pull isteğinde bulunabilirsiniz. Apigee-127, Apigee ile herhangi bir Yazılım Lisans Sözleşmesi gerektirmez veya içermez.

Edge Microgateway ise Apigee müşterileri için Apigee tarafından desteklenen bir Enterprise ürünüdür. Yani Apigee müşterileri, Google Cloud Apigee Edge Destek Ekibi'ni kullanarak destek kaydı oluşturabilir, özellik isteğinde bulunabilir ve hata raporu gönderebilir.