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

Edge for Private Cloud s. 4.17.09

Edge'i yükleme işleminden sonra yapılandırmak için .properties dosyalarının ve Edge yardımcı programlarının bir kombinasyonunu kullanırsınız. Örneğin, Örneğin, Edge kullanıcı arayüzünde TLS/SSL'yi yapılandırmak için .properties dosyalarını düzenleyerek gerekli özellikler. .properties dosyalarında yapılan değişiklikler için bölümünü ziyaret edin.

Apigee, .properties dosyalarını kod olarak yapılandırma. Esasen, config ile kod, Google Web Yöneticisi Araçları'ndaki ayarlara dayalı .properties dosyalarını seçin. Şununla kod olarak: config'de anahtarlara jeton adı verilir. Bu nedenle, Edge'i yapılandırmak için jetonlar .properties dosyaları.

Yapılandırmalı kod, Edge bileşenlerinin kurulum ekibinin bu ayarları kurulum topolojisine göre geçersiz kılmasını sağlar. Böylece müşteriler seçtikleri tüm mülkleri geçersiz kılabilir.

Bunu bir hiyerarşi olarak düşünürseniz, ayarlar müşteriyle şu şekilde düzenlenir: ayarlarını geçersiz kılmak için en yüksek önceliğe sahip ayarları yapma veya Apigee:

  1. Müşteri
  2. Yükleyici
  3. Apigee

.properties dosyalarını kullanma

Müşteri olarak, .properties dosyalarını yalnızca /opt/apigee/customer/application dizin. Her bileşenin o dizinde kendi .properties dosyası vardır. Örneğin, router.properties. ve management-server.properties.

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

  1. Dosyayı bir düzenleyicide herhangi bir kullanıcı olarak oluşturun.
  2. Dosyanın sahibini Apigee:Apigee konumuna veya kullanıcıyı değiştirdiyseniz bu kişiye alçlama Edge hizmetini Apigee kullanıcısından çalıştırmanız durumunda, dosyayı , Edge hizmetini çalıştırıyor.

Bir bileşen için özellik ayarlamak üzere ilgili .properties dosyasını düzenleyerek bir jeton ayarlayın. ve 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önlendirici'yi yeniden başlatın:

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

Edge'i yeni sürüme geçirdiğinizde.properties /opt/apigee/customer/application okunduğundan emin olun. Bu durum, yükseltme işleminin, bir bileşenidir.

.properties dosyalarının konumu

Edge'in .properties dosyaları için üç üst düzey dizin vardır bileşenler: yükleme sahibi ve müşteriler. Varsayılan konumlar aşağıda gösterilmiştir tablo:

Uyarı: Edge müşterileri yalnızca .properties dosyalarını /opt/apigee/customer. Bu sırada bileşen ve yükleme dizinlerinin altındaki dosyaları görüntüleyebilir, hiçbir dosyayı değiştirmeyin.

Sahip

Varsayılan Jeton Kök Dizini

Bileşen

/opt/apigee/<prefix>-<component>/conf

burada: /<prefix>-<component> kenar-yönlendirici veya Apigee-cassandra gibi bileşeni tanımlar.

Kurulum

/opt/apigee/token

Müşteri

/opt/apigee/customer

Bir jetonun mevcut değerini belirleme

Bileşenin .properties dosyasında bir jeton ayarlamadan önce, ö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 jeton, incelenecek jetondur.

Bu komut,.properties jetonun mevcut değeri.

Örneğin, conf_http_HTTPRequest.line.limit jetonunun mevcut değerini kontrol etmek için Yönlendirici:

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

Çıkış şu şekilde görünmelidir:

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. Şu öğenin .properties dosyasını düzenleyin: bileşenini ayarlayabilirsiniz. Dosya mevcut değilse, oluşturun.
  2. Bileşeni yeniden başlatın.
  3. Jeton değerini kontrol edin.

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

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

    conf_http_HTTPRequest.line.limit=8k
  2. Uç Yönlendirici'yi yeniden başlatın:

    . > /opt/Apigee/Apigee-service/bin/gelir-hizmeti uç-yönlendirici yeniden başlatma
  3. Jetonun değerini kontrol edin:

    . > /opt/Apigee/Apigee-service/bin/potansiyel-service Edge-router yapılandırabilir -search conf_http_HTTPRequest.line.limit

Birden çok değer alan bir jeton ayarlama

Bazı simgeler virgülle ayrılmış değerler listesi alır. Örneğin, conf_security_rbac.restricted.resources jetonu bulunur. yalnızca sistem yöneticisinin çağırabilmesi için kısıtlanmış URI'lerin bir listesini alır. Görmek için conf_security_rbac.restricted.resources değerini değiştirin:

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

Çıkış şu ifadeleri içerir:

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

Değerler listesi alan bir jeton ayarlamak için yeni değerleri .properties dosyasındaki jeton. Bu nedenle, conf_security_rbac.restricted.resources için /myuri/* URI'sini eklemek için, /opt/apigee/customer/application/management-server.properties dosyasını düzenleyin. dosyası aşağıda gösterildiği gibidir:

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 belirlemek amacıyla bileşenin source klasöründe bir 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 jeton değerini ayarlamak için kullanılır ve ardından /opt/Apigee/edge-ui/source dizinindeki özellik için grep değerini kullanabilir:

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

Şu biçimde bir sonuç görmeniz gerekir:

/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}

{T}{/T} etiketleri arasındaki dize, .properties dosyasını seçin.

Yorumlanmış olan bir jetonu ayarlama dışarıda

Bazı jetonlar, Edge yapılandırma dosyalarında yorumlanmıştır. Bir jeton ayarlamaya çalışırsanız yorum yapılırsa ayar yoksayılır.

Yorum yapılan bir jetonu ayarlamak için şu biçimde özel bir söz dizimi kullanırsınız:

conf/file.extension+propertyName=propertyValue

Örneğin, Message API'de HTTPClient.proxy.host adlı özelliği ayarlamak İşleyen. Ardından, özelliğini kullanmanız gerekir:

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

grep komutu jeton değerini içeren bir form elde edilir. Özellik adının nasıl yorumlandığına dikkat edin. # önekiyle belirtildiği gibi:

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üzenleyin değerini girin:

conf/http.properties+HTTPClient.proxy.host=myhost.name.com

Mülk adının conf/http.properties+, konumun ve adın önüne nasıl eklendiğine dikkat edin. özelliği içeren "+" işaretini içeren yapılandırma dosyası ekleyin.

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 ayarlandığını şu biçimde görürsünüz:

conf/http.properties:HTTPClient.proxy.host=myhost.name.com