4.16.05 - Edge for Private Cloud sürüm notları

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

31 Mayıs 2016 Salı günü, Apigee Edge Private Cloud'un yeni bir sürümünü yayınladık.

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

Belirli bir bulut sürümünün Edge for Private Cloud sürümünüze dahil olup olmadığını nasıl anlayacağınızı öğrenmek için Sürüm numaralandırma hakkında başlıklı makaleyi inceleyin.

Yeni özellikler ve geliştirmeler

Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir. Bu sürüm, aşağıdaki geliştirmelerin yanı sıra kullanılabilirlik, performans, güvenlik ve kararlılıkla ilgili çeşitli geliştirmeler de içerir.

Daha fazla bilgi ve talimat için Edge for Private Cloud belgelerine bakın.

Yükleme ve İşletim Kılavuzları online ortama taşındı

Artık 4.18.01 sürümünde Edge for Private Cloud Installation and Operations Guide'a erişebilirsiniz.

Yazılım güncellemeleri

Sürüme aşağıdaki yazılım güncellemeleri dahildir:

  • Java JDK 1.8: En yeni Java özelliklerinden yararlanmak için bu sürüm Java 1.8 ile uyumludur. Ortamınızda Oracle JDK 1.8 veya OpenJDK 8 gereklidir.
    Java 8'e yapılan güncelleme kapsamında, bazı TLS şifreleri artık Oracle JDK 1.8'de kullanılamıyor. Tam liste için "Varsayılan olarak devre dışı bırakılan şifreleme paketleri" bölümüne bakın: http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.
  • Cassandra 2.1.13: Cassandra 2.0.15'ten güncellendi.

Yükleme, yükseltme, geri alma

Aşağıda, yükleme, yükseltme ve ilgili komut dosyalarında yapılan değişikliklerin listesi verilmiştir. Kullanımla ilgili bilgi için Edge for Private Cloud belgelerine bakın.

  • 4.16.01 sürümünden güncellemek için yeni işlem: Bu sürümde, apigee-migrate yardımcı programı yerine update.sh yardımcı programı kullanılarak yüklemenizi 4.16.01 sürümünden 4.16.05 sürümüne güncelleyebilirsiniz. Apigee Edge 4.16.01'i 4.16.05'e güncelleme başlıklı makaleyi inceleyin.
  • Bootstrap
    • bootstrap.sh (4.16.01 sürümü) artık 4.16.05 sürümünde bootstrap_4.16.05.sh.
    • bootstrap_4.16.05.sh uygulamasını indirmek için artık uname:pword belirtmeniz gerekmiyor.
  • Geri alma: Bir güncellemeyi 4.16.05 sürümüne geri almak için bileşenin 4.16.05 sürümünü kaldırıp önceki sürümü yeniden yüklersiniz. Önceki rollback.sh yardımcı programı kaldırıldı. 4.16.05 Geri Alma İşlemi başlıklı makaleyi inceleyin.
  • setup.sh ve update.sh, günlük dosyasını /tmp konumuna yazabilir. - Varsayılan olarak, setup.sh ve update.sh yardımcı programları günlük bilgilerini /opt/apigee/var/log/apigee-setup konumuna yazar. Yardımcı programı çalıştıran kullanıcının bu dizine erişimi yoksa günlük, /tmp dizinine yazılır. Kullanıcının /tmp erişimi yoksa yardımcı program başarısız olur.
  • API BaaS güncelleme prosedürü: 4.16.01 sürümünde, API BaaS'ı taşımak için yeniden yüklemeniz gerekiyordu. Yeni update.sh yardımcı programı, API BaaS'nin yerinde güncellenmesini destekler. Apigee Edge 4.16.01'i 4.16.05'e güncelleme başlıklı makaleyi inceleyin.

Yönetim

