4.18.05 Edge for Private Cloud sürüm notları

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

Bu bölümde, Private Cloud Özellik Sürümü için Edge'in 4.18.05 sürümü açıklanmaktadır.

Sürüm özeti

Aşağıdaki tabloda bu Özellik Sürümü'ndeki değişiklikler özetlenmiştir:

Yeni Özellikler ○ JWT Politikaları Artık Genel Kullanımda (GA)
○ RedHat Enterprise Linux 6.9 artık destekleniyor
○ Oracle Linux 6.9 artık destekleniyor
○ CentOS 6.9 artık destekleniyor
○ Edge deneyimini yükleme yapılandırmasında yapılan yeni değişiklikler
○ Yönlendirici yeniden deneme seçenekleri artık sanal ana makine düzeyinde ayarlanabilir
Dahil Edilen Yayınlar
○ Edge kullanıcı arayüzü:
18.04.04
18.03.02
18.02.14
17.11.06
○ Uç Yönetimi/Çalışma Zamanı:
18.04.06
18.04.04
18.03.02
18.02.02
18.01.05
○ Portal:
18.04.25.01
18.04.25.00
18.04.23.00
18.03.28.00
18.03.05.00
18.02.15.00
18.01.31.00
17.12.20.00
Emeklilik ○ API Temelleri
○ İzleme Kontrol Paneli (Beta)
Kullanımdan kaldırmalar ○ Apigee güvenli mağazaları (kaslar) yerine KVM'ler kullanılıyor
○ API proxy'si Performans sekmesine yol ekleme
○ Geliştirici Hizmetleri portalı için SMTPSSL mülkü
Hata Düzeltmeleri ○ Kullanıcının e-posta adresinin değiştirilmesini engelleme (65550638)
○ Jackson-databind'de güvenlik açığı (69711616)
○ Mesaj İşlemcilerinde bellek sızıntısı (71612599)
Bilinen Sorunlar

Bu sürüm aşağıdaki bilinen sorunları içermektedir:

○ Mesaj İşlemci yedeklemesi doğru dosya grubunu yedeklemiyor (121095148)
○ Node.js hedeflerine yönelik HEAD istekleri kilitleniyor (79993247)
○ Open API aracılığıyla ters proxy oluştur seçeneği gösteriliyor (79949124)
○ Ana makine adları çözümlenmiyor (79757554)
○ Çoklu veri merkezi yapılandırmalarında DataAccessExceptions (76087166)
○ Apigee-postgresql durdurulurken izin hata mesajı görünüyor (72379834)
○ Günlük mesajındaki ekstra bilgileri içeren MessageLogging politikası (68722102)

Geçici çözümler de dahil olmak üzere bu bilinen sorunların her biri hakkında daha fazla bilgi için Bilinen sorunlar.

Aşağıdaki bölümlerde bu konuların her biri ayrıntılı olarak açıklanmaktadır.

Yeni sürüme geçirme yolları

Aşağıdaki tabloda bu Özellik Sürümü için yükseltme yolları gösterilmektedir:

18.01.2019'dan itibaren Doğrudan 4.18.01 → 4.18.05 sürümüne geçin
4.17.09'dan itibaren Doğrudan 4.17.09 → 4.18.05 sürümüne geçin
17.05'ten itibaren Doğrudan 4.17.05 → 4.18.05 sürümüne geçin
17.01.01'den itibaren 4.17.01 → 4.18.01 sürümünü yükseltin. ardından 4.18.01 → 4.18.05 sürümüne geçin
16.09'dan itibaren 4.16.09 → 4.18.01 sürümünü yükseltin. ardından 4.18.01 → 4.18.05 sürümüne geçin
16.05'ten itibaren 4.16.05 → 4.18.01 sürümünü yükseltin. ardından 4.18.01 → 4.18.05 sürümüne geçin
16.01'den itibaren 4.16.01 → 4.18.01 sürümünü yükseltin. ardından 4.18.01 → 4.18.05 sürümüne geçin
4.15.0x'ten itibaren 4.15.0x → 4.16.01 sürümüne yükseltin. Ardından 4.16.01 → 4.18.01 sürümüne yükseltin, ardından 4.18.01 → 4.18.05 sürümüne geçin

