Edge Private Cloud 4.19.01 sürümü
Yükleme işleminden sonra Edge'i yapılandırmak için .properties
dosyaları ile Edge yardımcı programlarının bir kombinasyonunu kullanırsınız. Örneğin, Edge kullanıcı arayüzünde TLS/SSL'yi yapılandırmak için .properties
dosyalarını düzenleyerek gerekli özellikleri ayarlarsınız. .properties
dosyalarında yapılan değişiklikler, etkilenen Edge bileşenini yeniden başlatmanızı gerektirir.
Apigee, .properties
dosyalarını yapılandırmalı kod (bazen CwC olarak kısaltılır) olarak düzenleme tekniğini ifade eder. Temel olarak yapılandırmaya sahip kod, .properties
dosyalarındaki ayarlara dayalı bir anahtar/değer arama aracıdır. Yapılandırmalı kodlarda anahtarlar jeton olarak adlandırılır. Bu nedenle, Edge'i yapılandırmak için .properties
dosyalarında jeton ayarlarsınız.
Yapılandırmalı kod, Edge bileşenlerinin ürünle birlikte gönderilen varsayılan değerleri ayarlamasına, yükleme ekibinin yükleme topolojisine göre bu ayarları geçersiz kılmasına ve ardından müşterilerin istedikleri özellikleri geçersiz kılmasına izin verir.
Bunu bir hiyerarşi olarak düşünürseniz, ayarlar aşağıdaki şekilde düzenlenir ve müşteri ayarları, yükleyici ekibinden veya Apigee'den alınan ayarları geçersiz kılmak için en yüksek önceliğe sahiptir:
- Müşteri
- Yükleyici
- Bileşen
Jetonun mevcut değerini belirleme
.properties
dosyasındaki bir jeton için yeni bir değer ayarlamadan önce, aşağıdaki komutu kullanarak ilk olarak mevcut değerini belirlemeniz gerekir:
/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token
Burada component_name, bileşenin adı ve token ise incelenecek jetondur.
Bu komut, jetonun geçerli değerini belirlemek için bileşenin .properties
dosyalarının hiyerarşisinde arama yapar.
Aşağıdaki örnekte Yönlendirici için conf_http_HTTPRequest.line.limit
jetonunun mevcut değeri kontrol edilmektedir:
/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Çıkış şu şekilde görünür:
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
Jetonun değeri #
ile başlıyorsa yoruma dahil edilmiştir. Değiştirmek için özel söz dizimi kullanmanız gerekir. Daha fazla bilgi için Şu anda yorum yapılan bir jeton ayarlama başlıklı makaleye bakın.
Jetonun tam adını bilmiyorsanız mülk adına veya anahtar kelimeye göre arama yapmak için grep
gibi bir araç kullanın. Daha fazla bilgi için Jeton bulma bölümünü inceleyin.
Özellik dosyaları
Düzenlenebilir ve düzenlenemeyen bileşen yapılandırma dosyaları vardır. Bu bölümde bu dosyalar açıklanmaktadır.
Düzenlenebilir bileşen yapılandırma dosyaları
Aşağıdaki tabloda, Apigee bileşenleri ve bu bileşenleri yapılandırmak için düzenleyebileceğiniz özellik dosyaları listelenmektedir:
Bileşen | Bileşen Adı | Düzenlenebilir Yapılandırma Dosyası |
---|---|---|
Cassandra | apigee-cassandra |
/opt/apigee/customer/application/cassandra.properties |
Edge kullanıcı arayüzü | edge-ui |
/opt/apigee/customer/application/ui.properties |
Edge TOA | apigee-sso |
/opt/apigee/customer/application/sso.properties |
Yönetim Sunucusu | edge-management-server |
/opt/apigee/customer/application/management-server.properties |
Mesaj İşleyici | edge-message-processor |
/opt/apigee/customer/application/message-processor.properties |
apigee-monit |
apigee-monit |
/opt/apigee/customer/application/monit.properties |
Yeni UE | apigee-management-ui |
Yok (yükleme yapılandırma dosyasını kullanın) |
OpenLDAP | apigee-openldap |
/opt/apigee/customer/application/openldap.properties |
Postgres Sunucusu | edge-postgres-server |
/opt/apigee/customer/application/postgres-server.properties |
PostgreSQL Veritabanı | apigee-postgresql |
/opt/apigee/customer/application/postgressql.properties |
Qpid Sunucusu | edge-qpid-server |
/opt/apigee/customer/application/qpid-server.properties |
Qpidd | apigee-qpidd |
/opt/apigee/customer/application/qpidd.properties |
Yönlendirici | edge-router |
/opt/apigee/customer/application/router.properties |
Zookeeper | apigee-zookeeper |
/opt/apigee/customer/application/zookeeper.properties |
Bu bileşen yapılandırma dosyalarından birinde mülk ayarlamak istiyorsanız ancak mülkün mevcut olmaması durumunda özelliği, yukarıda listelenen konumda oluşturabilirsiniz.
Ayrıca, özellikler dosyasının "Apigee" kullanıcısına ait olduğundan emin olmanız gerekir:
chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties
Düzenlenemeyen bileşen yapılandırma dosyaları
Düzenlenebilir bileşen yapılandırma dosyalarının yanı sıra düzenleyemediğiniz yapılandırma dosyaları da vardır.
Bilgilendirici (düzenlenemez) dosyalar aşağıdakileri içerir:
Sahip | Dosya adı veya dizini |
---|---|
Döşeme | /opt/apigee/token |
Bileşen | /opt/apigee/component_name/conf Burada component_name, bileşeni tanımlar. Olası değerler şunları içerir:
|
Jeton değeri belirleyin
.properties
dosyalarını yalnızca /opt/apigee/customer/application
dizininde değiştirebilirsiniz. Her bileşenin, söz konusu dizinde kendi .properties
dosyası vardır. Örneğin, router.properties
ve management-server.properties
. Özellik dosyalarının tam listesi için .property dosyalarının konumu sayfasına göz atın.
.properties
dosyası oluşturmak için:
- Düzenleyicide yeni bir metin dosyası oluşturun. Dosya adı, müşteri dosyaları için yukarıdaki tabloda gösterilen listeyle eşleşmelidir.
- Aşağıdaki örnekte gösterildiği gibi dosyanın sahibini "Apigee:Apigee" olarak değiştirin:
chown apigee:apigee /opt/apigee/customer/application/router.properties
Edge hizmetini çalıştıran kullanıcıyı "Apigee" kullanıcısından değiştirdiyseniz sahipliği " Edge" hizmetini çalıştıran kullanıcıya değiştirmek için
chown
kullanın.
Edge'i yükselttiğinizde /opt/apigee/customer/application
dizinindeki .properties
dosyaları okunur. Yani yükseltme, bileşende ayarladığınız tüm özellikleri korur.
Bir jetonun değerini ayarlamak için:
- Bileşenin
.properties
dosyasını düzenleyin. - Jetonun değerini ekleyin veya değiştirin. Aşağıdaki örnekte
conf_http_HTTPRequest.line.limit
özelliğinin değeri "10k" olarak ayarlanmıştır:conf_http_HTTPRequest.line.limit=10k
Jeton birden fazla değer alıyorsa her bir değeri aşağıdaki örnekte gösterildiği gibi virgülle ayırın:
conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*
Buna benzer bir listeye yeni bir değer eklemek için genellikle yeni değeri listenin sonuna ekleyin.
- Bileşeni yeniden başlatın:
/opt/apigee/apigee-service/bin/apigee-service component_name restart
component_name şunlardan biridir:
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(PostgreSQL veritabanı)apigee-qpidd
(Qpidd)apigee-sso
(Edge TOA)apigee-zookeeper
(ZooKeeper)edge-management-server
(Yönetim Sunucusu)edge-management-ui
(yeni Edge kullanıcı arayüzü)edge-message-processor
(Mesaj İşleyici)edge-postgres-server
(Postgres Sunucusu)edge-qpid-server
(Qpid Sunucusu)edge-router
(Edge Yönlendirici)edge-ui
(Klasik kullanıcı arayüzü)
Örneğin,
router.properties
düzenlendikten sonra Yönlendirici'yi yeniden başlatın:/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- (İsteğe bağlı)
configure -search
seçeneğini kullanarak jeton değerinin yeni değerinize ayarlandığından emin olun. Örneğin:/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
configure -search
hakkında daha fazla bilgi için Bir jetonun mevcut değerini belirleme bölümüne bakın.
Jeton bulma
Çoğu durumda, ayarlamanız gereken jetonlar bu kılavuzda tanımlanır. Bununla birlikte, tam adı veya konumundan emin olmadığınız mevcut bir jetonun değerini geçersiz kılmanız gerekiyorsa bileşenin source
dizininde arama yapmak için grep
öğesini kullanın.
Örneğin, Edge'in önceki bir sürümünde session.maxAge
özelliğini ayarladığınızı biliyor ve bunu ayarlamak için kullanılan jeton değerini öğrenmek istiyorsanız /opt/apigee/edge-ui/source
dizinindeki mülk için grep
:
grep -ri "session.maxAge" /opt/apigee/edge-ui/source
Bir sonucu aşağıdaki biçimde görürsünüz:
/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}
Aşağıdaki örnekte kullanıcı arayüzünün session.maxAge
jetonunun değeri gösterilmektedir:
/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}
{T}{/T} etiketleri arasındaki dize, kullanıcı arayüzünün .properties
dosyasında ayarlayabileceğiniz jetonun adıdır.
Halihazırda yorum yapılan bir jeton ayarla
Bazı jetonlar, Edge yapılandırma dosyalarında belirtilir. Bir yükleme veya bileşen yapılandırma dosyasında yorum yapılan bir jeton ayarlamaya çalışırsanız ayarınız yoksayılır.
Bir Edge yapılandırma dosyasında yorum yapılan bir jetonun değerini belirlemek için aşağıdaki biçimde özel söz dizimi kullanın:
conf/filename+propertyName=propertyValue
Örneğin, Mesaj İşleyici'de HTTPClient.proxy.host
adlı özelliği ayarlamak için ilk olarak grep
jetonunun değeri belirleyin:
grep -ri /opt/apigee/edge-message-processor/ -e "HTTPClient.proxy.host"
grep
komutu, jeton adını içeren sonuçları döndürür. # önekiyle belirtilen özellik adının nasıl yorumlandığına dikkat edin:
source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T} token/default.properties:conf_http_HTTPClient.proxy.host= conf/http.properties:#HTTPClient.proxy.host=
Bu özelliğin değerini ayarlamak için /opt/apigee/customer/application/message-processor.properties
öğesini düzenleyin ancak aşağıdaki örnekte gösterildiği gibi özel bir söz dizimi kullanın:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Bu durumda, tesis adının önüne conf/http.properties+
eklemeniz gerekir. Bu, mülkü içeren yapılandırma dosyasının konumunu ve adını ve ardından "+" ifadesini içerir.
Mesaj İşleyici'yi yeniden başlattıktan sonra /opt/apigee/edge-message-processor/conf/http.properties
dosyasını inceleyin:
cat /opt/apigee/edge-message-processor/conf/http.properties
Dosyanın sonunda mülkün aşağıdaki biçimde ayarlandığını görürsünüz:
conf/http.properties:HTTPClient.proxy.host=myhost.name.com