Aşağıda, özel bulut yönetimi ve yapılandırmasıyla ilgili yeni özellikler verilmiştir.

  • Yükleme doğrulama - Edge Private Cloud yüklemenizi test etmek için kullanılan apigee-validate yardımcı programı artık Yönetim Sunucusu'ndan çalıştırılabilir. Daha önce komut dosyasının Mesaj İşleyici'de çalıştırılması gerekiyordu. Yüklemeyi test etme başlıklı makaleyi inceleyin.
  • Bölge adı: Bölge herhangi bir ad olabilir. Önceki sürümlerde ad, # bir tam sayı değeri olmak üzere "dc-#" biçimindeydi.
  • Ağ geçidi kapsülleri: Ağ geçidi kapsüllerinin adı herhangi bir ad olabilir. Önceki sürümlerde, pod'un adı "gateway" olmalıydı.
  • Komut dosyası tabanlı yönetim: Yeni bir apigee-adminapi.sh komut satırı yardımcı programı, Edge yönetim API'sine çağrı yaparak gerçekleştirdiğiniz Edge yapılandırma görevlerini yapmanıza olanak tanır. apigee-adminapi.sh yardımcı programını kullanma başlıklı makaleyi inceleyin.
  • Sanal ana makine SSL'sinin sessiz yapılandırması: Artık bir kuruluş veya ortam oluştururken sanal ana makinede SSL'yi yapılandırmak için özellikleri iletebilirsiniz. Kuruluş ekleme başlıklı makaleyi inceleyin.

API Hizmetleri

Aşağıda, ürünün önceki bulut sürümlerinde sunulan Edge API Hizmetleri'ne yönelik yeni özellikler yer almaktadır.

Syslog mesajı günlüğe kaydı için sabit uzunluklu önek (Cloud 16.03.30)

İleti Günlüğü politikası, Syslog yapılandırmasında yeni bir <FormatMessage> öğesine sahip. <FormatMessage>true</FormatMessage> ayarını yaparak Syslog mesajlarının sabit sayıda karakterle başlamasını sağlayabilirsiniz. Bu sayede, Apigee tarafından eklenen verileri filtreleyebilirsiniz. Daha fazla bilgi için İleti Günlüğü Politikası'na bakın. (APIRT-1398)

API proxy'si Temel Yolunda joker karakter (Cloud 16.03.09 kullanıcı arayüzü)

Yönetim kullanıcı arayüzü, API proxy'si temel yollarında bir veya daha fazla /*/ joker karakterin kullanılmasını destekler. Örneğin, /team/*/members temel yolu, yeni ekipleri desteklemek için yeni bir proxy oluşturmanız gerekmeden istemcilerin https://[host]/team/blue/members veya https://[host]/team/green/members ile proxy'nizi çağırmasına olanak tanır. /**/ karakterine izin verilmediğini unutmayın. (MGMT-3154)

API proxy zincirleme (Cloud 16.03.02, Cloud 16.03.09 kullanıcı arayüzü)

Edge, yerel API proxy zincirlemeyi destekler. Bu özellik, bir API proxy'sinin ek ağ yükü olmadan Edge kuruluşunuzda dağıtılan başka bir API proxy'sini çağırmasına olanak tanır. Daha önce, API proxy'si zincirleme işlemi için başka bir API proxy'sine http(s) çağrısı yapılması gerekiyordu. Bu çağrı, isteği bir yük dengeleyici, yönlendirici ve mesaj işlemcisi üzerinden yönlendiriyordu.

API proxy'sinin TargetEndpoint'inde yeni LocalTargetConnection öğeleri kullanılabilir. Bu öğeler, API proxy adı, API proxy'sindeki belirli bir ProxyEndpoint'in adı veya yalnızca yerel bir API proxy kaynağının temel yolunu (ör. /v1/myresource) belirtmenize olanak tanır. Proxy düzenleyici kullanıcı arayüzü, bir TargetEndpoint eklediğinizde veya güncellediğinizde de bu seçenekleri sunar.

Proxy zincirleme, hizmet çağrısı politikalarında da kullanılabilir.

