So konfigurieren Sie Edge

Edge for Private Cloud v4.18.05

Um Edge nach der Installation zu konfigurieren, verwenden Sie eine Kombination aus .properties-Dateien und Edge-Dienstprogramme. Um beispielsweise TLS/SSL in der Edge-Benutzeroberfläche zu konfigurieren, bearbeiten Sie .properties-Dateien, um die erforderlichen Attribute festzulegen. Änderungen an Für .properties-Dateien müssen Sie die betroffene Edge-Komponente neu starten.

Bei Apigee wird die Bearbeitung von .properties-Dateien als Code mit konfigurieren. Im Wesentlichen handelt es sich bei Code mit „config“ um ein Tool zum Nachschlagen von Schlüssel/Wert-Paaren, das auf den Einstellungen in die .properties-Dateien. Im Code mit „config“ werden die Schlüssel als Tokens Daher legen Sie zum Konfigurieren von Edge Tokens in .properties fest. Dateien.

Code mit Konfiguration ermöglicht es Edge-Komponenten, Standardwerte festzulegen, die mit dem kann das Installationsteam diese Einstellungen auf Basis der Installationstopologie überschreiben, und Kunden können dann alle ausgewählten Attribute überschreiben.

Wenn Sie es als Hierarchie betrachten, sind die Einstellungen so angeordnet, Einstellungen mit der höchsten Priorität die Einstellungen des Installateurteams oder Apigee:

  1. Kunde
  2. Installierer
  3. Apigee

Verwendung von .properties-Dateien

Als Kunde können Sie nur die .properties-Dateien in der /opt/apigee/customer/application-Verzeichnis. Jede Komponente hat ihre eigene .properties-Datei in diesem Verzeichnis. Beispiel: router.properties und management-server.properties.

So erstellen Sie beispielsweise eine .properties-Datei:

  1. Erstellen Sie die Datei in einem Editor als beliebiger Nutzer.
  2. Verwenden Sie chown, um den Eigentümer der Datei in „apigee:apigee“ zu ändern oder, wenn Sie den Benutzer, der den Edge-Dienst aus dem „Apigee“ ausführt Nutzer, geben Sie die Datei an den Nutzer weiter, der den Edge-Dienst ausführt.

Wenn du eine Eigenschaft für eine Komponente festlegen möchtest, musst du die entsprechende .properties-Datei bearbeiten ein Token und starten Sie die Komponente neu:

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

Nachdem Sie router.properties bearbeitet haben, starten Sie beispielsweise den Router neu:

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

Wenn Sie ein Upgrade für Edge ausführen, werden die .properties-Dateien im /opt/apigee/customer/application-Verzeichnis werden gelesen. Das bedeutet, dass das Upgrade behalten alle Eigenschaften bei, die Sie für die Komponente festgelegt haben.

Speicherort der .properties-Dateien

Es gibt drei Verzeichnisse der obersten Ebene für .properties-Dateien für Edge. Komponenten: Installation, Eigentümer und Kunden. Hier sehen Sie die Standardstandorte. Tabelle:

Inhaber Standard-Token-Stammverzeichnis
Komponente 
/opt/apigee/component_name/conf

Dabei bezeichnet component_name die Komponente. Mögliche Werte umfassen:

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (PostgreSQL-Datenbank)
  • apigee-qpidd (Qpidd)
  • apigee-sso (Edge-SSO)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (Verwaltungsserver)
  • edge-management-ui (neue Edge-Benutzeroberfläche)
  • edge-message-processor (Nachrichtenprozessor)
  • edge-postgres-server (Postgres-Server)
  • edge-qpid-server (Qpid-Server)
  • edge-router (Edge-Router)
  • edge-ui (klassische Benutzeroberfläche)
Installation 
/opt/apigee/token
Kunde 
/opt/apigee/customer

Aktuellen Wert eines Tokens ermitteln

Bevor Sie ein Token in der Datei .properties für die Komponente festlegen, können Sie zunächst den aktuellen Wert mit dem folgenden Befehl ermitteln:

/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token

Dabei ist component_name der Name der Komponente und token ist das zu prüfende Token.

