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ü, Private Cloud için Apigee Edge'in yeni bir sürümünü yayınladık.

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 Private Cloud sürümünüze dahil olup olmadığını nasıl anlayabileceğinizi anlamak için Sürüm numaralandırma hakkında bölümüne bakın.

Yeni özellikler ve geliştirmeler

Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir. 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.

Diğer ayrıntılar ve talimatlar için Edge for Private Cloud dokümanlarına bakın.

Kurulum ve İşlem Kılavuzları dijital ortama taşındı

Artık Private Cloud için Edge Yükleme ve Operasyonlar kılavuzuna Sürüm 4.18.01'den erişebilirsiniz.

Yazılım güncellemeleri

Sürüme aşağıdaki yazılım güncellemeleri dahil edilmiştir:

  • 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 gerekir.
    Java 8'e yapılan güncelleme kapsamında bazı TLS şifreleri artık Oracle JDK 1.8'de kullanılamayacak. Tam liste için "Varsayılan Devre Dışı Bırakılan Şifre Paketleri" (http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html) bölümüne göz atın.
  • Cassandra 2.1.13 - Cassandra 2.0.15'ten güncellendi.

Yükleme, yükseltme, geri alma

Yükleme, yeni sürüme geçme ve ilgili komut dosyalarıyla ilgili değişikliklerin listesi aşağıda verilmiştir. Kullanım hakkında bilgi edinmek için Edge for Private Cloud belgelerine göz atın.

  • 4.16.01'den güncelleme yapmak için yeni işlem - Bu sürüm, yüklemenizi 4.16.01'den 4.16.05'e güncellemek için apigee-migrate yardımcı programını update.sh yardımcı programıyla değiştirir. Apigee Edge 4.16.01'i 4.16.05 sürümüne güncelleme bölümüne bakın.
  • Önyükleyici
    • bootstrap.sh (4.16.01 sürümü), 4.16.05 sürümünde artık bootstrap_4.16.05.sh.
    • bootstrap_4.16.05.sh uygulamasını indirmek için artık uname:pword öğesini 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ı. Bkz. 4.16.05 Geri Alma İşlemi.
  • setup.sh ve update.sh, günlük dosyasını /tmp adresine yazabilir - Varsayılan olarak setup.sh ve update.sh yardımcı programları, günlük bilgilerini /opt/apigee/var/log/apigee-setup dosyasına yazar. Yardımcı programı çalıştıran kullanıcının söz konusu dizine erişimi yoksa günlüğü /tmp dizinine yazar. 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'yi taşımak için yeniden yüklemeniz gerekiyordu. Yeni update.sh yardımcı programı, API BaaS'nin güncellenmesini destekler. Apigee Edge 4.16.01'i 4.16.05 sürümüne güncelleme bölümüne bakın.

Yönetim

Private Cloud yönetimi ve yapılandırmasıyla ilgili yeni özellikler aşağıda verilmiştir.

  • Yükleme doğrulaması - 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 bölümüne bakın.
  • Bölge adı: Bölge herhangi bir ad olabilir. Önceki sürümlerde ad, "dc-#" biçimindeydi ve # değeri bir tam sayıydı.
  • Ağ geçidi kapsülleri: Ağ geçidi kapsüllerinin herhangi bir adı olabilir. Önceki sürümlerde kapsülün "ağ geçidi" olarak adlandırılması gerekiyordu.
  • Komut dosyası tabanlı yönetim: Yeni bir apigee-adminapi.sh komut satırı yardımcı programı, Edge Management API'ye çağrı yaparak gerçekleştirdiğiniz Edge yapılandırma görevlerini gerçekleştirmenize olanak tanır. Apigee-adminapi.sh yardımcı programını kullanma bölümüne bakın.
  • Sanal ana makine SSL sessiz yapılandırması - Bir kuruluş veya ortam oluştururken artık sanal ana makinede SSL'yi yapılandırmak için mülkleri iletebilirsiniz. Kuruluşa katılma başlıklı makaleyi inceleyin.

API Hizmetleri

Ürünün önceki bulut sürümlerinde sunulan Edge API Hizmetleri için yeni özellikler aşağıda verilmiştir.

Sistem günlüğü mesaj günlüğü için sabit uzunlukta ön ek (Cloud 16.03.30)

Mesaj Kaydı Politikası'nın, Sistem Günlüğü yapılandırmasında yeni bir <FormatMessage> öğesi var. <FormatMessage>true</FormatMessage> ayarladığınızda sistem günlüğü mesajları sabit sayıda karakterle başlar. Bu sayede, Apigee'nin eklediği verileri filtreleyebilirsiniz. Daha fazla bilgi için Message Logging politikası'na göz atın. (APIRT-1398)

API proxy Temel Yolu'nda 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 karakteri kullanımını destekler. Örneğin /team/*/members temel yolu, yeni ekipleri desteklemek için yeni bir proxy oluşturmanıza gerek kalmadan istemcilerin proxy'nizi https://[host]/team/blue/members veya https://[host]/team/green/members ile çağırmasına olanak tanır. /**/ kullanımına 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 zincirlemesini destekler. Bu özellik, bir API proxy'sinin ek ağ ek yükü olmadan Edge kuruluşunuzda dağıtılan başka bir API proxy'sini çağırmasına olanak tanır. Önceden API proxy'si zincirleme işlemi, isteği bir yük dengeleyici, yönlendirici ve mesaj işlemcisi üzerinden yönlendiren başka bir API proxy'sine bir http(s) çağrısı gerektiriyordu.