Daha fazla bilgi için API proxy'lerini birlikte zincirleme başlıklı makaleyi inceleyin. Yeni LocalTargetConnection öğeleri, XML şemasında da listelenir: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (MGMT-3049, MGMT-3050)

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir. Bu liste, öncelikli olarak destek taleplerinin düzeltilip düzeltilmediğini kontrol eden kullanıcılar içindir. Tüm kullanıcılar için ayrıntılı bilgi sağlamak üzere tasarlanmamıştır.

Edge for Private Cloud 4.16.05

Sorun Kimliği Açıklama
PRC-770 16.01 yükleyici, Postgres bekleme sunucusunu axgroup'ta kaydettiremiyor
PRC-758 Kullanıcı rolüne sahip kullanıcılar özel raporları düzenleyebilir
PRC-883 Ana-bekleme yapılandırmasına sahip Postgres sunucusunda güncelleme işlemi başarısız oluyor

Cloud 16.03.30

Sorun Kimliği Açıklama
SECENG-584 Sertifika zincirindeki sertifikalar arasında yeni satır için yapılan doğrulama kontrolü, üretimdeki bazı sertifikalarda sorunlara neden oluyor
MGMT-3217 KVMap adı "keys" ile bitiyorsa Management API çağrıları başarısız oluyor
MGMT-3214 JavaCallout'lar sırasında sınıf çakışmaları meydana gelebilir ve müşterinin Java kodunun başarısız olmasına neden olabilir
MGMT-3185 Kuruluşa kuruluş yöneticileri eklenirken hata oluştu
EDGEUI-127 Yeni proxy düzenleyiciyle yetersiz izin alma
EDGEUI-119 Kullanıcı arayüzü oturum zaman aşımı sorunu
CORESERV-671 "No rings configured; Cannot initialize cps service" (Zil sesi yapılandırılmadı; cps hizmeti başlatılamıyor) hatalarını görme
AXAPP-2345 AX listeleme raporlarında, CPS müşterisi olmayanlar için özel rapor oluşturma sorunu
AXAPP-2302 Günlük Apigee Analytics Özeti'nde geliştirici benimsenmesi sıfır gösteriliyor
APIRT-2750 Belirli bir kuruluşta trafik hatalarının yüksek olması
APIRT-2516 JavaScript açıklama metinlerindeki çalışma zamanı hataları yanlış satır numaralarını belirtiyor
APIRT-2508 Kasada geri çağırma işlemi sırasında anında dinleme çağrılırken çıkış hatası
APIRT-2336 Node.js ile ilgili Gzip sorunu
APIRT-1975 Maske yapılandırmaları, message.content için çalışmıyor

Cloud 16.03.16 UI

Sorun Kimliği Açıklama
MGMT-3142 Hata Analizi kontrol panelinde grafikler yüklenmiyor (güncellenmiş düzeltme)

Cloud 16.03.09 kullanıcı arayüzü

Sorun Kimliği Açıklama
MGMT-3158 API aracılığıyla tek tek proxy'lerde RBAC ayarlandığında kullanıcı arayüzünde yetersiz izinler
MGMT-3142 Grafikler, hata analizi kontrol panelinde yüklenmiyor
MGMT-3118 Kullanıcı arayüzünde "clientAuthEnabled" parametresi için yanlış SSL sanal ana makine yapılandırması gösteriliyor
DEVRT-2344 Tek günlük rapor tanımları, işlemleri kullanıcı arayüzüne yüklemiyor

Cloud 16.03.02

Sorun Kimliği Açıklama
MGMT-3083 Node.js günlüklerinin otomatik yenilenmesi, günlük mesajlarıyla çok ayrıntılı
DEVRT-2275 Özel özellikli fiyat planları, izin verilen 10 özellik yerine yalnızca 5 özellik gösteriyor
DEVRT-1275 Ücret planı açılır menüsünde tüm geliştiriciler gösterilmiyor
DEVRT-1074 Bakiyesi sıfır olan ön ödemeli geliştirici, kredi uygulandığında NullPointerException hatası alıyor

Cloud 16.02.17