Yeni özellikler

Bu bölümde, bu Özellik Sürümü'ndeki yeni özellikler açıklanmaktadır. Bu özelliklere ek olarak Bu sürüm, şurada listelenen Edge Kullanıcı Arayüzü, Edge Management ve Portal sürümlerindeki tüm özellikleri içerir: Dahil olan sürümler.

Bu sürüm, aşağıdaki geliştirmelere ek olarak birden çok kullanılabilirlik özelliği de içeriyor. performans, güvenlik ve kararlılıkla ilgili iyileştirmeler içeriyor.

JWT Politikaları

Aşağıdaki JWT Politikaları artık Beta sürümünde değiller; bunlar artık genel olarak GA'dır:

Desteklenen yazılımlar

Bu Özellik Sürümü, desteklenen yazılımlarda yapılan aşağıdaki değişiklikleri içerir:

  • Red Hat Enterprise Linux (RHEL) 6.9 artık destekleniyor
  • Oracle Linux 6.9 artık destekleniyor
  • CentOS 6.9 artık destekleniyor
  • RHEL/CentOS/Oracle Linux 7.2 artık desteklenmiyor

Daha fazla bilgi için bkz. Desteklenen yazılımlar ve desteklenen sürümler.

Yeni Edge deneyimi yükleme yapılandırması değişiklikleri

Yeni Edge deneyiminin 4.18.05 sürümü, yapılandırma dosyasında 4.18.01 sürümü kullanıma sunulacak. Yeni özellikler aşağıda açıklanmıştır: Kurulum Edge 4.18.01'deki yapılandırma değişiklikleri hakkında daha fazla bilgi edinin.

Yönlendirici yeniden deneme seçenekleri artık sanal ana makine düzeyinde ayarlanabilir

Artık Yönlendiricinin Mesaj İşlemci ile iletişimleri için yeniden deneme seçeneklerini ayarlayabilirsiniz: sanal ana makineyi kullanır. Bu, önceki seçeneklere göre daha hassas kontrol olanağı sunar. yalnızca Yönlendirici seviyesinde ayarlanabilir.

Daha fazla bilgi için bkz. Sanal yapılandırma özelliklerini inceleyin.

Yeni analiz boyutu ve x_forwarded_for_ip boyutuna geçiş

Edge'in x_forwarded_for_ip boyutunu ayarlama yöntemi biraz değişti. Önceden, X-Forwarded-For başlığında birden fazla IP adresi varsa x_forwarded_for_ip boyutu yalnızca listelenen son IP adresini içeriyordu. Müşteriler genellikle alanın IP adresini belirlemek için x_forwarded_for_ip boyutunu kullandı. istemciyi kontrol etmeniz gerekir.

Bu sürümle birlikte x_forwarded_for_ip boyutu artık tam listeyi içeriyor X-Forwarded-For üstbilgisindeki IP adreslerinin sayısı.

Uyarı: X-Forwarded-For üstbilgisi, erişimi reddedilmiş bir IP tarafından adres sahteciliğine maruz kalmış olabilir. yalnızca üstbilgideki son adrestir. Bu adres, Edge'in son harici TCP el sıkışmasından aldığı IP adresidir. Edge'e API isteği gönderen orijinal istemci IP adresini belirlemek için Bu sürüm, Edge Analytics'e yeni bir boyut eklemiştir: ax_resolved_client_ip.

Artık ax_resolved_client_ip boyutunu özel bir raporda veya filtre koşulunu API isteğinde bulunan istemcinin IP adresini belirlemek için özel bir rapordaki Analytics metrikleri, boyutları ve filtreleri referansını inceleyin. ax_resolved_client_ip boyutu hakkında daha fazla bilgi edinin.

