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

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

Bu bölümde, Edge for Private Cloud Feature Release'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 özetlenmektedir:

Yeni Özellikler ○ JWT politikaları artık genel kullanıma sunuldu (GA)
○ RedHat Enterprise Linux 6.9 artık destekleniyor
○ Oracle Linux 6.9 artık destekleniyor
○ CentOS 6.9 artık destekleniyor
○ Yeni Edge deneyimiyle ilgili yükleme yapılandırmasında 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 		○ Edge 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
Kullanımdan kaldırılan özellikler ○ API BaaS
○ İzleme Kontrol Paneli (Beta)
Desteği sonlandırılan özellikler ○ Apigee güvenli depolarının (kasalar) yerini KVM'ler aldı
○ API proxy'si Performans sekmesine yollar ekleme
○ Geliştirici Hizmetleri portalı için SMTPSSL özelliği
Hata Düzeltmeleri ○ Kullanıcının e-posta adresinin değiştirilmesini önleme (65550638)
○ jackson-databind'deki güvenlik açığı (69711616)
○ İleti işlemcilerindeki bellek sızıntısı (71612599)
Bilinen Sorunlar

Bu sürümde aşağıdaki bilinen sorunlar bulunmaktadır:

○ Mesaj İşleyici yedeklemesi, doğru dosya grubunu yedeklemiyor (121095148)
○ Node.js hedeflerine yapılan HEAD istekleri askıda kalıyor (79993247)
○ Open API seçeneğiyle ters proxy oluşturma görüntüleniyor (79949124)
○ Ana makine adları çözümlenmiyor (79757554)
○ Çoklu veri merkezi yapılandırmalarında DataAccessExceptions (76087166)
○ apigee-postgresql durdurulurken izin hatası mesajı gösteriliyor (72379834)
○ MessageLogging politikası, günlük mesajına ek bilgiler ekliyor (68722102)

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

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

Yükseltme yolları

Aşağıdaki tabloda, bu özellik sürümünün yükseltme yolları gösterilmektedir:

4.18.01 sürümünden itibaren Doğrudan 4.18.01'den 4.18.05'e yükseltme
4.17.09 sürümünden itibaren Doğrudan 4.17.09'dan 4.18.05'e yükseltme
4.17.05 sürümünden itibaren Doğrudan 4.17.05'ten 4.18.05'e yükseltme
4.17.01 sürümünden itibaren 4.17.01 sürümünden 4.18.01 sürümüne yükseltin, ardından 4.18.01 sürümünden 4.18.05 sürümüne yükseltin.
4.16.09 sürümünden itibaren 4.16.09 sürümünden 4.18.01 sürümüne, ardından 4.18.01 sürümünden 4.18.05 sürümüne yükseltin.
4.16.05 sürümünden itibaren 4.16.05 sürümünden 4.18.01 sürümüne, ardından 4.18.01 sürümünden 4.18.05 sürümüne yükseltin.
4.16.01 sürümünden itibaren 4.16.01 sürümünden 4.18.01 sürümüne yükseltin, ardından 4.18.01 sürümünden 4.18.05 sürümüne yükseltin.
4.15.0x ve sonraki sürümler 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, sonra 4.18.01 → 4.18.05 sürümüne yükseltin

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, Dahil edilen sürümler bölümünde listelenen Edge kullanıcı arayüzü, Edge yönetimi ve Portal sürümlerindeki tüm özellikleri içerir.

Bu sürümde aşağıdaki geliştirmelerin yanı sıra kullanılabilirlik, performans, güvenlik ve kararlılıkla ilgili birçok geliştirme de yer almaktadır.

JWT Politikaları

Aşağıdaki JWT politikaları artık beta sürümünde değil, genel kullanıma sunulmuştur:

Desteklenen yazılımlar

Bu özellik sürümü, desteklenen yazılımlarda 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 Desteklenen yazılımlar ve desteklenen sürümler başlıklı makaleyi inceleyin.

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

