4.15.07.00 - Private Cloud için Apigee Edge sürüm notları

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

8 Eylül 2015 Salı günü, Private Cloud için Apigee Edge'in önemli bir özellik sürümünü kullanıma sunduk.

Private Cloud için önceki üç aylık Edge sürümünden (4.15.04.00) bu yana aşağıdaki sürümler yayınlandı ve bu üç aylık sürüme dahil edildi:

• Bulut: 15.04.15, 15.04.29, 15.05.27, 15.06.10 ve 15.06.24
• Private Cloud: 4.15.04.01

Hangi Edge sürümlerine yükseltme yapabilirsiniz? 4.15.07.00

Kullandığınız Edge sürümüne bağlı olarak şunları yapabilirsiniz:

• Doğrudan 4.15.07.00 sürümüne yükseltme
• Artımlı yükseltme. Yani mevcut sürümünüzden Edge'in başka bir sürümüne, ardından 4.15.07.00 sürümüne geçmeniz gerekir.

Daha fazla bilgi için 4.15.07.00 sürümüne hangi Edge for Private Cloud sürümlerini yükseltebilirsiniz? başlıklı makaleyi inceleyin.

4.15.01.x sürümünden veya önceki bir sürümden yükseltme yapmadan önce

1. Cassandra SSTable sürümünü kontrol edin:
   1. Dizini /<install-root>/apigee4/data/cassandra/data olarak değiştirin.
   2. Bir find komutu çalıştırın,
      > find . -name *-ic-*
      Cassandra 1 .2 SSTable kullanıyorsanız sonuçlar bir dizi.db dosyası döndürür.
   3. Şu bulma komutunu çalıştırın:
      > find . -name *-hf-*
      Sonuçlar boş olmalıdır. Yani hf biçiminde .db dosyası yoktur. hf biçiminde dosya görmüyorsanız işlemi tamamlamışsınız demektir ve 4.15.07.00 sürümüne yükseltebilirsiniz.
      
      hf biçimi, Cassandra 1.0 SSTables içindir. hf biçiminde *.db dosyalarınız varsa SSTable'yi bu işlemin geri kalanında açıklandığı şekilde yükseltmeniz gerekir.
2. hf biçiminde *.db dosyaları bulursanız tüm Cassandra düğümlerini yükseltene kadar her Cassandra düğümünde aşağıdaki komutu çalıştırarak SSTable'yi yükseltin:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. Tüm *.db dosyalarının Cassandra 1.2 sürümü için ic biçiminde olup olmadığını kontrol etmek üzere 1. adımı tekrarlayın.
4. Edge kurulumunuzdaki her Cassandra düğümünde 1 ile 3 arasındaki adımları tekrarlayın.
5. Edge 4.15.07.00 sürümüne yükseltin.
6. 4.15.07.00 yükseltmesinden sonra, *.db dosyalarının hepsinin C* 2.0 stili sstable sürümüne yükseltildiğinden emin olmak için dosyaları kontrol edin:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   Cassandra 2 .0 kullanıyorsanız bu komut bir dizi.db dosyası döndürür.

Yeni özellikler ve geliştirmeler

Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda verilmiştir.

Yükleme ve yükseltme

Seçili bileşenleri yükseltme ve kaldırma

apigee-upgrade.sh ve apigee-uninstall.sh komut dosyaları artık yükseltilecek veya kaldırılacak Edge bileşenlerini seçmenize olanak tanır. Daha önce düğümdeki tüm bileşenleri yükseltmiş veya kaldırmış olabilir. (OPDK-1377, OPDK-1175)

Yükseltmeyi geri alma

apigee-upgrade.sh yükseltme işlemi sırasında başarısız olursa yükseltmeyi geri almak için artık apigee-rollback.sh komut dosyasını kullanabilirsiniz. Yükseltmeyle ilgili sorunları düzelttikten sonra yükseltme işlemini tekrar deneyebilirsiniz. (OPDK-1275)

Kısaltılmış yükleyici komut dosyası seçenekleri

Yükleme komut dosyaları artık --help gibi uzun seçenek biçimlerini kabul etmiyor. Artık yalnızca tek harfli seçenekler (ör. -h) kabul edilir. (OPDK-1356)

SmartDocs kurulumu