Bu değişiklik, AccessControl politikasının X-Forwarded-For üst bilgisini işleme şeklini de etkiler. Bu sürümde Edge, X-Forwarded-For HTTP üst bilgisini otomatik olarak son harici TCP el sıkışmasından aldığı tek IP adresi (istemci IP'si veya yönlendirici gibi). Önceki sürümlerde Edge, X-Forwarded-For HTTP üst bilgisini ilk harici TCP el sıkışmasından aldığı tek IP adresi (istemci IP'si veya yönlendirici gibi). Daha fazla bilgi için bkz. X-Forwarded-For HTTP üstbilgisi hakkında.

Dahil edilen sürümler

Önceki Edge for Private Cloud Özellik Sürümü'nden bu yana aşağıdaki sürümler gerçekleşti ve bu Özellik Sürümü'nde şunlar yer almaktadır:

Edge kullanıcı arayüzü Uç Yönetimi/Çalışma Zamanı Portal
18.04.04
18.03.02
18.02.14
17.11.06
18.04.06
18.04.04
18.03.02*
18.02.02
18.01.05
18.04.25.01
18.04.25.00
18.04.23.00
18.03.28.00
18.03.05.00
18.02.15.00
18.01.31.00
17.12.20.00
* Hata düzeltmesi 74622499, Edge for Private Cloud 4.18.05 sürümüne dahil değildir.

Bu sürümlerdeki hata düzeltmelerini ve yeni özellikleri görmek için yukarıdaki bağlantıları tıklayın. dahil edilmiştir.

Emeklilik

Bu bölümde, bu Özellik Sürümü'nde kullanımdan kaldırılan özellikler açıklanmaktadır.

API BAaS

API BaaS kullanımdan kaldırılmıştır. Daha fazla bilgi için bkz. Apigee'nin kullanımdan kaldırılması, kullanımdan kaldırılması ve CPS değişiklikleri.

İzleme Kontrol Paneli (Beta)

İzleme Kontrol Paneli (Beta) kullanımdan kaldırıldı ve artık desteklenmeyecek. Sonuç olarak aşağıdaki bileşenler artık yüklemenin parçası değildir:

  • apigee-influxdb
  • apigee-telegraf
  • apigee-grafana

Yönlendirici, Mesaj İşlemci ve düğüm metriklerini almaya devam etmek için Apigee; Edge for Private Cloud'un verilerini kendi izleme araçlarınızla entegre etmek için JMX'i kullanın. Daha fazla daha fazla bilgi için Neleri izlemeli? Nasıl izlenir?

Mevcut bir yüklemeyi 4.18.05 sürümüne yükseltirseniz, Kontrol Paneli. Apigee, beklendiği gibi çalışmaya devam edeceğini garanti etmez.

Kullanımdan kaldırmalar

Aşağıdaki özellikler bu Özellik Sürümü'nde kullanımdan kaldırılmıştır.

Daha fazla bilgi için bkz. Apigee'nin kullanımdan kaldırılması, kullanımdan kaldırılması ve CPS değişiklikleri.

Apigee güvenli mağazası (kasalar)

"Kasalar" olarak da bilinen Apigee güvenli mağazası, kullanımdan kaldırılıyor ve şu tarihte kullanımdan kaldırılacak: Eylül 2018.

