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ü, Apigee Edge Private Cloud'un önemli bir özellik sürümünü yayınladık.

Önceki Edge for Private Cloud üç aylık 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:

• Cloud: 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ümlerini 4.15.07.00'a yükseltebilirsiniz?

Mevcut Edge sürümünüze bağlı olarak şunlardan birini yapabilirsiniz:

• Doğrudan 4.15.07.00 sürümüne yükseltme
• Aşamalı olarak yükseltme yapmanız gerekir. 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 yükseltme yapmanız gerekir.

Daha fazla bilgi için Hangi Edge for Private Cloud sürümlerini 4.15.07.00 sürümüne 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 bulma komutu çalıştırın,
      > find . -name *-ic-*
      Cassandra 1 .2 SSTable'ı çalıştırıyorsanız sonuçlar bir dizi.db dosyası döndürmelidir.
   3. Bu bulma komutunu çalıştırın:
      > find . -name *-hf-*
      Sonuçlar boş olmalıdır. Yani hf biçiminde .db dosyası olmamalıdır. hf biçiminde dosya görmüyorsanız işlem tamamlanmıştır ve 4.15.07.00 sürümüne yükseltebilirsiniz.
      
      hf biçimi, Cassandra 1.0 SSTable'ları içindir. hf biçiminde *.db dosyalarınız varsa bu prosedürün geri kalanında açıklandığı gibi SSTable'ı yükseltmeniz gerekir.
2. hf biçiminde *.db dosyaları bulursanız tüm Cassandra düğümlerini yükseltilene kadar her Cassandra düğümünde aşağıdaki komutu çalıştırarak SSTable'ı yükseltin:
   > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
3. Cassandra 1.2 sürümü için tüm *.db dosyalarının ic biçiminde olduğunu kontrol etmek üzere 1. adımı tekrarlayın.
4. Edge yüklemenizdeki her Cassandra düğümünde 1-3 arasındaki adımları tekrarlayın.
5. Edge 4.15.07.00 sürümüne yükseltin.
6. 4.15.07.00 sürümüne yükselttikten sonra, *.db dosyalarının C* 2.0 tarzı sstable'a yükseltildiğinden emin olmak için dosyaları kontrol edin:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   Bu komut, Cassandra 2 .0'ı çalıştırıyorsanız bir dizi.db dosyası döndürmelidir.

Yeni özellikler ve geliştirmeler

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

Yükleme ve yükseltme

Bileşenleri seçerek 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ıyor. Daha önce, düğümdeki tüm bileşenler yükseltiliyor veya kaldırılıyordu. (OPDK-1377, OPDK-1175)

Yükseltmeyi geri alma

apigee-upgrade.sh, yükseltme 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ükseltmeyi tekrar deneyebilirsiniz. (OPDK-1275)

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

Yükleme komut dosyaları artık --help gibi uzun biçimli seçenekleri kullanmıyor. Artık yalnızca -h gibi tek harfli seçenekler kabul ediyorlar. (OPDK-1356)

SmartDocs'u yükleme

SmartDocs'u setup-smartdocs.sh komut dosyasıyla yüklerken kuruluş, ortam ve sanal ana makineyi girmeniz istenir. Bu sayede SmartDocs'un beklenen konuma yüklenmesi sağlanır. Daha önce bu değerler komut dosyasına sabit kodlanı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ıştırılabilir. (OPDK-1309)

Edge Platformu

Bu sürüme dahil edilen 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 desteklerken JDK 1.6 desteği kaldırıldı. (OPDK-1187)

İşletim sistemi desteği

Apigee Edge for Private Cloud, 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 yüklenir. Önceki bir sürümden yükseltme yapıyorsanız Cassandra sürümünüz güncellenir. (OPDK-1197)

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

