Edge nasıl yapılandırılır?

Edge for Private Cloud 4.18.05 sürümü

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:

1. Müşteri
2. Yükleyici
3. 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.

Örneğin, .properties dosyası oluşturmak için:

1. Dosyayı herhangi bir kullanıcı olarak bir düzenleyicide oluşturun.
2. Dosyanın sahibini "apigee:apigee" olarak değiştirmek için chown komutunu kullanın. 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, sahip ve müşteriler. Varsayılan konumlar aşağıdaki tabloda gösterilmiştir:

/opt/apigee/component_name/conf

/opt/apigee/token

/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 component_name configure -search token

Burada component_name, bileşenin adı, token ise incelenecek jetondur.

Bu komut, jetonun mevcut değerini belirlemek için .properties dosyalarının hiyerarşisinde arama yapar.

Örneğin, yönlendirici 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 jetonları ayarlama

Bir jetonun değerini geçersiz kılmak için:

1. Bileşenin .properties dosyasını düzenleyerek jeton değerini ayarlayın. Dosya yoksa oluşturun.
2. Bileşeni yeniden başlatın.
3. Jeton değerini kontrol edin.

Örneğin, Edge Router için istek satırı sınırını ayarlamak için:

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

2. Uç yönlendiriciyi yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart

3. 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 dosyasına 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şlemini 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 dizinindeki özellik için grep:

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:

cd /opt/apigee/edge-message-processor
grep -ri "HTTPClient.proxy.host" *

grep komutu, jeton değerini içeren formda sonuçlar döndürür. Özellik adının önündeki # ön ekinden de anlaşılacağı üzere, özellik adının 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+, özelliği içeren yapılandırma dosyasının konumu ve adı, ardından "+" işaretinin eklendiğine dikkat edin.

Mesaj İşleyici'yi yeniden başlattıktan sonra şu dosyayı inceleyin: /opt/apigee/edge-message-processor/conf/http.properties:

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