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

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

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 anlayabileceğinizi öğ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ümde, aşağıdaki geliştirmelerin yanı sıra kullanılabilirlik, performans, güvenlik ve kararlılıkla ilgili çeşitli geliştirmeler de yer almaktadır.

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 Yükleme ve İşlemler kılavuzuna erişebilirsiniz.

Yazılım güncellemeleri

Sürümde aşağıdaki yazılım güncellemeleri yer alır:

  • 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 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üncelleme için yeni süreç: Bu sürümde, 4.16.01 sürümünden 4.16.05 sürümüne güncelleme yapmak için apigee-migrate yardımcı programı yerine update.sh yardımcı programı kullanılır. 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 bootstrap_4.16.05.sh 4.16.05 sürümünde.
    • 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 Süreci bölümüne bakın.
  • 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

Private Cloud yönetimi ve yapılandırması için yeni özellikler aşağıda 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 Message Processor'da ç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, "dc-#" biçimindeydi. Burada #, tam sayı değerini ifade ediyordu.
  • Ağ geçidi kapsülleri: Ağ geçidi kapsülleri herhangi bir ada sahip 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'sini sessizce yapılandırma: Artık bir kuruluş veya ortam oluştururken sanal ana makinede SSL'yi yapılandırmak için özellikleri iletebilirsiniz. Kuruluşları dahil etme 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 verilmiştir.

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

İleti Günlüğü politikası, Syslog yapılandırmasında yeni bir <FormatMessage> öğesi içerir. <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ı'nı inceleyin. (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 karakter kullanımı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. /**/ politikasına izin verilmediğini unutmayın. (MGMT-3154)

API proxy'si 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, isteği yük dengeleyici, yönlendirici ve mesaj işleyici üzerinden yönlendiren başka bir API proxy'sine http(s) çağrısı yapılmasını gerektiriyordu.

API proxy'sinin TargetEndpoint'inde yeni LocalTargetConnection öğeleri kullanılabilir. Bu öğeler, API proxy adı, API proxy'sindeki belirli bir ProxyEndpoint'in adı veya yerel bir API proxy kaynağının (ör. /v1/myresource) temel yolunu 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 birbirine bağlama 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, öncelikle destek kayıtlarının 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'a 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 izinler 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 Listing AX'in CPS dışı müşteriler için özel raporlarında sorun
AXAPP-2302 Günlük Apigee Analytics Özeti'nde geliştirici kullanımı 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 Kasa geri araması sırasında hızlı dinleme özelliği çağrıldığında çı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 UI

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 paneline 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 ücret planlarında, izin verilen 10 özellik yerine yalnızca 5 özellik gösteriliyor
DEVRT-1275 Ücret planı açılır menüsünde tüm geliştiriciler gösterilmez
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 vardır.

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 İşleyicilerin 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. Şu ö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ırıp 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 daemon'u ç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 mesaj 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 çıkarmak istiyorsanız iletinize {message.header.date} ekleyebilirsiniz.

İleti biçimi JSON ise ileti şu şekilde görünür:

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

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

  • Açma küme parantezinden önce ters eğik çizgi kullanı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