Sorun Kimliği Açıklama
MGMT-3083 Node.js günlüklerinin otomatik yenilenmesi, günlük mesajlarıyla çok ayrıntılı
MGMT-3077 Kullanıcı arayüzü, varsayılan ad alanını kullanan bir WSDL'den geçersiz bir proxy paketi oluşturuyor
MGMT-1642 Özel kullanıcı rolünde, geliştirici uygulamaları için "get" izni eksik

Bilinen sorunlar

Bu sürümde aşağıdaki bilinen sorunlar var.

Sorun Kimliği Açıklama
APIRT-2978

Yönlendirici Nginx'i başlatamıyor veya yönlendirici başlatılamıyor

/opt/apigee/var/log/edge-router/logs/system.log dosyasında gösterildiği gibi, Edge yönlendirici Nginx'i başlatamazsa veya hiç başlatılamazsa /opt/nginx/conf.d dizinindeki tüm dosyaları silin ve yönlendiriciyi yeniden başlatın:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

Mesaj İşleyici, IPv4 ve IPv6 üzerinde DNS araması yapar

NSCD'yi (Name Service Cache Daemon) yükleyip etkinleştirdiyseniz Mesaj İşleyiciler'in iki DNS araması yaptığını fark edebilirsiniz: biri IPv4, diğeri IPv6 için.

IPv6'da DNS aramasını devre dışı bırakmak için:

  1. Her Mesaj İşleyici düğümünde /etc/nscd.conf dosyasını düzenleyin.
  2. Aşağıdaki özelliği ayarlayın:

    enable-cache hosts no
PRC-1118

"apigee-service apigee-postgresql pg-data-purge" komutu çalıştırılırken hata oluşuyor

"apigee-service apigee-postgresql pg-data-purge" komutunu çalıştırdığınızda aşağıdaki biçimde bir hata görürseniz:

HATA: İlişkinin sahibi olmalıdır

/opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge dosyasını düzenleyin ve aşağıdaki özelliği "apigee" olarak ayarlayın:

POSTGRES_USER=apigee

DOC-1687 Bilinen bir paket bağımlılığı çakışması nedeniyle, Satellite Server 6'da kullanılan Katello aracısı, Qpid arka plan programı çalıştıran Apigee Edge ana makinelerine düzgün şekilde yüklenmez.

Assign Message, Java Callout ve Raise Fault politikalarındaki JSON yükleri

Assign Message, Java Callout ve Raise Fault politikaları, <Set><Payload> öğesini kullanarak ileti içeriği oluşturmanıza olanak tanır. Bu mesajların bir parçası olarak, değerleri çalışma zamanında otomatik olarak doldurulan değişkenler ekleyebilirsiniz. Örneğin, HTTP üstbilgisindeki tarihi çıktı olarak almak istiyorsanız iletinize {message.header.date} ekleyebilirsiniz.

Mesaj biçimi JSON ise şöyle görünür:

{"The date is: " : "{message.header.date}"}

Ancak bunun hatalı biçimlendirilmiş bir JSON olduğunu görebilirsiniz. Bu sorunu çözmek için iki seçeneğiniz vardır:

  • Açılış süslü parantezinden ters eğik çizgiyle çıkın:
    \{"The date is: " : "{message.header.date}"}
  • Yük öğesi yapılandırmasında, JSON yükündeki bir değişkeni belirtmek için variablePrefix ve variableSuffix özelliklerini kullanın. Örneğin:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

Özel bulut için Edge'in bir sonraki özellik sürümünde, JSON mesajlarındaki değişkenler için sorunsuz bir şekilde küme parantezleri kullanabileceksiniz. (APIRT-1160)

Yönlendirici Nginx'i başlatamıyor veya Yönlendirici başlatılamıyor

/opt/apigee/var/log/edge-router/logs/system.log dosyasında gösterildiği gibi, Edge yönlendirici Nginx'i başlatamazsa veya hiç başlatılamazsa /opt/nginx/conf.d dizinindeki tüm dosyaları silin ve yönlendiriciyi yeniden başlatın:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart