Edge for Private Cloud sürüm 4.17.05
Yükleme işleminden sonra Edge'i yapılandırmak için .properties dosyalarını ve Edge yardımcı programlarını birlikte 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ı düzenleme tekniğini yapılandırmalı kod olarak adlandırır. Temel olarak, yapılandırmalı kod, .properties dosyalarındaki ayarlara dayalı bir anahtar/değer arama aracıdır. Yapılandırma içeren kodda anahtarlar jeton olarak adlandırılır. Bu nedenle, Edge'i yapılandırmak için .properties dosyalarında jetonlar ayarlarsınız.
Yapılandırmalı kod, Edge bileşenlerinin ürünle birlikte gönderilen varsayılan değerleri ayarlamasına, kurulum ekibinin bu ayarları kurulum topolojisine göre geçersiz kılmasına ve ardından müşterilerin seçtikleri özellikleri geçersiz kılmasına olanak tanır.
Bunu bir hiyerarşi olarak düşünürseniz ayarlar aşağıdaki gibi düzenlenir. Müşteri ayarları, yükleyici ekibinden veya Apigee'den gelen tüm ayarları geçersiz kılmak için en yüksek önceliğe sahiptir:
- Müşteri
- Yükleyici
- Apigee
.properties dosyalarını kullanma
Müşteri olarak yalnızca /opt/apigee/customer/application dizinindeki .properties dosyalarını değiştirebilirsiniz. Her bileşenin bu dizinde kendi .properties dosyası vardır. Örneğin, router.properties ve management-server.properties.
- Dosyayı herhangi bir kullanıcı olarak bir düzenleyicide oluşturun.
- Dosyanın sahibini apigee:apigee olarak değiştirin veya Edge hizmetini çalıştıran kullanıcıyı apigee kullanıcısından değiştirdiyseniz dosyanın sahibini Edge hizmetini çalıştıran kullanıcı olarak değiştirin.
Bir bileşenin özelliğini ayarlamak için ilgili .properties dosyasını düzenleyerek bir jeton ayarlayın ve ardından bileşeni yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service component restart
Örneğin, router.properties dosyasını düzenledikten sonra yönlendiriciyi yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Edge'i yükselttiğinizde /opt/apigee/customer/application dizinindeki .properties dosyaları okunur. Bu, yükseltme işleminin bileşende ayarladığınız tüm özellikleri koruyacağı anlamına gelir.
.properties dosyalarının konumu
Edge bileşenleri için .properties dosyalarının üç üst düzey dizini vardır: kurulum sahibi ve müşteriler. Varsayılan konumlar aşağıdaki tabloda gösterilmiştir:
Uyarı: Edge müşterileri yalnızca /opt/apigee/customer altındaki .properties dosyalarını değiştirebilir. Bileşen ve yükleme dizinleri altındaki dosyaları görüntüleyebilseniz de hiçbir dosyayı değiştirmeyin.
|
Sahip |
Varsayılan Jeton Kök Dizini |
|---|---|
|
Bileşen |
/opt/apigee/<prefix>-<component>/conf Burada /<prefix>-<component>, edge-router veya apigee-cassandra gibi bileşeni tanımlar. |
|
Kurulum |
/opt/apigee/token |
|
Müşteri |
/opt/apigee/customer |
Bir jetonun mevcut değerini belirleme
Bileşen için .properties dosyasında bir jeton ayarlamadan önce aşağıdaki komutu kullanarak mevcut değerini belirleyebilirsiniz:
> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token
Burada comp, bileşenin adıdır ve token, incelenecek jetondur.
Bu komut, jetonun mevcut değerini belirlemek için .properties dosyalarının hiyerarşisinde arama yapar.
Örneğin, Router için conf_http_HTTPRequest.line.limit jetonunun mevcut değerini kontrol etmek için:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Şu biçimde bir çıkış görürsünüz:
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
.properties dosyalarında jeton ayarlama
Bir jetonun değerini geçersiz kılmak için:
- Jeton değerini ayarlamak için bileşenin .properties dosyasını düzenleyin. Dosya yoksa oluşturun.
- Bileşeni yeniden başlatın.
- Jeton değerini kontrol edin.
Örneğin, Edge Router için istek satırı sınırını ayarlamak için:
- conf_http_HTTPRequest.line.limit jetonunu ayarlamak için /opt/apigee/customer/application/router.properties dosyasını düzenleyin:
conf_http_HTTPRequest.line.limit=8k - Edge Router'ı yeniden başlatın:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart - Jetonun değerini kontrol edin:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Birden fazla değer alan bir jeton ayarlama
Bazı jetonlar, virgülle ayrılmış bir değer listesi alır. Örneğin, conf_security_rbac.restricted.resources jetonu, yalnızca sysadmin tarafından çağrılabilecek şekilde kısıtlanmış URI'ların listesini alır. conf_security_rbac.restricted.resources değerini görmek için:
> cd /opt/apigee/edge-management-server > grep -ri "conf_security_rbac.restricted.resources" *
Çıkışta şunlar yer alır:
token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status
Değer listesi alan bir jeton ayarlamak için .properties dosyasındaki jetonun mevcut değerine yeni değerler ekleyin. Bu nedenle, /myuri/* URI'sini conf_security_rbac.restricted.resources'a eklemek için /opt/apigee/customer/application/management-server.properties dosyasını aşağıda gösterildiği gibi düzenleyin:
conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*
Jeton bulma
Çoğu durumda, ayarlamanız gereken jetonlar bu kılavuzda belirtilmiştir. Ancak bir özelliği geçersiz kılmak için kullanılan jetonu belirlemeniz gerekiyorsa bileşenin source klasöründe grep işlemi gerçekleştirin.
Örneğin, Edge'in önceki bir sürümünde session.maxAge özelliğini ayarladığınızı biliyorsanız ve bu özelliği ayarlamak için kullanılan jeton değerini öğrenmek istiyorsanız /opt/apigee/edge-ui/source dizininde özelliği grep ile arayın:
> grep -ri "session.maxAge" /opt/apigee/edge-ui/source
Aşağıdaki biçimde bir sonuç görürsünüz:
/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}{T}{/T} etiketleri arasındaki dize, .properties dosyasında ayarladığınız jetondur.
Şu anda açıklama satırı yapılmış bir jeton ayarlama
Edge yapılandırma dosyalarında bazı jetonlar açıklama satırı yapılmıştır. Açıklama satırı yapılmış bir jeton ayarlamaya çalışırsanız ayar yoksayılır.
Açıklama satırı yapılmış bir jeton ayarlamak için aşağıdaki biçimde özel bir söz dizimi kullanırsınız:
conf/file.extension+propertyName=propertyValue
Örneğin, Mesaj İşleyici'de HTTPClient.proxy.host adlı özelliği ayarlamak istiyorsunuz. Ardından, mülkün jetonunu belirlemek için grep komutunu kullanırsınız:
> cd /opt/apigee/edge-message-processor > grep -ri "HTTPClient.proxy.host" *
grep komutu, jeton değerini içeren biçimde sonuçlar döndürür. Özellik adının, özellik adındaki # ön ekiyle belirtildiği gibi nasıl açıklama satırı yapıldığı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=Özelliği ayarlamak için /opt/apigee/customer/application/message-processor.properties dosyasını düzenleyerek özelliği şu şekilde ayarlayın:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Özellik adının önüne conf/http.properties+ ifadesinin eklendiğine dikkat edin. Bu ifade, özelliği içeren yapılandırma dosyasının konumunu ve adını belirtir ve ardından "+" işareti gelir.
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, özellik grubunu şu biçimde görürsünüz:
conf/http.properties:HTTPClient.proxy.host=myhost.name.com