Veritabanı güvenlik ihlali durumunda OAuth jetonlarını daha iyi korumak için Edge, OAuth jetonlarının karma oluşturma işleminde SHA2 algoritmalarını (SHA1'e ek olarak) destekler. Yeni kuruluş düzeyi özelliklerle, yeni jetonlar için karma oluşturmayı etkinleştirebilir ve yapılandırabilir, ayrıca bu yeni özellikten önce mevcut olan jetonlarda eski karma oluşturmayı koruyabilirsiniz. Daha önce Edge for Private Cloud'da, keymanagement.properties dosyasındaki (yönetim sunucunuzda ve ileti işlemcilerinizde) 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 özelliğini kullandıysanız bu sürümün yükseltme komut dosyası, kuruluş düzeyindeki yeni özellikleri sizin için otomatik olarak oluşturur. Yükseltme işleminden sonra doğrulamak için bu 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şturmayı etkinleştirme hakkında bilgi edinmek için Erişim jetonları isteme konusundaki "Veritabanında jeton karma oluşturma" bölümüne bakın.
• Mevcut jetonların toplu olarak karma oluşturulması hakkında bilgi edinmek için Edge for Private Cloud Operations Guide'ı inceleyin. (APIRT-1389)

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

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

Ortam önbelleği performansı

Bellek içi önbellek yönetimi ve kullanımını iyileştirmek için ortam önbellek kaynaklarındaki "Bellekteki Maksimum Öğe Sayısı" ayarları kullanımdan kaldı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şlemcisinde bellek içi önbelleğe alma için ayrılan toplam bellek, mesaj işlemcisi cache.properties dosyanızdaki önbellek özelliği ayarlarına göre belirlenen kullanılabilir toplam belleğin% 40'ıdır. Öğeler, yalnızca yetersiz önbellek belleği olduğunda veya öğelerin süresi dolduğunda bellek içi önbellekten çıkarılır.

Önbellek yönetimi için "Bellekteki Maksimum Öğe Sayısı" özelliğini kullanma şeklindeki eski davranışa geri dönmek istiyorsanız özelliği overrideMaxElementsInCacheResource=false olarak ayarlayın. (APIRT-1140)

API Hizmetleri

Bu sürümde yer alan 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, kullanılabilirlik açısından birçok iyileştirme içerir. Örneğin; Genel Bakış sayfasında koşullu akışların ve uç noktaların daha kapsamlı görünümleri, Geliştirme sayfasında tüm yapılandırma, koşullu akışların, uç noktaların ve politikaların daha sezgisel olarak eklenmesi, küçük snippet'ler yerine daha eksiksiz XML görünümleri, dosya adlarını ve metni tarayan arama özelliği gibi. (MGMT-2279)

Yeni OAuth v2.0 Bilgilerini Silme Politikası

Yeni "OAuth v2.0 Bilgilerini Sil" politikası, OAuth v2 erişim jetonlarını ve yetkilendirme kodlarını silmenize olanak tanır. Bu 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 Sil" politikası, OAuth v1.0 istek jetonlarını, erişim jetonlarını ve doğrulayıcı kodlarını silmenize olanak tanır. Bu 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ı'nı inceleyin. (APIRT-1351)

Erişim denetimi politikası

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

Başlıkta birden fazla IP adresi kontrolü etkinleştirildiğinde (feature.enableMultipleXForwardCheckForACL özelliğini ayarlamak için destek ekibiyle iletişime geçin) politikadaki yeni bir <ValidateBasedOn> öğesi, başlıkta ilk IP, son IP veya tüm IP'ler için kontrol yapmanıza olanak tanır. Daha fazla bilgi için Erişim denetimi politikası başlıklı makaleyi inceleyin.

Erişim Varlığı 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 öğesi politikası başlıklı makaleyi inceleyin.

İ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 Analytics koleksiyonu oluştururken toplayıcı değişkeni (istatistik) "Ad" küçük harfli olmalıdır. Adı büyük harflerle girerseniz araç, İstatistik Toplayıcı politikasında İstatistik adı'nı otomatik olarak küçük harflere dönüştürür. (MGMT-740)

API proxy düzenleyicisinde klasik izlemenin kaldırılması

API proxy düzenleyicisindeki izleme işlevinin en yeni sürümü beta sürümünden genel kullanıma taşındı. "İzlemenin klasik sürümüne erişin" bağlantısıyla "klasik izleme"ye erişim artık kullanılamıyor.

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

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

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

Yönetim kullanıcı arayüzündeki hata mesajlarıyla ilgili geliştirmeler aşağıda verilmiştir:

• Tüm hata mesajlarını, siz kapatmadığınız sürece tüm oturum boyunca kullanıcı arayüzünde gruplandırmak ve göstermek için kullanılan yönetim kullanıcı arayüzü. Bu güncellemeyle birlikte, hata mesajları oluştuğu sayfadan ayrıldığınızda otomatik olarak temizlenir. (MGMT-2254)
• Yönetim kullanıcı arayüzü artık yinelenen hata mesajlarını bastırmıyor. (MGMT-2242)

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

Yönetim kullanıcı arayüzünün farklı alanlarında (ör. sayfa görüntüleme performansı ve hata mesajı temizleme) genel iyileştirmeler yapıldı.

Yönetim kullanıcı arayüzündeki Kuruluş Kullanıcıları sayfasında 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ü olarak verilmektedir. Bu sayede, rol sayfalarına hızlıca gidebilirsiniz. (MGMT-1055)

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

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

• TargetEndpoint: request.url, target.basepath.with.query yerine geçer.
• TargetServer: loadbalancing.targetserver, targetserver.name ile değiştirildi. 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önünde (mesaj işlemcisinden hedef uç noktalara) Sunucu Adı Göstergesi kullanımını destekler. SNI kullanmak istiyorsanız Apigee Edge 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 adresi ve bağlantı noktasından birden fazla HTTPS hedefi sunulabilir.

Edge'e özel yapılandırma gerekmez. Ortamınız güneye doğru SNI için yapılandırılmışsa (varsayılan olarak Edge Cloud), Edge bunu destekler.

Edge, istek URL'sinden ana makine adını otomatik olarak ayıklar ve SSL anlaşması isteğine ekler. Örneğin, hedef ana makine https://example.com/request/path ise Edge, server_name uzantısını aşağıda gösterildiği gibi ekler:

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

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

Yönetim kullanıcı arayüzünde (Yönetici > SSL Sertifikaları) ve yönetim API'sinde (Anahtar Deposu veya Güven Deposu'ndan Sertifika Ayrıntılarını Alma) görüntülenebilen SSL sertifikası ayrıntılarına yeni bir "İmza Algoritması" alanı eklendi. 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ı (Yönetici > SSL Sertifikaları), yeni son kullanma tarihi açılır alanında yaptığınız seçime bağlı olarak SSL sertifikalarının 10, 15, 30 veya 90 gün içinde sona ereceğini belirtir.

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

