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

Edge for Private Cloud 4.19.01 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ırmayla kodlama (bazen CwC olarak kısaltılır) 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. Bileşen

Bir jetonun mevcut değerini belirleme

Bir .properties dosyasındaki jeton için yeni bir değer ayarlamadan önce, aşağıdaki komutu kullanarak jetonun 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, incelenecek jetondur.

Bu komut, jetonun mevcut değerini belirlemek için bileşenin .properties dosyalarının hiyerarşisini arar.

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

Aşağıdakine benzer 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

Jetonun değeri # ile başlıyorsa açıklama satırı yapılmıştır ve değeri değiştirmek için özel söz dizimi kullanmanız gerekir. Daha fazla bilgi için Şu anda açıklama satırı yapılmış bir jeton ayarlama başlıklı makaleyi inceleyin.

Jetonun tam adını bilmiyorsanız özellik adına veya anahtar kelimeye göre arama yapmak için grep gibi bir araç kullanın. Daha fazla bilgi için Jeton bulma başlıklı makaleyi inceleyin.

Özellik dosyaları

Düzenlenebilir ve düzenlenemez 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ı listelenmiştir:

Bu bileşen yapılandırma dosyalarından birinde bir özellik ayarlamak istiyorsanız ancak bu özellik mevcut değilse 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üzenleyemeyeceğiniz yapılandırma dosyaları da vardır.

Bilgilendirme amaçlı (düzenlenemeyen) dosyalar şunlardır:

/opt/apigee/token

/opt/apigee/component_name/conf

Jeton değeri ayarlama

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. Özellik dosyalarının tam listesi için .properties dosyalarının konumu başlıklı makaleye bakın.

.properties dosyası oluşturmak için:

1. Bir düzenleyicide yeni bir metin dosyası oluşturun. Dosya adı, müşteri dosyaları için yukarıdaki tabloda gösterilen listeyle eşleşmelidir.
2. 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. Bu, yükseltme işleminin bileşende ayarladığınız tüm özellikleri koruyacağı anlamına gelir.

Bir jetonun değerini ayarlamak için:

1. Bileşenin .properties dosyasını düzenleyin.
2. 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 aşağıdaki örnekte gösterildiği gibi her değeri virgülle ayırın:

   conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*

   Bunun gibi bir listeye yeni bir değer eklemek için genellikle yeni değeri listenin sonuna eklersiniz.

3. Bileşeni yeniden başlatın:

   /opt/apigee/apigee-service/bin/apigee-service component_name restart

   component_name, aşağıdakilerden 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 dosyasını düzenledikten sonra yönlendiriciyi yeniden başlatın:

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

4. (İsteğe bağlı) configure -search seçeneğini kullanarak jeton değerinin yeni değerinize ayarlandığını kontrol edin. Ö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 Jetonun mevcut değerini belirleme başlıklı makaleyi inceleyin.

Jeton bulma

Çoğu durumda, ayarlamanız gereken jetonlar bu kılavuzda belirtilmiştir. Ancak tam adından 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 komutunu kullanın.

Ö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 komutunu kullanın:

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

Aşağıdaki biçimde bir sonuç 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.

Ş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. Yükleme veya bileşen yapılandırma dosyasında açıklama satırı yapılmış bir jeton ayarlamaya çalışırsanız ayarınız yoksayılır.

Edge yapılandırma dosyasında açıklama satırı yapılmış bir jetonun değerini ayarlamak için aşağıdaki biçimde özel söz dizimi kullanın:

conf/filename+propertyName=propertyValue

Örneğin, Message Processor'da HTTPClient.proxy.host adlı özelliği ayarlamak için önce özelliğin jetonunu belirlemek üzere grep:

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

grep komutu, jeton adını içeren sonuçlar döndürür. Özellik adının, # ö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=

Bu özelliğin değerini ayarlamak için /opt/apigee/customer/application/message-processor.properties dosyasını 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, özellik adının önüne conf/http.properties+ eklemeniz gerekir. Bu, özelliği içeren yapılandırma dosyasının konumu ve adıdır ve ardından "+" gelir.

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