SmartDocs'u setup-smartdocs.sh komut dosyasıyla yüklerken kuruluş, ortam ve sanal ana makineyi girmeniz istenir. Bu, SmartDocs'un beklenen konuma yüklenmesini sağlar. Daha önce bu değerler komut dosyasına sabit kod olarak yazılıyordu. (OPDK-1310)

update-cass-pwd-in-config.sh dosyasını istem olmadan çalıştırma

ENABLE_CASS_AUTH, CASS_USERNAME ve CASS_PASSWORD ortam değişkenlerini ayarlarsanız update-cass-pwd-in-config.sh komut dosyası istem olmadan çalışabilir. (OPDK-1309)

Edge Platform

Bu sürüme eklenen yeni Edge platformu özellikleri aşağıda verilmiştir.

Edge Private Cloud tarafından desteklenen OpenJDK 1.7

Edge'in bu sürümü Oracle JDK 1.7 ve OpenJDK 7'yi destekler. JDK 1.6 desteği kaldırılmıştır. (OPDK-1187)

İşletim sistemi desteği

Private Cloud için Apigee Edge, işletim sistemi desteğini Red Hat Enterprise Linux 6.6 ve 7.0 (64 bit), CentOS 6.5, 6.6 ve 7.0 (64 bit) ve Oracle Linux 6.5'i içerecek şekilde genişletti.

OPDK 15.07'ye Cassandra 2.0.15 dahil edildi

Bu sürümde Cassandra 2.0.15 kurulur. Önceki bir sürüme yükseltme yapıyorsanız Cassandra sürümünüz güncellenir. (OPDK-1197)

OAuth jetonu karma oluşturma işlemi için SHA2 desteği