Varsayılan olarak, bir ileti JSON veya XML tehdit koruma politikasını geçemezse Edge, HTTP 500 Internal Server Error durum kodunu ve ExecutionFailed hatasını oluşturur. Bu hata davranışını kuruluş düzeyinde yeni bir mülkle değiştirebilirsiniz. org özelliği features.isPolicyHttpStatusEnabled doğru olarak ayarlandığında aşağıdaki davranış gerçekleşir:

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

Cloud müşterileri, kuruluş özelliğini ayarlamak için Apigee Edge Destek Ekibi ile iletişime geçmelidir. Bu özellik, bir sonraki Private Cloud üç aylık sürümünde Edge Private Cloud müşterileri tarafından kullanılabilecektir.

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

TargetEndpoint, ProxyEndpoint, APIProxy gibi politika dışı varlıklar için referans şemaları güncellendi. https://github.com/apigee/api-platform-samples/tree/master/schemas adresini ziyaret edin. (APIRT-1249)

Geliştirici Hizmetleri

Bu sürümde yer alan yeni Geliştirici Hizmetleri özellikleri aşağıda verilmiştir.

SmartDocs'un genel kullanıma sunulması

SmartDocs, beta sürümünden genel kullanıma geçiş yapıyor. Güncellemeler ve yeni özellikler şunlardır:

• Dosya veya URL ile içe aktarma dahil olmak üzere Swagger 2.0 desteği. Özel adlandırılmış güvenlik nesneleri de desteklenir.
• SmartDocs oluşturan şablonlarda görsel tasarım iyileştirmeleri yapıldı.
• Drupal'daki İçerik > SmartDocs menüsünden erişilebilen Geliştirici Portalı'nda kullanılabilirlik ve iş akışı iyileştirmeleri.
• "Özel jeton" kimlik doğrulaması olarak bilinen yöntem artık "API anahtarı" olarak adlandırılıyor.
• Revizyon 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, önceden yapılandırılmış SmartDocs istemci kimlik bilgilerini artık sıfırlamıyor.