Güvenli depoyu kullanmak yerine aşağıdaki makalede açıklandığı gibi şifrelenmiş anahtar/değer eşlemeleri (KVM'ler) kullanın. Anahtar/değer eşlemeleriyle çalışma. Şifrelenmiş KVM'ler, kasalar kadar güvenlidir ve oluşturma ve işleme için daha fazla seçenek sunar. içerir.

API proxy'si Performans sekmesine yol ekleme

Bu sürümden önce, yönetim arayüzünde bir API proxy'sine gidip Performans sekmesine gidin ve proxy'nin Performans sekmesinde ve İşletme İşlemleri sekmesinde kontrol paneli

Bu özellik kullanımdan kaldırıldı ve artık artık kullanıcı arayüzünde mevcut. Bu işleve bir alternatif için bkz. Business Transaction API'sine alternatif.

Geliştirici Hizmetleri portalı için SMTPSSL mülkü

Portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlamak için artık SMTPSSL özelliği yerine SMTP_PROTOCOL özelliğini kullanmanız gerekir. Geçerli değerler SMTP_PROTOCOL oranındaki bölümü "standard", "ssl" ve "tls"dir.

Daha fazla bilgi için bkz. Geliştirici Hizmetleri portalı kurulumu.

Hata düzeltmeleri

Bu bölümde, bu Özellik Sürümü'nde düzeltilen Private Cloud hataları listelenmektedir. Ayrıca Bu Özellik Sürümü, Edge kullanıcı arayüzü, Edge'deki tüm hata düzeltmelerini içerir Dahil edilen sürümler bölümünde gösterilen Yönetim ve Portal sürümleri.

Sorun Kimliği Açıklama
71612599

Mesaj İşlemcilerinde bellek sızıntısı

Bellek sızıntısı düzeltildi. Hata, İleti İşlemcilerinde Qpidd durduruldu.

69711616

jackson-databind'de güvenlik açığı

Jackson-databind kitaplığı, olası hataları önlemek için 2.7.9.1 sürümüne serileştirme hatası.

65550638

Kullanıcının e-posta adresinin değiştirilmesini engelleme

Artık şu adrese gönderilen ileti yükünde kullanıcının e-posta adresini değiştiremezsiniz: Management API'yi kullanabilirsiniz. Management API artık istek gövdesinde XML'e de izin vermemektedir.

Bilinen sorunlar

Aşağıdaki tabloda, bu Özellik Sürümü'ndeki bilinen sorunlar listelenmiştir:

Sorun Kimliği Açıklama
121095148

Mesaj İşleyici yedeklemesi doğru dosya grubunu yedeklemiyor

Geçici çözüm:

Yedeklemeyi ikinci kez çalıştırdığınızda doğru dosya grubu yedeklenecektir.

79993247

Node.js hedeflerine yapılan HEAD istekleri askıya alınıyor

Node.js hedefine yapılan HEAD istekleri askıya alınabilir ve bağlantılar beklemede kalır.

Geçici çözüm:

Bu sorunu çözmek amacıyla açıkça boş bir yanıt döndürmek amacıyla HEAD istekleri için bir işleyici tanımlayın.

79949124

Open API aracılığıyla ters proxy oluştur seçeneği gösteriliyor

Proxy sihirbazı şu anda Open API aracılığıyla yeni bir proxy oluşturma seçeneğini görüntülemektedir. Private Cloud için Edge'de bu mümkün değildir.

Geçici çözüm:

Yok.
79757554

Ana makine adları çözümlenmiyor

Private Cloud için Edge'i yükledikten veya yükselttikten sonra ana makine adları kendi adreslerine çözümlenmeyebilir.

Geçici çözüm:

Bu sorunu çözmek için Edge kullanıcı arayüzü bileşenini yeniden başlatın:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
76087166

Birden çok veri merkezi yapılandırmasında DataAccessException

Birden fazla veri merkezi yapılandırmasında, bir veri deposu kullanılamaz hale gelirse şu hata oluştu:

DataAccessException: Error while accessing datastore;
Please retry later

Yönetim Sunucusu, Cassandra'ya bağlanmaya çalıştığı için başlatılmayabilir. hem dc-1 hem de dc-2'deki düğümler. DataAccessExceptions, bir Cassandra düğümü aşağı tüketim. Bu durum, Mesaj İşleyenlerin bildirdiği API trafiğinin kesintiye uğramasına da neden olabilir. KVM'leri almaya çalışırken DataAccessExceptions.

Beklenen durumun, Yönetim Sunucusu'nun veri deposu bileşenlerine bağlanmaması için olduğunu unutmayın. ve bölgeleri keşfedebilirsiniz.

Geçici çözüm

Geçici çözüm, kullanılamayan veri merkezinde aşağıdaki Cassandra düğüm türlerinin kaydını silmektir. ve ardından, Cassandra düğümleri tekrar kullanılabilir hale geldikten sonra bunları yeniden kaydedin:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

Bu Cassandra düğüm türlerinin kaydını silmek ve yeniden kaydetmek için:

  1. Aşağıdaki curl komutunu kullanarak Cassandra düğümlerinin UUID'lerini alın:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    Burada:

    • ADMIN_EMAIL ve ADMIN_PW, Apigee'nizin kimlik bilgileridir hesap.
    • MS_IP ve MS_PORT, Yönetim Sunucusu'nun IP adresi ve bağlantı noktasıdır sayı.
    • REGION, Yönetim Sunucusu'nun bulunduğu veri merkezinin adıdır. bulabilirsiniz.
    • GATEWAY_POD, varsayılan olarak "ağ geçidi" olan kapsül adıdır. Projede ancak, başka bir adla adlandırıldı. Bu nedenle, uygulamanızı kontrol edin.
    • CASSANDRA_NODE_TYPE şunlardan biridir: kms-datastore, dc-datastore, ve keyvaluemap-datastore.

    Örneğin:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    Yanıt, aşağıdaki biçimi kullanır:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    Örneğin:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    Yanıttaki uUID alanındaki değerleri not edin. Bu araçları şu amaçla kullanacaksınız: düğümlerin kaydını iptal edebilir.

  2. Her Cassandra düğüm türü için birinci adımı tekrarlayın: kms-datastore, dc-datastore ve keyvaluemap-datastore. Lütfen Döndürülen UUID'ler.
  3. Aşağıdaki komutu kullanarak düğümlerin kaydını silin:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    Burada UUID, önceki komutun yanıtında döndürülen UUID'dir.

  4. 1. ve 2. adımda topladığınız her UUID için 3. adımı tekrarlayın.
  5. Aşağıdaki komutu kullanarak düğümleri yeniden kaydedin:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

Bu işlemlerin, Zookeeper'daki düğümleri kaydettiği ve kayıtlarını silmesini ve hiçbir Cassandra kümesi üzerindeki etkisidir. Bu komutlar hakkında daha fazla bilgi için bkz. Veri deposu kayıtlarını güncelleyin.

72379834

Apigee-postgresql durdurulurken izin hata mesajı görünüyor

apigee-postgresql uygulamasını durdurmak için apigee-seriver apigee-postgresql stop komutunu kullandığınızda, apigee-serive ürününün, kullanıcının ana sayfa diziniyle değiştirilemeyeceğini belirten bir mesaj görebilirsiniz. Bu mesajı yoksayabilirsiniz.

Geçici çözüm:

Yok
68722102

Günlük mesajındaki ekstra bilgiler dahil olan MessageLogging politikası

MessageLogging politikasının FormatMessage öğesi, günlüğe kaydedilen mesajın biçimini kontrol eder. FormatMessage=false söz konusu olduğunda, günlüğe Apigee tarafından oluşturulan herhangi bir bilgi eklenmemelidir. Ancak FormatMessage=false öğesini ayarlamış olsanız bile günlük iletisi aşağıdaki bilgileri içermeye devam eder:

  • Öncelik puanı
  • Zaman damgası

Geçici çözüm:

Yok.

Sonraki adım

Aşağıdaki bağlantıları kullanarak Edge for Private Cloud 4.18.05'i kullanmaya başlayabilirsiniz:

Yeni yüklemeler:
Yeni yüklemeye genel bakış
Mevcut yüklemeler:
4.18.01'den yükseltme
4.17.05 veya 4.17.09'dan yükseltme
4.17.01'den yükseltme
4.16.09'dan yükseltme
4.16.01 veya 4.16.05'ten yükseltme