Dieser Befehl durchsucht die Hierarchie der .properties-Dateien, um die Aktueller Wert des Tokens.

Um beispielsweise den aktuellen Wert von conf_http_HTTPRequest.line.limit zu prüfen, Token für den Router:

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

Die Ausgabe sollte im folgenden Format angezeigt werden:

Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties

Tokens in .properties-Dateien festlegen

So überschreiben Sie den Wert eines Tokens:

  1. Bearbeiten Sie die Datei .properties für die Komponente, um den Tokenwert festzulegen. Wenn die Datei nicht vorhanden ist, dann erstellen Sie sie.
  2. Starten Sie die Komponente neu.
  3. Prüfen Sie den Tokenwert.

So legen Sie beispielsweise das Limit für Anfragezeilen für den Edge Router fest:

  1. Bearbeiten Sie die Datei /opt/apigee/customer/application/router.properties, um die conf_http_HTTPRequest.line.limit-Token: 
    conf_http_HTTPRequest.line.limit=8k
  2. Starten Sie den Edge Router neu: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  3. Prüfen Sie den Wert des Tokens: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Token festlegen, das mehrere Werte annimmt

Für einige Tokens wird eine durch Kommas getrennte Liste von Werten verwendet. Beispiel: Der Parameter Das conf_security_rbac.restricted.resources-Token verwendet eine Liste von URIs, die so eingeschränkt ist, kann nur der Systemadministrator sie aufrufen. So rufen Sie den Wert von conf_security_rbac.restricted.resources auf:

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

Die Ausgabe enthält Folgendes:

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

Um ein Token festzulegen, das eine Liste von Werten annimmt, hängen Sie alle neuen Werte an den aktuellen Wert des Token in der Datei .properties. Um conf_security_rbac.restricted.resources also den URI /myuri/* hinzuzufügen, die Datei /opt/apigee/customer/application/management-server.properties wie gezeigt bearbeiten unten:

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

Token suchen

In den meisten Fällen sind die Tokens, die Sie festlegen müssen, in diesem Leitfaden angegeben. Wenn Sie jedoch Um das Token zu ermitteln, mit dem ein Attribut überschrieben wird, führen Sie einen grep im source der Komponente.

Wenn Sie zum Beispiel wissen, dass Sie in einer früheren Version von Edge den Parameter session.maxAge und möchten den Tokenwert wissen, mit dem es festgelegt wurde. grep für die Property im Verzeichnis /opt/apigee/edge-ui/source:

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

Sie sollten ein Ergebnis im Formular sehen:

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

Der String zwischen den {T}{/T}-Tags ist das Token, das Sie in .properties-Datei.

Token festlegen, das derzeit auskommentiert ist

Einige Tokens sind in den Edge-Konfigurationsdateien auskommentiert. Wenn Sie versuchen, ein Token festzulegen, auskommentiert ist, wird die Einstellung ignoriert.

Um ein Token festzulegen, das auskommentiert ist, verwenden Sie eine spezielle Syntax in der Form:

conf/file.extension+propertyName=propertyValue

Angenommen, Sie möchten das Attribut HTTPClient.proxy.host für die Nachricht festlegen. Prozessor. Geben Sie dann grep für das Attribut ein, um sein Token zu ermitteln:

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

Der Befehl grep gibt Ergebnisse in der Form zurück, die den Tokenwert enthält. Hinweis wie der Eigenschaftsname auskommentiert ist, wie durch das Präfix # im Eigenschaftsname:

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=

Bearbeiten Sie /opt/apigee/customer/application/message-processor.properties, um das Attribut festzulegen. um die Eigenschaft festzulegen:

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

Beachten Sie, wie dem Property-Namen das Präfix conf/http.properties+ vorangestellt wird, der Standort und dem Namen der Konfigurationsdatei, die die Eigenschaft enthält, gefolgt von "+".

Prüfen Sie die Datei nach dem Neustart des Message Processor /opt/apigee/edge-message-processor/conf/http.properties:

cat /opt/apigee/edge-message-processor/conf/http.properties

Am Ende der Datei sehen Sie die festgelegte Eigenschaft in folgendem Format:

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