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

Edge for Private Cloud v. 4.17.01

Kurulumdan 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ındaki değişiklikler, etkilenen Edge bileşenini yeniden başlatmanızı gerektirir.

Apigee, .properties dosyalarını yapılandırmalı kod olarak düzenleme tekniğini ifade eder. Temel olarak yapılandırma içeren kod, .properties dosyalarındaki ayarları temel alan bir anahtar/değer arama aracıdır. Yapılandırmalı kodda anahtarlara jeton adı verilir. 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 belirlemesine olanak tanır, kurulum ekibinin yükleme topolojisine göre bu ayarları 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üyorsanız ayarlar, yükleyici ekibinden veya Apigee'den gelen tüm ayarları geçersiz kılmak için en yüksek önceliğe sahip müşteri ayarlarıyla aşağıdaki şekilde düzenlenir:

  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.

  1. Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
  2. Dosyanın sahibini Apigee:Apigee olarak adlandırın veya Edge hizmetini çalıştıran kullanıcıyı Apigee kullanıcısından değiştirdiyseniz dosyayı Edge hizmetini çalıştıran kullanıcıya chown yapın.

Bir bileşen için özellik ayarlamak üzere jeton ayarlamak üzere ilgili .properties dosyasını düzenleyin, ardından bileşeni yeniden başlatın:

> /opt/apigee/apigee-service/bin/apigee-service component restart

Örneğin, router.properties öğesini düzenledikten sonra Yönlendiriciyi yeniden başlatın:

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

Edge'i yeni sürüme geçirdiğinizde /opt/apigee/customer/application dizinindeki .properties dosyaları okunur. Bu, yükseltme işleminin bileşen üzerinde ayarladığınız tüm özellikleri koruyacağı anlamına gelir.

.properties dosyalarının konumu

Edge bileşenleri için .properties dosyaları için üç üst düzey dizin vardır: yükleme sahibi ve müşteriler. Varsayılan konumlar aşağıdaki tabloda gösterilmektedir:

Uyarı: Edge müşterileri yalnızca /opt/apigee/customer altındaki .properties dosyalarını değiştirebilir. Bileşen ve yükleme dizinlerinin altındaki dosyaları görüntüleyebilirsiniz ancak hiçbir dosyayı değiştirmeyin.

Owner

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.

Döşeme

/opt/apigee/token

Müşteri

/opt/apigee/customer

Bir jetonun mevcut değerini belirleme

Bileşenin .properties dosyasında jeton ayarlamadan önce, ilk olarak aşağıdaki komutu kullanarak öğenin geçerli değerini belirleyebilirsiniz:

> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token

Burada comp bileşenin adı, jeton 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 üzere:

> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Çıkışı şu biçimde görmeniz gerekir:

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:

  1. Jeton değerini ayarlamak için bileşenin .properties dosyasını düzenleyin. Dosya yoksa oluşturun.
  2. Bileşeni yeniden başlatın.
  3. Jeton değerini kontrol edin.

Örneğin, Uç Yönlendirici için istek satırı sınırını ayarlamak üzere:

  1. /opt/apigee/customer/application/router.properties dosyasını /opt/apigee/customer/application/router.properties jetonunu ayarlamak için düzenleyin:

    /opt/apigee/customer/application/router.properties
  2. Uç Yönlendiriciyi yeniden başlatın:

    > /opt/Apigee/Apigee-service/bin/Apigee-service kenar-router yeniden başlatma
  3. Jetonun değerini kontrol edin:

    > /opt/../..//Apigee-service/bin/Apigee-service Edge-router include -search conf_http_HTTPRequest.line.limit

Birden çok değer alan bir jeton ayarlama

Bazı jetonlar değerlerin virgülle ayrılmış bir listesini alır. Örneğin, conf_security_rbac.restricted.resources jetonu, yalnızca sysadmin'in çağırabileceği şekilde kısıtlanmış URI'ların bir listesini alır. conf_security_rbac.restricted.resources'un değerini görmek için:

> cd /opt/apigee/edge-management-server
> grep -ri "conf_security_rbac.restricted.resources" *

Çıkış şunları içerir:

token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status

Değerler listesini alan bir jeton ayarlamak için yeni değerleri, .properties dosyasında jetonun mevcut değerine ekleyin. Bu nedenle, /myuri/* URI'sını conf_security_rbac.restricted.resources adresine 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/*

Jetonu bulma

Çoğu durumda, ayarlamanız gereken jetonlar bu kılavuzda açıklanmıştır. 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ı ve bunu ayarlamak için kullanılan jeton değerini bilmek istediğinizi biliyorsanız /opt/Apigee/edge-ui/source dizinindeki mülk için grep parametresini kullanın:

> grep -ri "session.maxAge" /opt/apigee/edge-ui/source

Şu formda bir sonuç göreceksiniz:

/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 yorum eklenmiş olan bir jeton ayarlama

Bazı jetonlar, Edge yapılandırma dosyalarında açıklamaya dahil edilir. Yorum yapılan bir jeton ayarlamaya çalışırsanız ayar yoksayılır.

Yorum yapılan bir jetonu ayarlamak için şu şekilde ö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. Daha sonra mülk için jetonunu belirlemek üzere grep özelliğini kullanırsınız:

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

grep komutu, sonuçları jeton değerini içeren biçimde döndürür. Mülk adındaki # ön ekiyle belirtildiği gibi, ö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=

Özelliği ayarlamak için /opt/apigee/customer/application/message-processor.properties öğesini 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ı ve ardından "+" işareti eklenir.

İleti İş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=yhost.name.com