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. bilgi

8 Eylül 2015 Salı günü, Apigee Edge for 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ınlanmıştır ve bu üç aylık sürüme dahil edilmiştir:

• 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ümlerine yükseltme yapabilirsiniz? 4.15.07.00

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
• Kademeli olarak yükseltme: Mevcut sürümünüzden başka bir Edge sürümüne yükseltmeniz ve ardından 4.15.07.00 sürümüne yükseltmeniz gerekir.

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

4.15.01.x 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 kullanıyorsanız sonuçlar bir dizi.db dosyası döndürmelidir.
   3. Şu find 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ükseltene 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. Tüm *.db dosyalarının Cassandra 1.2 sürümü için ic biçiminde olduğunu kontrol etmek üzere 1. adımı tekrarlayın.
4. Edge kurulumunuzdaki her Cassandra düğümünde 1-3 arasındaki adımları tekrarlayın.
5. Edge 4.15.07.00'a yükseltin.
6. 4.15.07.00 yükseltmesinden sonra *.db dosyalarını kontrol ederek hepsinin C* 2.0 stili sstable'a yükseltildiğinden emin olun:
   > cd /<install-root>/apigee4/data/cassandra/data
   > find . -name *-jb-*
   Cassandra 2 .0 kullanıyorsanız bu komut bir dizi.db dosyası döndürmelidir.

Yeni özellikler ve geliştirmeler

Bu sürümdeki yeni özellikler ve geliştirmeler aşağıda açıklanmıştır.

Yükleme ve yükseltme

Seçmeli bileşen 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şenleri yükseltiyor veya kaldırıyordu. (OPDK-1377, OPDK-1175)

Yükseltmeyi geri alma

Yükseltme sırasında apigee-upgrade.sh başarısız olursa artık yükseltmeyi geri almak için apigee-rollback.sh komut dosyasını kullanabilirsiniz. Yükseltme sorunlarını 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çenekleri kabul etmez. Artık yalnızca -h gibi tek harfli seçenekleri kabul ederler. (OPDK-1356)

SmartDocs kurulumu

SmartDocs'u setup-smartdocs.sh komut dosyasıyla yüklerken kuruluşu, 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ında sabit kodlanmıştı. (OPDK-1310)