Edge, veritabanı güvenlik ihlali durumunda OAuth jetonlarını daha iyi korumak için OAuth jetonlarının karma oluşturma işleminde SHA2 algoritmalarını (SHA1'e ek olarak) destekler. Yeni kuruluş düzeyindeki özellikler sayesinde, yeni jetonlar için karma oluşturma işlemini etkinleştirip yapılandırabilir ve bu yeni özellikten önce var olan tüm jetonlarda eski karma oluşturma işlemini koruyabilirsiniz. Daha önce Private Cloud için Edge'de, keymanagement.properties dosyasında (yönetim sunucunuzda ve mesaj işleyicilerinizde) hash.oauth.tokens.enabled adlı bir özellik, OAuth jetonlarının otomatik SHA1 karma oluşturma işlemini etkinleştiriyordu. Bu özelliğin desteği sonlandırıldı.

SHA1 karma oluşturmayı etkinleştirmek için daha önce hash.oauth.tokens.enabled mülkünü kullandıysanız bu sürümün yükseltme komut dosyası, yeni kuruluş düzeyindeki mülkleri sizin için otomatik olarak oluşturur. Yükseltme işleminden sonra doğrulama yapmak için şu API ile sistem yöneticisi olarak GET isteği gönderin: https://{host}:{port}/v1/o/{your_org}.

• Yeni özelliklerle kuruluşunuzda jeton karma oluşturma özelliğini etkinleştirme hakkında bilgi edinmek için Erişim jetonu isteme konusundaki "Veritabanında jeton karma oluşturma" bölümüne bakın.
• Mevcut jetonları toplu olarak karma oluşturma hakkında bilgi edinmek için Private Cloud için Edge İşlem Kılavuzu'na bakın. (APIRT-1389)

Günlük dosyaları için düz dizin yapısı

message-logging.properties dosyasında yeni bir enable.flat.directory.structure özelliğini true değerine ayarlayarak Edge'i günlük dosyalarını düz bir dizin yapısında depolayacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için Mesaj Günlüğe Kaydetme Politikası'nı inceleyin. (APIRT-1394)

Ortam önbelleği performansı

Daha iyi bellek içi önbellek yönetimi ve kullanımı için ortam önbelleği kaynaklarındaki "Bellekteki Maksimum Öğe Sayısı" ayarlarının desteği sonlandırıldı. Tüm önbellek kaynaklarında (varsayılan önbellek dahil) bulunan toplam öğe sayısı, önbelleğe ayrılan toplam belleğe bağlıdır. Varsayılan olarak, belirli bir mesaj işleyicide bellek içi önbelleğe alma için ayrılan toplam bellek, mesaj işleyicinizin cache.properties dosyasında bulunan önbellek mülk ayarlarına göre belirlenir ve kullanılabilir toplam belleğin% 40'ıdır. Öğeler yalnızca yeterli önbellek belleği olmadığında veya öğelerin süresi dolduğunda bellek içi önbellekten çıkarılır.

Önbellek yönetimi için "Hafızadaki Maksimum Öğe Sayısı" özelliğinin kullanıldığı eski davranışa geri dönmek isterseniz cache.properties dosyasında overrideMaxElementsInCacheResource=false özelliğini ayarlayın. (APIRT-1140)

API Hizmetleri

Bu sürüme eklenen yeni API Hizmetleri özellikleri aşağıda verilmiştir.

Varsayılan olarak yeni Proxy Düzenleyici

Yeni API proxy düzenleyici, yönetim kullanıcı arayüzünde varsayılan olarak etkindir. Yeni düzenleyici, Genel Bakış sayfasındaki koşullu akışlar ve uç noktaların daha kapsamlı görünümleri, Geliştirme sayfasındaki tüm yapılandırma, koşullu akışlar, uç noktalar ve politikaların daha sezgisel bir şekilde eklenmesi, küçük snippet'ler yerine daha kapsamlı XML görünümleri, dosya adlarını ve metni tarayan arama ve daha birçok özellik de dahil olmak üzere birçok kullanılabilirlik iyileştirmesi içerir. (MGMT-2279)

Yeni OAuth v2.0 Bilgilerini Silme Politikası

Yeni "OAuth v2.0 Bilgilerini Silme" politikası, OAuth v2 erişim jetonlarını ve yetkilendirme kodlarını silmenize olanak tanır. Politika, daha önce yönetim API'si tarafından sağlanan işlevin yerini alır. Daha fazla bilgi için OAuthV2 Bilgilerini Silme Politikası'nı inceleyin. (MGMT-2257)

Yeni OAuth v1.0 Bilgilerini Silme Politikası

Yeni "OAuth v1.0 Bilgilerini Silme" politikası, OAuth v1.0 istek jetonlarını, erişim jetonlarını ve doğrulayıcı kodlarını silmenize olanak tanır. Politika, daha önce yönetim API'si tarafından sağlanan işlevin yerini alır. Daha fazla bilgi için OAuth V1 Bilgilerini Silme Politikası başlıklı makaleyi inceleyin. (APIRT-1351)

Erişim Denetimi politikası

Erişim Denetimi politikası, IP adresleri X-FORWARDED-FOR HTTP üst bilgisinde bulunduğunda izin verilenler listesine ekleme ve engellenenler listesine ekleme için IP adreslerinin daha ayrıntılı bir şekilde değerlendirilmesine olanak tanıyacak şekilde geliştirildi.

Başlıkta birden çok IP adresi kontrolü etkinleştirildiğinde (feature.enableMultipleXForwardCheckForACL özelliğini ayarlamak için Destek Ekibi ile iletişime geçin), politikadaki yeni <ValidateBasedOn> öğesi, ilk IP, son IP veya başlıktaki tüm IP'lere göre kontrol yapmanıza olanak tanır. Daha fazla bilgi için Erişim Denetimi Politikası'nı inceleyin.

Erişim Varlık Politikası'ndaki yeni varlıklar

Erişim Öğesi politikası, aşağıdaki yeni öğelere erişim sağlar: consumerkey-scopes, authorizationcode, requesttoken ve verifier. Daha fazla bilgi için Erişim Varlık Politikası'na bakın.

İstatistik Toplayıcı politikası: İstatistik adının otomatik olarak küçük harfe dönüştürülmesi

API proxy düzenleyicisinde (Geliştirme sayfası > Araçlar > Özel Analytics Koleksiyonu) özel bir analiz koleksiyonu oluştururken "Ad" toplayıcı değişkeni (istatistik) küçük harf olmalıdır. Adı büyük harflerle girerseniz araç, İstatistik Adı'nı İstatistik Toplayıcı politikasında otomatik olarak küçük harflere dönüştürür. (MGMT-740)

API proxy düzenleyicisinde Klasik İzleme'nin kaldırılması

API proxy düzenleyicisindeki Trace işlevinin en yeni sürümü, beta sürümden genel kullanıma sunuldu. "Trace'in klasik sürümüne erişin" bağlantısı ile "klasik izlemeye" erişim artık kullanılamıyor.

Yönetim kullanıcı arayüzü Yardım menüsünden Apigee Topluluğu'na erişim

Apigee Topluluğu'na yönetim kullanıcı arayüzü Yardım menüsünden erişebilirsiniz.

Yönetim kullanıcı arayüzündeki hata mesajları

Yönetim kullanıcı arayüzündeki hata mesajı geliştirmeleri aşağıda verilmiştir:

• Silinmediği sürece oturum açma oturumunun tamamında kullanıcı arayüzündeki tüm hata mesajlarını gruplandırmak ve görüntülemek için kullanılan yönetim kullanıcı arayüzü. Bu güncellemeyle, hata mesajları oluştukları sayfadan ayrıldığınızda otomatik olarak silinir. (MGMT-2254)
• Yönetim kullanıcı arayüzü artık yinelenen hata mesajlarını gizlemiyor. (MGMT-2242)

Kullanıcı arayüzü performansı ve hata iyileştirmeleri

Sayfa görüntüleme performansı ve hata mesajı temizliği de dahil olmak üzere yönetim kullanıcı arayüzünün farklı alanlarında genel iyileştirmeler yapıldı.

Yönetim kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasındaki rol köprüleri

Yönetim kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasında (Yönetici > Kuruluş Kullanıcıları), rol adları artık köprü bağlantısı içerecek şekilde değiştirildi. Bu sayede, rol sayfalarına hızlıca gidebilirsiniz. (MGMT-1055)

Mesaj akışında yeni hedef değişkenler

Mesaj akışlarındaki yeni değişkenler, hedef uç noktalar ve hedef sunucular için daha kapsamlı URL bilgileri sağlar:

• TargetEndpoint: request.url, target.basepath.with.query yerine geçer.
• TargetServer: loadbalancing.targetserver, targetserver.name yerine geçer. Ayrıca target.basepath, yalnızca TargetEndpoint'in HTTPTargetConnection <LoadBalancer> öğesinde <Path> öğesi kullanıldığında doldurulur.

Sunucu Adı Göstergesi (SNI) desteği

Edge, güney yönlü Sunucu Adı Göstergesi'nin (ileti işleyiciden hedef uç noktalara) kullanımını destekler. SNI kullanmak istiyorsanız Apigee Destek Ekibi ile iletişime geçin.

Java 1.7 gereklidir.

TLS/SSL'nin bir uzantısı olan SNI ile, tüm bu hedeflerin aynı sertifikayı kullanması gerekmeden aynı IP adresinden ve bağlantı noktasından birden fazla HTTPS hedefi sunulabilir.

Edge'e özgü yapılandırma gerekmez. Ortamınız güney yönlü SNI için yapılandırılmışsa (Edge Cloud varsayılan olarak bu şekilde yapılandırılmıştır) Edge bunu destekler.

Edge, ana makine adını istek URL'sinden otomatik olarak ayıklayıp SSL el sıkışması isteğine ekler. Örneğin, hedef ana makine https://example.com/request/path ise Edge, aşağıdaki gibi server_name uzantısını ekler:

SNI hakkında daha fazla bilgi için http://en.wikipedia.org/wiki/Server_Name_Indication adresine bakın.

SSL Sertifikaları ayrıntılarındaki "İmza Algoritması"

SSL sertifika ayrıntılarına yeni bir "İmza Algoritması" alanı eklendi. Bu alanı yönetim kullanıcı arayüzünde (Yönetici > SSL Sertifikaları) ve yönetim API'sinde (Anahtar Deposundan veya Güven Deposundan Sertifika Ayrıntılarını Alın) görebilirsiniz. Alan, sertifikayı oluşturmak için kullanılan karma oluşturma algoritmasının türüne bağlı olarak "sha1WithRSAEncryption" veya "sha256WithRSAEncryption" değerini gösterir.

Geçerlilik süresi dolmak üzere olan SSL sertifikalarını gösterme

Yönetim kullanıcı arayüzündeki SSL Sertifikaları sayfasında (Yönetici > SSL Sertifikaları), yeni son kullanma tarihi açılır listesinde yaptığınız seçime bağlı olarak SSL sertifikalarının 10, 15, 30 veya 90 gün içinde son kullanma tarihi gösterilir.

Tehditlere karşı koruma hatası yapılandırması

Edge, varsayılan olarak bir ileti JSON veya XML Tehdit Koruma politikasından geçemezse HTTP 500 Dahili Sunucu Hatası durum kodu ve ExecutionFailed hatası döndürür. Bu hata davranışını, kuruluş düzeyinde yeni bir mülkle değiştirebilirsiniz. org mülkü features.isPolicyHttpStatusEnabled doğru olarak ayarlandığında aşağıdaki davranış meydana gelir:

• İstek: Herhangi bir istek akışına eklenmiş bir tehdit koruma politikası varsa geçersiz mesajlar, ilgili politika hata mesajıyla birlikte 400 durum kodu döndürür.
• Yanıt: Herhangi bir yanıt akışına eklenmiş bir tehdit koruma politikası varsa geçersiz iletiler yine de 500 durum kodu döndürür ve ilgili politika hata mesajlarından biri (ExecutionFailed yerine) gösterilir.

Cloud müşterileri, kuruluş mülkünü ayarlamak için Apigee Destek Ekibi ile iletişime geçmelidir. Bu özellik, Edge Private Cloud müşterilerinin kullanımına Private Cloud'ın gelecekteki bir üç aylık sürümünde sunulacaktır.

Uç noktalar, proxy'ler ve diğer varlıklar için güncellenen şemalar

Referans şemaları, TargetEndpoint, ProxyEndpoint, APIProxy ve daha birçok politika dışı varlık için güncellendi. https://github.com/apigee/api-platform-samples/tree/master/schemas adresine bakın. (APIRT-1249)

Geliştirici Hizmetleri

Bu sürüme eklenen yeni Geliştirici Hizmetleri özelliklerini aşağıda bulabilirsiniz.

SmartDocs'un genel kullanıma sunulması

SmartDocs, beta sürümden genel kullanıma sunuluyor. Güncellemeler ve yeni özellikler arasında şunlar yer alır:

• Dosya veya URL ile içe aktarma dahil olmak üzere Swagger 2.0 desteği, özel olarak adlandırılmış güvenlik nesneleri için destek dahil.
• SmartDocs oluşturan şablonlarda görsel tasarım iyileştirmeleri.
• Geliştirici Portalı'ndaki kullanılabilirlik ve iş akışı iyileştirmeleri. Bu iyileştirmelere Drupal'daki İçerik > SmartDocs menüsünden erişebilirsiniz.
• "Özel jeton" kimlik doğrulaması olarak bilinen yöntem artık "API anahtarı" olarak adlandırılıyor.
• Düzeltme düzeyinde tanımlanan kimlik doğrulama "güvenlik" nesneleri.
• İstemci kimlik doğrulamasının şablon düzeyinde yapılandırılması. Yeni düzeltmeler artık önceden yapılandırılmış SmartDocs istemci kimlik bilgilerini sıfırlamaz.

Diğer özellik açıklamaları için bu blog yayınını inceleyin.

SmartDocs dokümanları için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.

Yönetim kullanıcı arayüzünde gösterilen geliştirici uygulaması adı

Edge'deki geliştirici uygulamalarının hem değişmeyen dahili bir Adı hem de değiştirebileceğiniz bir Görünen Adı vardır. Yönetim kullanıcı arayüzündeki Geliştirici Uygulaması sayfasında ("Yayınla> "Geliştirici Uygulamaları> uygulama adı), uygulamanın dahili "Adı", "Görünen Ad" ile birlikte gösterilir. Bu sayede, sorun giderme ve API yönetimi için uygulamaları dahili adlarına göre görsel olarak tanımlamak daha kolay olur.

Analytics Hizmetleri

Bu sürüme eklenen yeni Analytics Services özellikleri aşağıda verilmiştir.

Korunan verilerin zaman sınırı

Yönetim kullanıcı arayüzü veya API ile analiz raporları oluştururken geçerli tarihten altı aydan eski verilere varsayılan olarak erişilemez. Altı aydan eski verilere erişmek istiyorsanız Apigee Destek Ekibi ile iletişime geçin.

Özel raporların klasik sürümü, yönetim kullanıcı arayüzünden kaldırılıyor

Özel analiz raporlarının isteğe bağlı klasik sürümü artık yönetim kullanıcı arayüzünde kullanılamamaktadır.

Geliştirici Etkileşimi widget'ı performansı

Ana analizler kontrol panelindeki (Geliştirici Etkileşimi bölümü) dönüşüm hunisi widget'ı, daha iyi performans sunmak için geliştirildi.

Para kazanma

Bu sürüme eklenen yeni para kazanma özelliklerini aşağıda bulabilirsiniz.

Ücret planı e-posta bildirimleri

Yeni bir ücret planı e-posta bildirimi türü, geliştiricilerin satın aldıkları hacim bandına göre veya paket ücret planlarında belirli bir işleme veya dolar sınırına ulaştıklarında onları bilgilendirmenize olanak tanır. Ayrıntılar için Bildirim şablonlarını kullanarak bildirimler oluşturma başlıklı makaleyi inceleyin.

Yinelenen Ücret ve Toplama Dönemi'nin senkronizasyonu

Bir ücret planında geçerli olabilecek iki farklı dönem vardır:

• Geliştiricilerden ne zaman yinelenen ücret alınacağını belirleyen, ücret planının Ücretler sekmesinde yapılandırılan yinelenen ücret dönemi.
• Hacim bandı veya paket planları için ücret kartında tanımlanan ve geliştiriciler için paket kullanımının sıfırlandığı zamanı belirleyen toplama temel dönemi.

Bu iki dönem artık senkronize edilmiştir. Bir ücret planında hem sıfır olmayan yinelenen ücret hem de Hacim Bandı veya Paket ücret kartı varsa her ikisi için de yinelenen ücret dönemi kullanılır. Örneğin, aylık yinelenen ücret varsa fiyat kartı paketleri de aylık olarak sıfırlanır (varsayılan olarak ayın başında).

Yinelenen ücret yoksa paketler, fiyat kartında tanımlanan Toplama Tabanı'na göre sıfırlanır. Örneğin, bir geliştirici bir fiyat kartını ayın 19'unda kullanmaya başlarsa ve Toplama Tabanı her ay ise paket kullanımı 19'undan bir ay sonra sıfırlanır.

Toplama Tabanı'nın desteği sonlandırılıyor ve gelecekteki bir sürümde para kazanma özelliğinden kaldırılacak. Daha fazla bilgi için Ücret kartı planı ayrıntılarını belirtme başlıklı makaleyi inceleyin.

Özet gelir raporlarındaki özel özellikler

İşlem kaydı politikaları, isteğe bağlı olarak işlemlerden özel özellik verilerini yakalamanıza olanak tanır. Artık bu özel işlem özelliklerini özet gelir raporlarına dahil edebilirsiniz. Kuruluşunuza MINT.SUMMARY_CUSTOM_ATTRIBUTES mülkü ekleyerek raporlarda kullanılacak veritabanı tablolarına hangi özel özelliklerin ekleneceğini belirtebilirsiniz.

Private Cloud için Apigee Edge müşterileri, aşağıdaki API çağrısı ve Sistem Yöneticisi kimlik bilgileriyle işareti ayarlayabilir.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

API çağrısındaki özel özellik dizisinin URL olarak kodlandığını unutmayın.

SmartDocs yükseltme süreci

SmartDocs'u beta döneminde kullanıyorsanız genel kullanıma sunulan sürümdeki yeni özellikler ve özellikler için geliştirici portalınızda SmartDocs'u yükseltmeniz gerekir.

Geliştirici portalınızda yayınlanmış olan tüm SmartDocs sayfaları çalışmaya devam edecek ancak mevcut veya yeni sayfalarda yapılan değişiklikleri düzenlemeden ya da yayınlamadan önce güncelleme sürecini uygulamanız gerekir.

SmartDocs'u geliştirici portalınızda oluşturabilir ve yayınlayabilirsiniz ancak SmartDocs'un Apigee'nin Edge API Yönetim Hizmetleri'ndeki API modelinden oluşturulduğunu unutmayın. Edge'de bir API modelinde yaptığınız tüm değişiklikler, tüm Pantheon ortamlarınızda aynı olur (geliştiricilerin Pantheon ortamlarında var olma şekline benzer).

SmartDocs beta sürümünden genel kullanıma geçiş yapmak için

1. 15.05.27 sürümünü Pantheon'daki geliştirme veya test ortamlarınızda güncelleyip test edin.
2. Kullandığınız mevcut API modelini değiştirmek için yeni bir model oluşturun.
   • Swagger veya WADL dokümanlarını içe aktarıyorsanız bunları yeni bir düzeltmeye tekrar aktarın.
   • API modelinizi SmartDocs modülü aracılığıyla yönetiyorsanız SmartDocs JSON olarak dışa aktarın ve dosya eki kullanarak yeni modelinize aktarın.
3. Modelinizin düzeltmesinin güvenlik özelliklerini ayarlayın. İçerik > SmartDocs > model sayfasında Güvenlik Ayarları'nı seçin.
   
4. İşlemler sütununda Ayarlar'ı tıklayarak model ayarları sayfasında (İçerik > SmartDocs) önceden yapılandırılmış kimlik doğrulamayı kontrol edin.
   
5. Özel şablonları CSS ve JS öğelerinin 6. sürümünü kullanacak şekilde güncelleyin ve authSchemes ile apiSchema gibi yeni nesne adlarını yansıtacak şekilde değişiklikler yapın. SmartDocs şablonlarını güncelleme hakkında bilgi edinmek için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.
6. Model düzeltmenizi yeniden oluşturun ve yayınlayın.
7. Yeni dokümanları doğruladıktan sonra üretim portalınızı 15.05.27 sürümüne güncelleyin.

Edge Enterprise müşterisiyseniz ve yükseltme süreciyle ilgili sorularınız veya endişeleriniz varsa lütfen marsh@apigee.com ve cnovak@apigee.com adreslerine e-posta gönderin. Aksi takdirde, en iyi yanıtı almak için lütfen Apigee Topluluğu'nu kullanın.

Gelecekteki özellik değişiklikleri ve iyileştirmeleri

Bu bölümde, gelecekte beklenen özellik değişiklikleri ve geliştirmeleri önizlenmektedir:

Yanıt önbelleği politikası davranışında yapılan değişiklik

Gelecekteki bir sürümde (belirlenecek), Yanıt Önbelleği politikasının <ExcludeErrorResponse> öğesinin varsayılan davranışı değişecek.

Mevcut davranış: Yanıt önbelleği politikasındaki <ExcludeErrorResponse> öğesi varsayılan olarak yanlıştır. Bu, varsayılan olarak, tüm olası HTTP durum kodlarına (3xx dahil) sahip yanıtların Yanıt Önbelleği politikası tarafından önbelleğe alındığı anlamına gelir.

Gelecekteki davranış: Yanıt Önbelleği politikasındaki <ExcludeErrorResponse> öğesi varsayılan olarak true (doğru) değerine ayarlanacaktır. Bu, varsayılan olarak yalnızca 200 ila 205 arasındaki HTTP durum kodlarına sahip yanıtların önbelleğe alınacağı anlamına gelir. Bu davranışı geçersiz kılmak ve tüm durum kodları için yanıtları önbelleğe almak istiyorsanız <ExcludeErrorResponse> öğesini açıkça true olarak ayarlamanız gerekir.

Mevcut geçici çözüm: Private Cloud 4.15.07.00 ve önceki sürümlerde, yalnızca 200 ila 205 durum kodlarına sahip yanıtları önbelleğe almak istiyorsanız <ExcludeErrorResponse> öğesini açıkça true olarak ayarlamanız gerekir.

Düzeltilen hatalar

Bu sürümde aşağıdaki hatalar düzeltilmiştir.

Bilinen sorunlar

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

> source /{install-dir}/apigee4/bin/apigee-env.sh 

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4` 

> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh 

> rm /install-dir/apigee4/share/monetization 

************************************** 
In order to complete the monetization upgrade please run: 
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh 
************************************** 

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

<install_dir>/apigge4/bin/apigee-service message-processor restart