4.19.01 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.19.01 sürümü açıklanmaktadır.

Sürüm özeti

Bu sürümdeki değişiklikler aşağıdaki tabloda özetlenmiştir:

Yeni Özellikler

Bu sürümde aşağıdaki yeni özellikler yer almaktadır:

○ Edge kullanıcı arayüzünün genel kullanıma sunulması
○ Edge kullanıcı arayüzünde para kazanma özelliğinin genel kullanıma sunulması
apigee-monit kendi kendini onarma ve izleme hizmetleri ekler
○ Edge kullanıcı arayüzünde yeni TLS yapılandırma özellikleri bulunur
○ Artık Edge kullanıcı arayüzünde sanal ana makineler oluşturabilir, düzenleyebilir ve silebilirsiniz
○ OpenAPI v3 desteği eklendi
○ RedHat Enterprise Linux (RHEL) ve CentOS 7.6 artık destekleniyor
○ Oracle Linux 7.5 artık destekleniyor

Bu yeni özelliklerin her biri hakkında daha fazla bilgi için Yeni özellikler bölümüne bakın.

Dahil Edilen Yayınlar

Önceki Edge for Private Cloud Feature Release'den bu yana aşağıdaki sürümler yayınlandı ve bu sürüme dahil edildi:

○ Edge:
   18.06.08
   18.06.06
   18.05.21
   18.05.10
   18.05.09
   18.04.23.00
○ Portal:
   18.11.28.00
   18.10.17.00
   18.10.09.00
   18.07.16.00
