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, Özel Bulut Ö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ü'nde yapılan değişiklikler özetlenmiştir:

Yeni Özellikler ○ JWT Politikaları Genel Kullanıma Sunuldu (GA)
○ RedHat Enterprise Linux 6.9 artık desteklenmektedir
○ Oracle Linux 6.9 desteklenmektedir
○ CentOS 6.9 artık desteklenmektedir
○ Yeni Edge deneyimi yükleme yapılandırması değişiklikleri
○ Yönlendirici yeniden deneme seçenekleri artık sanal ana makine düzeyinde ayarlanabilir
Dahil Olan Sürümler
○ 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.0018.01.31.0017.12.20.00
Emeklilik ○ API BaaS
○ İzleme Kontrol Paneli (Beta)
Kullanımdan kaldırma sayısı ○ KVM'ler ile değiştirilen Apigee güvenli depoları (kasalar)
○ API Proxy 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 engelle (65550638)
○ jackson-databind'de güvenlik açığı (69711616)
○ Mesaj İşlemcilerde bellek sızıntısı (71612599)
Bilinen Sorunlar

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

○ Mesaj İşleyici yedeklemesi doğru dosya grubunu yedeklemiyor (○28 Ayrı
8 veri yapılandırma verileri
208'e erişin




HEAD

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

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

Yeni sürüme geçiş yolları

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

18.04.01'den itibaren Doğrudan 4.18.01 → 4.18.05 sürümünden yükseltme
17 Temmuz 2009 tarihinden itibaren Doğrudan 4.17.09 → 4.18.05 sürümünden yükseltme
17 Temmuz 2005 tarihinden itibaren Doğrudan 4.17.05 → 4.18.05 sürümünden yükseltme
17 Temmuz 2001 tarihinden itibaren 4.17.01 → 4.18.01 sürümünü, ardından 4.18.01 → 4.18.05 sürümünü yükseltin
16.04.09'dan itibaren 4.16.09 → 4.18.01 sürümünü, ardından 4.18.01 → 4.18.05 sürümünü yükseltin
16.04.05 tarihinden itibaren 4.16.05 → 4.18.01'den sürüm yükseltme, ardından 4.18.01 → 4.18.05 sürümünü yükseltme
16.04.01'den itibaren 4.16.01 → 4.18.01 sürümünü, ardından 4.18.01 → 4.18.05 sürümünü yükseltin
Başlangıç: 4.15,0x Sürümü 4.15.0x → 4.16.01'den, ardından 4.16.01 → 4.18.01 sürümünden yükseltin, ardından 4.18.01 → 4.18.05 sürümünden yükseltin

Yeni özellikler

Bu bölümde, bu Özellik Sürümü'ndeki yeni özellikler açıklanmaktadır. Bu özelliklerin yanı sıra bu sürüm, Dahil olan sürümlerde listelenen Edge Kullanıcı Arayüzü, Edge Yönetimi ve Portal sürümlerindeki tüm özellikleri içerir.

Aşağıdaki geliştirmelere ek olarak bu sürüm; kullanılabilirlik, performans, güvenlik ve kararlılık iyileştirmeleri de içerir.

JWT Politikaları

Aşağıdaki JWT Politikaları artık Beta sürümde değildir ve Genel Kullanıma sunulmuştur:

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 Desteklenen yazılımlar ve desteklenen sürümler bölümüne bakın.

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

New Edge deneyiminin 4.18.05 sürümü, yapılandırma dosyasında 4.18.01 sürümünden yapılan değişiklikleri içerir. Yeni özellikler, Edge 4.18.01'deki yükleme yapılandırması değişiklikleri bölümünde açıklanmıştır.

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

Artık Yönlendiricinin, sanal ana makinedeki Mesaj İşleyici ile iletişimleri için yeniden deneme seçeneklerini ayarlayabilirsiniz. Bu sayede, yalnızca Yönlendirici düzeyinde ayarlanabilen önceki seçeneklere kıyasla daha ayrıntılı kontrol sahibi olursunuz.

Daha fazla bilgi için Sanal ana makine yapılandırma özellikleri bölümüne bakın.

Yeni Analytics boyutu ve x_forwarded_for_ip boyutu olarak değiştir

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 boyutu yalnızca listelenen son IP adresini içeriyordu. Müşteriler, Edge'e API isteği gönderen istemcinin IP adresini belirlemek için genellikle x_forwarded_for_ip boyutunu kullanır.

Bu sürümle birlikte x_forwarded_for_ip boyutu, artık X-Forwarded-For başlığındaki IP adreslerinin tam listesini içermektedir.

Uyarı: X-Forwarded-For üstbilgisi, erişimi reddedilmiş bir IP tarafından adres sahteciliğine maruz kalma potansiyeline sahiptir. Başlıktaki son adres ( Edge'in son harici TCP el sıkışmasında aldığı IP adresidir). Bu sürümde, Edge Analytics'e API isteğinde bulunan orijinal istemci IP adresini belirlemek için yeni bir boyut eklendi: ax_resolved_client_ip.

API isteğinde bulunan istemcinin IP adresini belirlemek için artık ax_resolved_client_ip boyutunu özel bir raporda veya özel bir rapordaki filtre koşulunda 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 üst bilgisini son harici TCP el sıkışmasından (istemci IP'si veya yönlendirici gibi) 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 (istemci IP'si veya yönlendirici gibi) aldığı tek IP adresiyle ayarladı. Daha fazla bilgi için X-Forwarded-For HTTP başlığı hakkında konusuna bakın.

Dahil edilen sürümler

Ö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ü 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.0018.01.31.0017.12.20.00
* 74622499 hata düzeltmesi, Edge for Private Cloud 4.18.05 sürümüne dahil değildir.

Bu Özellik Sürümü'nde yer alan sürümlerdeki yeni özellikleri ve hata düzeltmelerini görmek için yukarıdaki bağlantıları tıklayın.

Emeklilik

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

API BaaS

API BaaS kullanımdan kaldırıldı. Daha fazla bilgi için Apigee'nin kullanımdan kaldırılması, kullanımdan kaldırma işlemleri ve CPS değişiklikleri bölümünü inceleyin.

Monitoring Kontrol Paneli (Beta)

Monitoring Kontrol Paneli (Beta) kullanımdan kaldırıldı ve artık desteklenmeyecek. Sonuç olarak, aşağıdaki bileşenler artık yükleme kapsamında değildir:

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

Yönlendirici, Mesaj İşleyici ve düğüm metriklerini almaya devam etmek için Apigee, Edge for Private Cloud verilerini kendi izleme araçlarınıza entegre etmek amacıyla JMX kullanmanızı önerir. Daha fazla bilgi için Ne izlemeli? ve Nasıl izlenir? bölümlerine bakın.

Mevcut bir yüklemeyi 4.18.05 sürümüne yükseltirseniz Monitoring Kontrol Paneli'ni kaldırmanız gerekir. 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 Apigee'nin kullanımdan kaldırılması, kullanımdan kaldırma işlemleri ve CPS değişiklikleri bölümünü inceleyin.

Apigee güvenli deposu (kasalar)

"Apps Kasası" olarak da bilinen Apigee güvenli deposu kullanımdan kaldırılıyor ve Eylül 2018'de kullanımdan kaldırılacaktır.

Güvenli depoyu kullanmak 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 ve alma için 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 gidip Performans sekmesine gidip proxy'nin Performans sekmesi ile İşletme İşlemleri kontrol panelinde grafik tabanlı karşılaştırma için farklı yollar oluşturabiliyordunuz.

Bu özellik kullanımdan kaldırıldı ve artık kullanıcı arayüzünde yer almıyor. Bu işleve alternatif için Business Transaction API'ye Alternatif 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 kullanmanız gerekir. Geçerli SMTP_PROTOCOL değerleri "standard", "ssl" ve "tls" değerleridir.

Daha fazla bilgi için Geliştirici Hizmetleri portalını yükleme bölümüne bakın.

Hata düzeltmeleri

Bu bölümde, bu Özellik Sürümü'nde düzeltilen Private Cloud hataları listelenmektedir. Aşağıda listelenen hataların yanı sıra bu Özellik Sürümü, 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 İşlemcilerde bellek sızıntısı

Bellek sızıntısı düzeltildi. Bu hata, Qpidd durdurulduğunda Mesaj İşleyicilerinde oluşuyordu.
69711616

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

jackson-databind kitaplığı, seri çözümleme hatasını önlemek için 2.7.9.1 sürümüne güncellendi.
65550638

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

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

Bilinen sorunlar

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

Sorun Kimliği Açıklama
121095148

İleti İşleyici yedeği doğru dosya grubunu yedeklemiyor

Geçici çözüm:

Yedeklemeyi bir kez daha çalıştırdığınızda, doğru dosya grubunun yedeklenmesi gerekir.
79993247

Node.js hedeflerine gönderilen HEAD isteği kilitleniyor

Node.js hedefine yapılan HEAD istekleri kilitlenebilir ve bağlantılar beklemede kalabilir.

Geçici çözüm:

Bu sorunu çözmek üzere 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 seçeneği aracılığıyla ters proxy oluşturma seçeneği gösteriliyor

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

Geçici çözüm:

Yok.
79757554

Çözümlenmeyen ana makine adları

Private Cloud için Edge yüklendikten veya yükseltildikten 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 çok 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'de Cassandra düğümlerine bağlanmaya çalıştığı için başlatılamayabilir. DataAccessExceptions, bir Cassandra düğümü kapalıyken oluşur. Bu durum, Mesaj İşleyicilerin KVM'leri almaya çalışırken DataAccessExceptions bildirdiği API trafiği kesintilerine de yol açabilir.

Beklenen durumun, Yönetim Sunucusu'nun bölgeler genelindeki veri deposu bileşenlerine bağlanmaması olduğunu unutmayın.

Geçici çözüm

Geçici bir çözüm olarak, kullanılamayan veri merkezindeki aşağıdaki Cassandra düğüm türlerinin kaydını silerek Cassandra düğümleri yeniden kullanılabilir hale geldikten sonra yeniden kaydedebilirsiniz:

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

Bu Cassandra düğüm türlerinin kaydını iptal etmek 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 kapsül adıdır ve varsayılan olarak "ağ geçidi"dir. Adını başka bir adla değiştirmiş olabilirsiniz. Bu nedenle uygulamanızı kontrol edin.
    • CASSANDRA_NODE_TYPE; kms-datastore, dc-datastore ve keyvaluemap-datastore değerlerinden biridir.

    Ö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ıtta şu biçim kullanılı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ının değerlerini not edin. Bunları düğümlerin kaydını silmek için kullanacaksınız.

  2. Her Cassandra düğüm türü için birinci adımı tekrarlayın: kms-datastore, dc-datastore ve keyvaluemap-datastore. Döndürülen UUID'leri not etmeyi unutmayın.
  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, düğümleri Zookeeper'da kaydettiği ve bunların kaydını sildiğinin ve Cassandra kümesi üzerinde herhangi bir etkisi olmadığını unutmayın. Bu komutlar hakkında daha fazla bilgi için Datastore kayıtlarını güncelleme bölümüne bakın.
72379834

Apigee-postgresql durdurulduğunda izin hata mesajı görünüyor

apigee-postgresql öğesini durdurmak için apigee-seriver apigee-postgresql stop komutunu kullandığınızda apigee-serive adlı kullanıcının, kullanıcının ev dizinine geçemeyeceğini belirten bir mesaj görebilirsiniz. Bu mesajı yoksayabilirsiniz.

Geçici çözüm:

Yok
68722102

Günlük mesajında ek bilgiler içeren MessageLogging politikası

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

  • Öncelik puanı
  • Zaman damgası

Geçici çözüm:

Yok.

Sonraki adım

Edge for Private Cloud 4.18.05'i kullanmaya başlamak için 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
Önceki
4.18.05.01
Sonraki
4.18.01.02