Diğer özellik açıklamaları için bu blog yayınına göz atın.

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

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

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

Analytics Hizmetleri

Bu sürümde yer alan yeni Analytics Hizmetleri özellikleri aşağıda verilmiştir.

Saklanan verilerin zaman sınırı

Yönetim kullanıcı arayüzü veya API ile analiz raporları oluştururken, geçerli tarihten altı aydan daha eski verilere varsayılan olarak erişilemez. Altı aydan eski verilere erişmek istiyorsanız Apigee Edge 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ılamıyor.

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 sağlamak için geliştirildi.

Para kazanma

Bu sürümde yer alan yeni para kazanma özellikleri aşağıda verilmiştir.

Ücret planı e-posta bildirimleri

Yeni bir Ücret Planı e-posta bildirimi türü, satın aldıkları hacim bantlı veya paket ücret planlarında belirli bir işlem ya da dolar sınırına ulaştıklarında geliştiricileri bilgilendirmenize olanak tanır. Ayrıntılar için Bildirim şablonlarını kullanarak bildirimleri ayarlama başlıklı makaleyi inceleyin.

Yinelenen Ücret ve Toplama Temeli dönemlerinin senkronizasyonu

Bir fiyat planında, potansiyel olarak iki farklı zaman aralığı geçerliydi:

• Bir ücret planının Ücretler sekmesinde yapılandırılan ve geliştiricilerden yinelenen ücretin ne zaman alınacağını belirleyen yinelenen ücret dönemi.
• Toplama Temeli dönemi, Hacim Bantlı veya Paket planları için fiyat listesinde tanımlanır. Bu dönem, geliştiriciler için paket kullanımının ne zaman sıfırlandığını belirler.

Bu iki dönem artık senkronize ediliyor. Bir ücret planında hem sıfır olmayan yinelenen ücret hem de hacim bazlı veya paket ücret tarifesi varsa her ikisi için de yinelenen ücret dönemi kullanılır. Örneğin, aylık yinelenen bir ücret varsa fiyat listesi paketleri de aylık olarak sıfırlanır (varsayılan olarak ayın başında).

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

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

Özet gelir raporlarındaki özel özellikler

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

Apigee Edge for Private Cloud 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 özellikler dizisinin URL olarak kodlandığını unutmayın.

SmartDocs yükseltme süreci

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

Geliştirici portalınızda daha önce yayınlanmış olan tüm SmartDocs sayfaları çalışmaya devam eder. Ancak mevcut veya yeni sayfalarda değişiklik yapmadan ya da bu değişiklikleri yayınlamadan önce güncelleme sürecini uygulamanız gerekir.

SmartDocs'u geliştirici portalınızda oluşturup yayınlayabileceğinizi ancak SmartDocs'un Apigee'nin Edge API Yönetim Hizmetleri'nde bulunan 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 bulunmasına benzer şekilde).

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

1. Pantheon'da 15.05.27 sürümünü geliştirme veya test ortamlarınızda güncelleyin ve test edin.
2. Kullandığınız mevcut API modellerinin yerine 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ü üzerinden yönetiyorsanız SmartDocs JSON olarak dışa aktarın ve dosya eki kullanarak yeni modelinize aktarın.
3. Modelinizin revizyonunun 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ındaki (İçerik > Smart Docs) önceden yapılandırılmış kimlik doğrulama işlemlerini kontrol edin.
   
5. CSS ve JS öğelerinin 6. sürümünü kullanmak için tüm özel şablonları 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 revizyonunuzu 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 geliştirmeleri

Bu bölümde, gelecekteki özellik değişiklikleri ve geliştirmeleriyle ilgili önizleme bilgileri yer almaktadır:

Yanıt önbelleği politikası davranışında 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, olası tüm 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 doğru (true) değerini alacak. Bu, varsayılan olarak yalnızca HTTP durum kodları 200-205 arasındaki 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 doğru olarak ayarlamanız gerekir.

Mevcut geçici çözüm: Private Cloud 4.15.07.00 ve daha eski sürümlerde, yanıtları yalnızca 200-205 durum kodlarıyla önbelleğe almak istiyorsanız <ExcludeErrorResponse> öğesini açıkça doğru 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