Kullanımdan kaldırma Yok
Kullanımdan kaldırmalar Apigee Edge for Private Cloud 4.17.09 sürümü artık desteklenmiyor (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.

Hata Düzeltmeleri

Bu sürümde aşağıdaki hata düzeltmeleri yer almaktadır:

○ Zookeeper, yedekleme komut dosyası tarafından durdurulmadı (122694069)
○ "Kuruluş yok" açılış sayfası eklendi (120993451)
○ Özel raporları silme (120682369)
○ Yeni Edge deneyiminde coğrafi harita sekmesi (120681592)
○ Zookeeper JVM seçenekleri (120624977)
○ İpuçlarında tanımlanmamış hatalar oluştu (80187407)
○ OpenAPI aracılığıyla ters proxy'ler oluşturma (79949124)
○ Şifreleri sıfırlama bağlantıları gönderilmiyor (77515655)
○ Şifre sıfırlama bağlantıları için yanlış başlıklar (72799769)
○ API proxy'leri oluşturmak için WSDL'leri kullanma (69550284)

Bu düzeltmelerin her biri hakkında daha fazla bilgi için Hata düzeltmeleri bölümüne bakın.

Bilinen Sorunlar

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

○ Apigee-sso yüklemesi için meta veri dosyası biçimi (135616498)
○ Amazon Linux 1'de apigee-monit desteklenmiyor (122370980)
○ Message Processor yedeklemesi, doğru dosya grubunu yedeklemiyor (121095148)
○ Oturum jetonları geçersiz kılınmıyor (115278838)
○ JMX kimlik doğrulaması etkinleştirildiğinde Cassandra işlemleri çalışmıyor (113342838)
○ Node.js hedeflerine yapılan HEAD istekleri askıda kalıyor (79993247)
○ Ana makine adları çözümlenmiyor (79757554)
○ Çoklu veri merkezi yapılandırmalarında DataAccessExceptions (76087166)
○ MessageLogging politikası, günlük mesajına ek bilgiler ekliyor (68722102)
○ Sistem yöneticisi şifresini sıfırlama işlemi başarısız oluyor (65737520)

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.

Yükseltme yolları

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

4.18.05 sürümünden itibaren Doğrudan 4.18.05 sürümünden 4.19.01 sürümüne yükseltme
4.18.01 sürümünden itibaren Doğrudan 4.18.01'den 4.19.01'e yükseltme
4.17.09 sürümünden itibaren Doğrudan 4.17.09 sürümünden 4.19.01 sürümüne yükseltme
4.17.05 sürümünden itibaren 4.17.05 → 4.18.01 sürümüne yükseltin, ardından 4.18.01 → 4.19.01 sürümüne yükseltin
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.19.01 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.19.01 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 yükseltin, ardından 4.18.01 sürümünden 4.19.01 sürümüne yükseltin.
4.16.01 sürümünden itibaren 4.16.01 → 4.18.01 sürümüne yükseltin, ardından 4.18.01 → 4.19.01 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, ardından 4.18.01 → 4.19.01 sürümüne yükseltin

Yeni özellikler

Bu bölümde, bu sürümdeki yeni özellikler listelenmektedir. Ayrıca 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.

Edge kullanıcı arayüzünün genel kullanıma sunulması

Apigee Edge kullanıcı arayüzü, en yeni yönetim kullanıcı arayüzü hizmetimizdir. Daha önce Beta sürümündeydi. Apigee Edge for Private Cloud v4.19.01 ile Edge kullanıcı arayüzü genel sürümün bir parçasıdır.

Edge kullanıcı arayüzünü kullanmak için SAML'yi etkinleştirmeniz ve ardından Edge kullanıcı arayüzünü kendi düğümüne yüklemeniz gerekir.

Daha fazla bilgi için Özel Bulut için Edge kullanıcı arayüzü başlıklı makaleyi inceleyin.

Edge kullanıcı arayüzünde para kazanma özelliğinin genel kullanıma sunulması

Yeni Edge deneyimi kullanıcı arayüzünde para kazanma özelliğinin genel kullanıma sunulan sürümü artık kullanılabilir.

Artık Apigee Edge for Private Cloud ile ilgili tüm para kazanma görevlerini Yeni Edge deneyimi kullanıcı arayüzünde yönetebilirsiniz. Bu görevler arasında şunlar yer alır:

Bu duyuruyla birlikte, para kazanma varyansı raporları resmi olarak kullanımdan kaldırıldı. Apigee'de kullanımdan kaldırılan özellikler başlıklı makaleyi inceleyin.

apigee-monit, kendi kendini onarma ve izleme hizmetleri ekler

Apigee Edge for Private Cloud artık açık kaynak monit yardımcı programına dayalı bir araç olan apigee-monit'yı içeriyor. apigee-monit, Edge hizmetlerini düzenli olarak yoklar. Bir hizmet kullanılamıyorsa apigee-monit hizmeti yeniden başlatmayı dener.

apigee-monit'ı yükleme, yapılandırma ve kullanma hakkında bilgi edinmek için apigee-monit ile kendi kendini onarma başlıklı makaleyi inceleyin.

Yeni TLS yapılandırma özellikleri

Edge kullanıcı arayüzü, aşağıdakileri ayarlamak için kullanabileceğiniz yeni TLS yapılandırma özelliklerini destekler:

  • Varsayılan TLS protokolü
  • Desteklenen TLS protokollerinin listesi
  • Desteklenen TLS algoritmaları
  • Desteklenen TLS şifreleri

Daha fazla bilgi için İsteğe bağlı TLS özelliklerini ayarlama başlıklı makaleyi inceleyin.

Edge kullanıcı arayüzünde sanal ana makineler oluşturma, düzenleme ve silme

Kendi kendine hizmet işlevi genişletildi. Artık bir tarayıcıda (yalnızca Edge kullanıcı arayüzü) sanal ana makineler oluşturabilir, düzenleyebilir ve silebilirsiniz.

Daha fazla bilgi için Tarayıcı kullanarak sanal ana makine oluşturma başlıklı makaleyi inceleyin.

OpenAPI v3 desteği eklendi

Bu sürümde, OpenAPI sürüm 3 üzerinden proxy oluşturma desteği eklendi (yalnızca Edge kullanıcı arayüzü).

Desteklenen yazılımlar

Bu sürümde, desteklenen yazılımlarda aşağıdaki değişiklikler yapılmıştır:

Destek Eklendi Artık Desteklenmiyor

Bu sürümde aşağıdaki platformlar için destek eklendi:

  • Red Hat Enterprise Linux (RHEL) 7.6
  • CentOS 7.6
  • Oracle Linux 7.6

Bu sürümde aşağıdaki platformlar artık desteklenmemektedir:

  • RHEL/CentOS/Oracle 7.3 sürümü
  • RHEL/CentOS 6.8 sürümü
  • Oracle Linux 6.7

Desteklenen platformların tam listesi için Desteklenen yazılımlar ve desteklenen sürümler başlıklı makaleyi inceleyin.

Hata düzeltmeleri

Bu bölümde, bu sürümde düzeltilen Private Cloud hataları listelenmektedir. Ayrıca bu sürüm, Dahil Edilen Sürümler bölümünde 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
122694069

Zookeeper, yedekleme komut dosyası tarafından durdurulmadı

Bu düzeltmeden önce Zookeeper işlemi yedekleme komut dosyası tarafından durdurulmuyordu.
120993451

"Kuruluş yok" açılış sayfası eklendi

Artık ilişkili kuruluşu olmayan bir kullanıcıyla giriş yapan geliştiriciler, var olmayan bir sayfaya yönlendirilmiyor. Bu kullanıcılar için yeni bir açılış sayfası eklendi.
120682369

Özel raporları silme

Kullanıcılar, Yeni Edge deneyiminde özel raporları silemiyordu.
120681592

Yeni Edge deneyimindeki Geomap sekmesi

Kullanıcılar yeni Edge deneyiminde Coğrafi Harita sekmesine gittiğinde yeni Edge deneyimi hata veriyordu.
120624977

Zookeeper JVM seçenekleri

Zookeeper için Yapılandırma ile Kod'u kullanarak JVM seçeneklerini ayarlama çalışmıyordu.
80187407

İpuçlarında tanımlanamayan hatalar oluştu

Bir grafikte yalnızca bir zaman serisi olduğunda ipuçları tanımlanmamış hatalar veriyordu.
79949124

OpenAPI aracılığıyla ters proxy oluşturma

Proxy oluştururken OpenAPI kullan düğmesi çalışmıyordu.
77515655

Şifre sıfırlama bağlantıları gönderilmiyor

Kullanıcılar, şifrelerini sıfırlamak için bağlantı istediklerinde e-posta alamıyordu.
72799769

Şifre sıfırlama bağlantıları için yanlış başlıklar

Kullanıcı trustxforwarded özelliğini true olarak ayarladıktan sonra bile sonuçta elde edilen istek başlıkları HTTPS kullanmıyordu.
69550284

API proxy'leri oluşturmak için WSDL'leri kullanma

WSDL'ler kullanılırken API proxy'si oluşturulamıyordu.

Bilinen sorunlar

Aşağıdaki tabloda bu sürümdeki bilinen sorunlar listelenmiştir:

Sorun Kimliği Açıklama
135616498

apigee-sso yüklemesi için meta veri dosyası biçimi

apigee-sso yüklenirken ve URL yerine metadata.xml dosyası kullanılırken, metadata.xml dosyası dosyanın sonunda yeni bir satır (CRLF) içermiyorsa metadata.xml dosyası tamamen okunmaz.

Geçici çözüm:

Bu sorunu gidermek için aşağıdakilerden birini yapabilirsiniz:

  • metadata.xml dosyasının sonuna CRLF ekleyin.

    VEYA

  • Meta veriler için URL tabanlı bir konum kullanın
122370980

apigee-monit Amazon Linux 1'de desteklenmez

Geçici çözüm:

Yok.
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.

115278838

Oturum jetonları geçersiz kılınmıyor

Kullanıcı Apigee Edge Oturumu Kapat düğmesini tıkladığında oturum jetonları sunucuda geçersiz kılınmaz.

Geçici çözüm:

SAML ile yeni Edge deneyimini kullanın.

113342838

JMX kimlik doğrulaması etkinleştirildiğinde Cassandra işlemleri çalışmıyor

Geçici çözüm:

nodetool komutunu her çağırdığınızda kullanıcı adınızı ve şifrenizi ekleyin.

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.

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.

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.
65737520

Sistem yöneticisi şifresini sıfırlama işlemi başarısız oluyor

Özel karakterler içeren yönetim sunucusunun sistem yöneticisi şifresini sıfırlama işlemi başarısız olur.

Geçici çözüm:

Şifreyi bir veri dosyasında tanımlayın ve ardından Management API'deki /users uç noktasına iletin. Daha fazla bilgi için Sistem yöneticisi şifresini sıfırlama başlıklı makaleyi inceleyin.

Sonraki adım

Edge for Private Cloud 4.19.01'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:
Yeni sürüme geçiş yolları