Yeni Edge deneyiminin 4.18.05 sürümünde, 4.18.01 sürümündeki yapılandırma dosyasında değişiklikler yapıldı. Yeni özellikler Installation configuration changes from Edge 4.18.01 (Edge 4.18.01'den itibaren yükleme yapılandırma değişiklikleri) başlıklı makalede açıklanmıştır.

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

Artık sanal ana makinede yönlendiricinin ileti işlemciyle iletişim kurması için yeniden deneme seçeneklerini ayarlayabilirsiniz. Bu seçenek, yalnızca yönlendirici düzeyinde ayarlanabilen önceki seçeneklere kıyasla daha ayrıntılı kontrol sağlar.

Daha fazla bilgi için bkz. Sanal ana makine yapılandırma özellikleri.

Yeni analiz boyutu ve x_forwarded_for_ip boyutunda değişiklik

Edge'in Edge Analytics'te x_forwarded_for_ip boyutunu ayarlama şekli değişti. Daha önce, X-Forwarded-For üstbilgisinde birden fazla IP adresi varsa x_forwarded_for_ip boyutunda yalnızca listelenen son IP adresi yer alıyordu. Müşteriler, Edge'e API isteğinde bulunan istemcinin IP adresini belirlemek için genellikle x_forwarded_for_ip boyutunu kullanıyordu.

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

Uyarı: X-Forwarded-For üstbilgisinin, erişimi reddedilen bir IP tarafından sahteciliğe uğratılma ihtimali vardır. Ancak üstbilgideki son adres, Edge'in son harici TCP el sıkışmasından aldığı IP adresi olduğundan bu durum geçerli değildir. Bu sürüm, Edge'e API isteğinde bulunan orijinal istemci IP adresini belirlemek için Edge Analytics'e yeni bir boyut ekler: ax_resolved_client_ip.

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

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

Dahil edilen yayınlar

Önceki Edge for Private Cloud Özellik Sürümü'nden bu yana aşağıdaki sürümler yayınlandı ve bu Özellik Sürümü'ne dahil edildi:

Edge kullanıcı arayüzü Edge 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
* 74622499 numaralı hata düzeltmesi, Edge for Private Cloud 4.18.05 sürümüne dahil edilmemiştir.

Bu özellik sürümüne dahil edilen hata düzeltmelerini ve yeni özellikleri görmek için yukarıdaki bağlantıları tıklayın.

Kullanımdan kaldırma

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ıldı. Daha fazla bilgi için Apigee'de desteği sonlandırılan ve kullanımdan kaldırılan özellikler ile CPS değişiklikleri başlıklı makaleyi inceleyin.

İzleme Kontrol Paneli (Beta)

İzleme Kontrol Paneli (Beta) kullanımdan kaldırıldı ve artık desteklenmeyecek. Bu nedenle, aşağıdaki bileşenler artık kurulumun bir parçası değildir:

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

Apigee, yönlendirici, mesaj işlemci ve düğüm metriklerini almaya devam etmek için Edge for Private Cloud'un verilerini kendi izleme araçlarınızla entegre etmek üzere JMX'i kullanmanızı önerir. Daha fazla bilgi için Neleri izlemelisiniz? ve Nasıl izlemelisiniz? başlıklı makaleleri inceleyin.

Mevcut bir yüklemeyi 4.18.05 sürümüne yükseltirseniz İzleme Kontrol Paneli'ni kaldırmanız gerekir. Apigee, beklendiği gibi çalışmaya devam edeceğini garanti etmez.

Kullanımdan kaldırmalar

Bu özellik sürümünde aşağıdaki özelliklerin desteği sonlandırıldı.

Daha fazla bilgi için Apigee'de desteği sonlandırılan ve kullanımdan kaldırılan özellikler ile CPS değişiklikleri başlıklı makaleyi inceleyin.

Apigee güvenli deposu (kasalar)

"Kasalar" olarak da bilinen Apigee güvenli deposunun desteği sonlandırılıyor ve bu özellik Eylül 2018'de kullanımdan kaldırılacak.

Güvenli depolama alanı yerine, Anahtar/değer eşlemeleriyle çalışma bölümünde açıklandığı gibi şifrelenmiş anahtar/değer eşlemelerini (KVM'ler) kullanın. Şifrelenmiş KVM'ler, kasalar kadar güvenlidir ve oluşturma ile alma konusunda daha fazla seçenek sunar.

API proxy'si Performans sekmesine yol ekleme

Bu sürümden önce, yönetim kullanıcı arayüzünde bir API proxy'sine gidebilir, Performans sekmesine gidip proxy'nin Performans sekmesinde ve İşlemler kontrol panelinde grafik tabanlı bir karşılaştırma için farklı yollar oluşturabilirdiniz.

Bu özellik kullanımdan kaldırıldı ve artık kullanıcı arayüzünde kullanılamıyor. Bu işlevin alternatifi için İşlemler API'sinin alternatifi başlıklı makaleyi inceleyin.

Geliştirici Hizmetleri portalı için SMTPSSL özelliği

Portala bağlı SMTP sunucusu tarafından kullanılan protokolü ayarlamak için artık SMTPSSL özelliği yerine SMTP_PROTOCOL özelliğini kullanıyorsunuz. SMTP_PROTOCOL için geçerli değerler "standard", "ssl" ve "tls"dir.

Daha fazla bilgi için Developer Services portal kurulumu başlıklı makaleyi inceleyin.

Hata düzeltmeleri

Bu bölümde, bu özellik sürümünde düzeltilen Private Cloud hataları listelenmektedir. Bu özellik sürümü, aşağıda listelenen hatalara ek olarak Dahil edilen sürümlerde gösterilen Edge kullanıcı arayüzü, Edge Yönetimi ve Portal sürümlerindeki tüm hata düzeltmelerini içerir.

Sorun Kimliği Açıklama
71612599

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

Bellek sızıntısı düzeltildi. Qpidd durdurulduğunda Message Processors'da meydana geldi.
69711616

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

jackson-databind kitaplığı, seri durumdan çıkarma kusurunu önlemek için 2.7.9.1 sürümüne güncellendi.
65550638

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

Artık, yönetim API'sine gönderilen mesaj yükünde kullanıcının e-posta adresini değiştiremezsiniz. Yönetim API'si artık istek gövdesinde XML'ye izin vermiyor.

Bilinen sorunlar

Aşağıdaki tabloda bu özellik sürümündeki bilinen sorunlar listelenmiştir:

Sorun Kimliği Açıklama
121095148

Mesaj İşleyici yedeği, doğru dosya grubunu yedeklemiyor

Geçici çözüm:

Yedeklemeyi ikinci kez çalıştırın. Bu kez doğru dosya grubu yedeklenir.
79993247

HEAD Node.js hedeflerine yapılan istekler askıda kalıyor

Bir Node.js hedefine yapılan HEAD istekleri askıda kalabilir ve bağlantılar beklemede kalır.

Geçici çözüm:

Bu sorunu çözmek için HEAD istekleri için bir işleyici tanımlayarak açıkça boş bir yanıt döndürün.
79949124

Open API seçeneğiyle ters proxy oluşturma gösteriliyor

Proxy sihirbazı şu anda Open API aracılığıyla yeni bir proxy oluşturma seçeneği gösteriyor. Bu işlem, Private Cloud için Edge'de mümkün değildir.

Geçici çözüm:

Yok.
79757554

Ana makine adları çözümlenmiyor

Edge for Private Cloud'u yükledikten veya yükselttikten sonra ana makine adları adreslerine çözümlenemeyebilir.

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 fazla veri merkezi yapılandırmasında DataAccessException

Birden fazla veri merkezi yapılandırmasında, bir veri deposu kullanılamaz hale gelirse aşağıdaki hatayı görebilirsiniz:

DataAccessException: Error while accessing datastore;
Please retry later

Sonuç olarak, Yönetim Sunucusu hem dc-1 hem de dc-2'deki Cassandra düğümlerine bağlanmaya çalıştığı için başlatılamayabilir. Bir Cassandra düğümü kapalıysa DataAccessExceptions oluşur. Bu durum, API trafiğinde kesintiye de neden olabilir. Bu durumda, mesaj işleyiciler KVM'leri almaya çalışırken DataAccessExceptions değerini bildirir.

Beklenen durumun, yönetim sunucusunun bölgeler arası veri deposu bileşenlerine bağlanmaması olduğunu unutmayın.

Geçici çözüm

Geçici çözüm olarak, kullanılamayan veri merkezindeki aşağıdaki Cassandra düğüm türlerinin kaydını silin ve 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 hesabınızın kimlik bilgileridir.
    • MS_IP ve MS_PORT, Yönetim Sunucusu'nun IP adresi ve bağlantı noktası numarasıdır.
    • REGION, Yönetim Sunucusu'nun bulunduğu veri merkezinin adıdır.
    • GATEWAY_POD, varsayılan olarak "gateway" olan pod adıdır. Ancak, bunu başka bir adla yeniden adlandırmış olabilirsiniz. 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ıtın uUID alanındaki değerleri not edin. Bu bilgileri kullanarak düğümlerin kaydını silersiniz.

  2. Her Cassandra düğüm türü (kms-datastore, dc-datastore ve keyvaluemap-datastore) için birinci adımı tekrarlayın. Döndürülen UUID'leri not ettiğinizden emin olun.
  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'dan düğümleri kaydettiğini ve kaydını sildiğini, Cassandra kümesi üzerinde herhangi bir etkisi olmadığını unutmayın. Bu komutlar hakkında daha fazla bilgi için Veri deposu kayıtlarını güncelleme başlıklı makaleyi inceleyin.
72379834

apigee-postgresql durdurulurken izin hatası mesajı gösteriliyor

apigee-seriver apigee-postgresql stop komutunu kullanarak apigee-postgresql durdurduğunuzda, apigee-serive kullanıcının ana dizinine geçemediğine dair bir mesaj görebilirsiniz. Bu mesajı yoksayabilirsiniz.

Geçici çözüm:

Yok
68722102

Günlük iletisine ek bilgiler ekleyen MessageLogging politikası

MessageLogging politikasının FormatMessage öğesi, kaydedilen mesajın biçimini kontrol eder. FormatMessage=false olduğunda, günlüğe kaydedilen mesajın Apigee tarafından oluşturulan herhangi bir bilgiyi içermemesi gerekir. Ancak FormatMessage=false ayarını yapsanız bile günlük iletisi aşağıdaki bilgileri içerir:

  • Öncelik puanı
  • Zaman damgası

Geçici çözüm:

Yok.

Sonraki adım

Private Cloud 4.18.05 için Edge'i kullanmaya başlamak üzere aşağıdaki bağlantıları kullanın:

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