update-cass-pwd-in-config.sh komutu istem olmadan çalıştırılıyor

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ümde yer alan 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 ve JDK 1.6 desteği kaldırılmıştır. (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 kapsayacak şekilde genişletti.

OPDK 15.07'ye dahil edilen Cassandra 2.0.15

Bu sürüm, Cassandra 2.0.15'i yükler. Ö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

Edge, veritabanı güvenliği ihlali durumunda OAuth jetonlarını daha iyi korumak için OAuth jetonlarına karma oluşturma işlemi uygulamak üzere SHA2 algoritmalarını (SHA1'e ek olarak) destekler. Kuruluş düzeyindeki yeni özelliklerle, yeni jetonlar için karma oluşturmayı etkinleştirip yapılandırabilir ve bu yeni özellikten önce mevcut olan tüm jetonlarda eski karma oluşturma yöntemini koruyabilirsiniz. Daha önce Edge for Private Cloud'da, keymanagement.properties dosyasındaki (yönetim sunucunuzda ve mesaj 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ı, yeni kuruluş düzeyindeki özellikleri sizin için otomatik olarak oluşturur. Yükseltme işleminden sonra doğrulamak için sistem yöneticisi olarak şu API ile 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 için Erişim jetonları 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 Edge for Private Cloud Operations Guide (Edge for Private Cloud İşlem Kılavuzu) başlıklı makaleyi inceleyin. (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 olarak 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 Message Logging politikası başlıklı makaleyi inceleyin. (APIRT-1394)

Ortam önbelleği performansı

Bellek içi önbellek yönetimini ve kullanımını iyileştirmek için ortam önbelleği 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şleyicide bellek içi önbelleğe alma için ayrılan toplam bellek, kullanılabilir toplam belleğin %40'ıdır. Bu değer, mesaj işleyicinizin cache.properties dosyasındaki önbellek özelliği ayarlarıyla belirlenir. Öğeler, yalnızca RAM önbelleği belleği yetersiz 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 için cache.properties dosyasında overrideMaxElementsInCacheResource=false özelliğini ayarlayın. (APIRT-1140)

API Hizmetleri

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

Yeni Proxy Düzenleyici varsayılan olarak ayarlandı

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

Yeni OAuth 2.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 Management API tarafından sağlanan işlevlerin yerini alır. Daha fazla bilgi için OAuthV2 Bilgilerini Silme politikası başlıklı makaleyi 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 Management API tarafından sağlanan işlevlerin 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 üstbilgisinde yer aldığında izin verilenler listesi ve engellenenler listesi için IP adreslerinin daha ayrıntılı değerlendirilmesine olanak tanıyacak şekilde geliştirildi.

Üstbilgide birden fazla IP adresi kontrolü etkinleştirildiğinde (feature.enableMultipleXForwardCheckForACL'yi ayarlamak için Destek Ekibi ile iletişime geçin) politikadaki yeni bir <ValidateBasedOn> öğesi, üstbilgideki ilk IP'yi, son IP'yi veya tüm IP'leri kontrol etmenize olanak tanır. Daha fazla bilgi için Erişim Denetimi Politikası'na bakın.

Erişim varlığı politikasındaki yeni varlıklar

Access Entity politikası, şu yeni varlıklara erişim sağlar: consumerkey-scopes, authorizationcode, requesttoken ve verifier. Daha fazla bilgi için Access Entity politikası'na bakın.

Statistics Collector 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 harfle yazılmalıdır. Adı büyük harflerle girerseniz araç, Statistics Collector politikasında istatistik adını otomatik olarak küçük harfe dönüştürür. (MGMT-740)

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

API proxy düzenleyicisindeki İzleme işlevinin en yeni sürümü, beta sürümünden genel kullanıma sunulma tarihine geçti. "İ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ü Yardım menüsünden Apigee Topluluğu'na erişim

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 mesajı iyileştirmeleri şunlardır:

• Yönetim kullanıcı arayüzü, siz kapatmadığınız sürece tüm giriş oturumu boyunca kullanıcı arayüzündeki tüm hata mesajlarını gruplandırıp gösterirdi. Bu güncellemeyle birlikte, hata mesajları oluştukları sayfadan ayrıldığınızda otomatik olarak temizlenir. (MGMT-2254)
• Yönetim kullanıcı arayüzü artık yinelenen hata mesajlarını gizlemez. (MGMT-2242)

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

Yönetim kullanıcı arayüzünün farklı alanlarında, sayfa görüntüleme performansı ve hata mesajı temizleme dahil olmak üzere 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 gösteriliyor. 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şlemciden hedef uç noktalara) Sunucu Adı Göstergesi'nin kullanılması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 birden fazla HTTPS hedefi, aynı sertifikayı kullanmak zorunda kalmadan aynı IP adresi ve bağlantı noktasından sunulabilir.

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

Edge, istek URL'sinden ana makine adını otomatik olarak çıkarır 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ı"

SSL sertifikası ayrıntılarına yeni bir "İmza Algoritması" alanı eklendi. Bu alan, yönetim kullanıcı arayüzünde (Yönetici > SSL Sertifikaları) ve Management API'de (Anahtar Deposu veya Güven Deposu'ndan Sertifika Ayrıntılarını Alma) görüntülenebilir. Bu alanda, sertifikayı oluşturmak için kullanılan karma algoritmasının türüne bağlı olarak "sha1WithRSAEncryption" veya "sha256WithRSAEncryption" gösterilir.

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

Yönetim kullanıcı arayüzündeki SSL Sertifikaları sayfasında (Yönetici > SSL Sertifikaları), yeni geçerlilik bitiş tarihi açılır alanındaki seçiminize bağlı olarak SSL sertifikalarının 10, 15, 30 veya 90 gün içinde geçerliliğini yitireceği belirtilir.

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

Varsayılan olarak Edge, bir mesaj JSON veya XML Tehdit Koruması politikasını geçemezse HTTP 500 Dahili Sunucu Hatası durum kodu ve ExecutionFailed hatası verir. Bu hata davranışını, kuruluş düzeyinde yeni bir özellik kullanarak değiştirebilirsiniz. features.isPolicyHttpStatusEnabled kuruluş özelliği "true" olarak ayarlandığında aşağıdaki davranış gerçekleşir:

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

Cloud müşterileri, kuruluş mülkünü 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üşterilerinin kullanımına sunulacaktır.

Uç noktalar, proxy'ler ve diğer öğeler için güncellenen şemalar

Referans şemaları; TargetEndpoint, ProxyEndpoint, APIProxy ve diğer birçok politika dışı öğe için 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 Geliştirici Hizmetleri'nin yeni özellikleri aşağıda verilmiştir.

SmartDocs'un genel kullanıma sunulması

SmartDocs, beta sürümünden genel kullanıma sunulma tarihine geçiyor. Güncellemeler ve yeni özellikler şunlardı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.
• Drupal'da İç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.
• Düzeltme düzeyinde tanımlanan kimlik doğrulama "güvenlik" nesneleri.
• Şablon düzeyinde istemci kimlik doğrulamasının yapılandırılması. Yeni düzeltmeler artık önceden yapılandırılmış SmartDocs istemci kimlik bilgilerini sıfırlamaz.

Daha fazla özellik açıklaması için bu blog yayınına göz atın.

SmartDocs belgeleri 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 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ı" ve "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 daha kolay hale gelir.

Analiz Hizmetleri

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

Korunan veri süresi sınırı

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

Ana analiz kontrol panelindeki (Geliştirici Etkileşimi bölümü) dönüşüm hunisi widget'ı daha iyi performans sağlayacak şekilde geliştirildi.

Para kazanma

Bu sürümde yer alan yeni para kazanma özellikleri aşağıda açıklanmıştır.

Ücret planı e-posta bildirimleri

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

Yinelenen Ücret ve Toplama Temeli dönemlerinin senkronizasyonu

Bir ücret planında, geçerli olan iki farklı dönem olabilir:

• Ücret planının Ücretler sekmesinde yapılandırılan ve geliştiricilerden ne zaman yinelenen ücret alınacağını belirleyen yinelenen ücret dönemi.
• Hacim Bantlı veya Paket planları için ücret listesinde tanımlanan ve geliştiriciler için paket kullanımının ne zaman sıfırlandığını belirleyen Toplama Temeli 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 Bantlı veya Paket ücret tablosu varsa her ikisi için de yinelenen ücret dönemi kullanılır. Örneğin, aylık yinelenen bir ücret varsa ücret listesi paketleri de aylık olarak (varsayılan olarak ayın başında) sıfırlanır.

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

Toplama Temeli'nin 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 listesi planı ayrıntılarını belirtme bölümüne bakın.

Ö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 özelliği ekleyerek raporlarda kullanılmak üzere veritabanı tablolarına hangi özel özelliklerin ekleneceğ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

SmartDocs'u beta döneminde kullandıysanız genel kullanıma sunulma tarihi sürümündeki yeni özellikler ve işlevler 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 eder ancak mevcut veya yeni sayfalarda değişiklik yapmadan ya da yayınlamadan önce güncelleme sürecini uygulamanız gerekir.

SmartDocs'u geliştirici portalınızda oluşturup yayınlayabilseniz de 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 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 sunulan sürüme yükseltmek için

1. Pantheon'daki geliştirme veya test ortamlarınızda 15.05.27 sürümünü 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ü üzerinden 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. Content > SmartDocs > model sayfasında Security Settings'i seçin.
   
4. İşlemler sütununda Ayarlar'ı tıklayarak model ayarları sayfasında (İçerik > SmartDocs) önceden yapılandırılmış kimlik doğrulamalarını kontrol edin.
   
5. Özel şablonları CSS ve JS öğelerinin 6. sürümünü kullanacak şekilde güncelleyin ve authSchemes ve apiSchema gibi yeni nesne adlarını yansıtacak değişiklikler yapın. SmartDocs şablonlarını güncelleme hakkında bilgi için API'leri belgelemek için SmartDocs'u kullanma başlıklı makaleyi inceleyin.
6. Model revizyonunuzu yeniden oluşturup 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 kurumsal 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. Diğer durumlarda, en iyi yanıtı almak için lütfen Apigee Topluluğu'nu kullanın.

Gelecekteki özellik değişiklikleri ve geliştirmeler

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

Response Cache politikasının davranışında değişiklik

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

Mevcut davranış: Yanıt önbelleği politikasındaki <ExcludeErrorResponse> öğesi varsayılan olarak false değerine sahiptir. Bu, varsayılan olarak, olası herhangi bir HTTP durum koduna (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 değerini alır. Bu, varsayılan olarak yalnızca HTTP durum kodları 200 ile 205 arasında olan 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.

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

Hatalar düzeltildi

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