API proxy'sinin TargetEndpoint'inde yeni LocalTargetConnection öğeleri bulunur. Bu öğeler; API proxy'si adı, API proxy'sindeki belirli bir ProxyEndpoint'in adını veya yerel API proxy kaynağının Temel Yolu'nu (ö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 sağlar.

Proxy zincirlemesi, Hizmet Çağrısı politikalarında da kullanılabilir.

Daha fazla bilgi için API proxy'lerini birbirine bağlama bölümüne bakın. Yeni LocalTargetConnection öğeleri, buradaki XML şemasında da listelenmiştir: 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, birincil olarak destek kayıtlarının düzeltilip düzeltilmediğini kontrol eden kullanıcılar içindir. Tüm kullanıcılara ayrıntılı bilgi sağlamak için tasarlanmamıştır.

Private Cloud için Edge 4.16.05

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

Bulut 16.03.30

Sorun Kimliği Açıklama
SECENG-584 Sertifika zincirindeki sertifikalar arasında yeni satır için doğrulama kontrolü, üretimdeki bazı sertifikalarda sorunlara neden oluyor
MGMT-3217 KVMap adı "anahtarlar" ile bitiyorsa Management API çağrıları başarısız oluyor
MGMT-3214 JavaScript çağrıları sırasında sınıf çakışmaları, müşterinin Java kodunun başarısız olmasına neden olabilir
MGMT-3185 Bir kuruluşa kuruluş yöneticileri eklenirken hata oluştu
EDGEUI-127 Yeni proxy düzenleyiciyle yetersiz izinler alma
EDGEUI-119 Kullanıcı arayüzü oturumu zaman aşımı sorunu
CORESERV-671 "Hiçbir zil yapılandırılmadı; cps hizmeti başlatılamıyor" hataları gösteriliyor
AXAPP-2345 CPU olmayan müşteriler için AX özel raporlarının listelenmesiyle ilgili sorun
AXAPP-2302 Günlük Apigee Analytics Özeti, geliştiriciler tarafından benimsenme oranının sıfır olduğunu gösteriyor
APIRT-2750 Belirli bir kuruluşta yüksek trafik hatası
APIRT-2516 JavaScript açıklama metinlerindeki çalışma zamanı hataları yanlış satır numaraları belirtiyor
APIRT-2508 Apps Kasası geri çağırması içinde ekspres dinleme çağrılırken hatadan çıkılıyor
APIRT-2336 Node.js ile ilgili Gzip sorunu
APIRT-1975 Mask Yapılandırmaları Message.content için çalışmıyor

Cloud 16.03.16 kullanıcı arayüzü

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

Cloud 16.03.09 kullanıcı arayüzü

Sorun Kimliği Açıklama
MGMT-3158 Bağımsız proxy'lerde RBAC API aracılığıyla ayarlandığında kullanıcı arayüzündeki izinler yetersiz
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 Bir günlük rapor tanımları, kullanıcı arayüzünde işlemleri yüklemiyor

Bulut 16.03.02

Sorun Kimliği Açıklama
MGMT-3083 Node.js Günlüklerinin otomatik yenilemesi, günlük mesajlarıyla çok ayrıntılı görünüyor
DEVRT-2275 Özel Özellik ücret planları, izin verilen 10 özellik yerine yalnızca 5 özellik gösterir
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ı verir

Bulut 16.02.17

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

Bilinen sorunlar

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

Sorun Kimliği Açıklama
APIRT-2978

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

Uç Yönlendirici, Nginx'i başlatamazsa veya /opt/apigee/var/log/edge-router/logs/system.log dosyasında gösterildiği gibi hiç başlatamazsa /opt/apigee/var/log/edge-router/logs/system.log 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

İleti İşleyici, IPv4 ve IPv6'da DNS araması yapıyor

NSCD'yi (Ad Hizmeti Önbelleği Arka Plan Programı) yükleyip etkinleştirdiyseniz Mesaj İşleyicilerin biri IPv4, diğeri IPv6 için olmak üzere iki DNS araması yaptığını fark edebilirsiniz.

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ştu

"Apigee-service Apigee-postgresql pg-data-purge" komutunu çalıştırır ve şu biçimde bir hata görürseniz:

HATA: ilişkinin sahibi olmalı

/opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge öğesini 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, Uydu Sunucusu 6'da kullanılan Katello aracısı, Qpid arka plan programını çalıştıran Apigee Edge ana makinelerine doğru şekilde yüklenmez.

Mesaj Ata, Java Çağrısı ve Hata Artırma politikalarındaki JSON yükleri

Mesaj Ata, Java Çağrısı ve Hata Artırma 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 üst bilgisinden tarihin çıkışını almak istiyorsanız mesajınıza {message.header.date} ekleyebilirsiniz.

İleti biçimi JSON ise şuna benzer:

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

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

  • Kıvrımlı açılış ayracı için ters eğik çizgi kullanarak çıkış yapı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 Özellik Sürümü için bir sonraki Edge Özellik Sürümü'nde, JSON mesajlarındaki değişkenler için herhangi bir sorun yaşamadan süslü ayraçları kullanabileceksiniz. (APIRT-1160)

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

Uç Yönlendirici, Nginx'i başlatamazsa veya /opt/apigee/var/log/edge-router/logs/system.log dosyasında gösterildiği gibi hiç başlatamazsa /opt/apigee/var/log/edge-router/logs/system.log 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