So konfigurieren Sie Edge

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

Apigee bezeichnet das Bearbeiten von .properties-Dateien als Code mit config (manchmal auch als CwC abgekürzt). Im Wesentlichen ist Code mit „config“ ein Tool zur Suche nach Schlüssel/Wert-Paaren, das auf Einstellungen in .properties-Dateien basiert. Im Code mit einer Konfiguration werden die Schlüssel als Tokens bezeichnet. Daher legen Sie zum Konfigurieren von Edge Tokens in .properties-Dateien fest.

Code mit Konfiguration ermöglicht Edge-Komponenten, Standardwerte festzulegen, die mit dem Produkt geliefert werden. Das Installationsteam kann diese Einstellungen je nach Installationstopologie überschreiben. Anschließend haben Kunden die Möglichkeit, alle gewünschten Attribute zu überschreiben.

Wenn Sie es sich als Hierarchie vorstellen, sind die Einstellungen so angeordnet, wobei die Kundeneinstellungen die höchste Priorität haben, um Einstellungen des Installationsprogramms oder von Apigee zu überschreiben:

1. Kunde
2. Installierer
3. Komponente

Aktuellen Wert eines Tokens ermitteln

Bevor Sie einen neuen Wert für ein Token in einer .properties-Datei festlegen, sollten Sie zuerst 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 das zu prüfende Token.

Mit diesem Befehl wird die Hierarchie der .properties-Dateien der Komponente durchsucht, um den aktuellen Wert des Tokens zu ermitteln.

Im folgenden Beispiel wird der aktuelle Wert des Tokens conf_http_HTTPRequest.line.limit für den Router geprüft:

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

Die Ausgabe sollte in etwa so aussehen:

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

Wenn der Wert des Tokens mit # beginnt, wurde er auskommentiert und Sie müssen eine spezielle Syntax verwenden, um ihn zu ändern. Weitere Informationen finden Sie unter Token festlegen, das derzeit auskommentiert ist.

Wenn Sie nicht den vollständigen Namen des Tokens kennen, verwenden Sie ein Tool wie grep, um nach dem Attributnamen oder dem Schlüsselwort zu suchen. Weitere Informationen finden Sie unter Token finden.

Eigenschaftendateien

Es gibt bearbeitbare und nicht bearbeitbare Komponentenkonfigurationsdateien. In diesem Abschnitt werden diese Dateien beschrieben.

Bearbeitbare Komponentenkonfigurationsdateien

In der folgenden Tabelle sind die Apigee-Komponenten und die Attributdateien aufgeführt, die Sie zum Konfigurieren dieser Komponenten bearbeiten können:

Wenn Sie eine Eigenschaft in einer dieser Komponentenkonfigurationsdateien festlegen möchten, dies jedoch nicht vorhanden ist, können Sie sie am oben angegebenen Speicherort erstellen.

Darüber hinaus müssen Sie sicherstellen, dass die Eigenschaftendatei dem Benutzer „apigee“ gehört:

chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties

Nicht bearbeitbare Komponentenkonfigurationsdateien

Zusätzlich zu den bearbeitbaren Komponentenkonfigurationsdateien gibt es auch Konfigurationsdateien, die Sie nicht bearbeiten können.

Zu den Informationsdateien (nicht bearbeitbare Dateien) gehören:

/opt/apigee/token

/opt/apigee/component_name/conf

Tokenwert festlegen

Sie können nur die .properties-Dateien im Verzeichnis /opt/apigee/customer/application ändern. Jede Komponente hat in diesem Verzeichnis eine eigene .properties-Datei. Beispiel: router.properties und management-server.properties. Eine vollständige Liste der Attributdateien finden Sie unter Speicherort von .properties-Dateien.

So erstellen Sie eine .properties-Datei:

1. Erstellen Sie eine neue Textdatei in einem Editor. Der Dateiname muss mit der Liste in der obigen Tabelle für Kundendateien übereinstimmen.
2. Ändern Sie den Eigentümer der Datei in „apigee:apigee“, wie im folgenden Beispiel gezeigt:

   chown apigee:apigee /opt/apigee/customer/application/router.properties

   Wenn Sie den Benutzer geändert haben, der den Edge-Dienst über den Benutzer „apigee“ ausführt, verwenden Sie chown, um die Eigentümerschaft auf den Benutzer zu ändern, der den Edge-Dienst ausführt.

Wenn Sie Edge aktualisieren, werden die .properties-Dateien im Verzeichnis /opt/apigee/customer/application gelesen. Das bedeutet, dass beim Upgrade alle Eigenschaften beibehalten werden, die Sie für die Komponente festgelegt haben.

So legen Sie den Wert eines Tokens fest:

1. Bearbeiten Sie die Datei .properties der Komponente.
2. Fügen Sie den Wert des Tokens hinzu oder ändern Sie ihn. Im folgenden Beispiel wird der Wert des Attributs conf_http_HTTPRequest.line.limit auf „10k“ festgelegt:

   conf_http_HTTPRequest.line.limit=10k

   Wenn das Token mehrere Werte annimmt, trennen Sie die einzelnen Werte wie im folgenden Beispiel durch ein Komma:

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

   Um einer Liste wie dieser einen neuen Wert hinzuzufügen, hängen Sie den neuen Wert in der Regel an das Ende der Liste an.

3. Starten Sie die Komponente neu:

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

   Dabei kann component_name für folgendes stehen:

   • 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)

   Starten Sie beispielsweise nach dem Bearbeiten von router.properties den Router neu:

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

4. (Optional) Prüfen Sie mithilfe der Option configure -search, ob der Tokenwert auf den neuen Wert festgelegt ist. Beispiel:

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

   Weitere Informationen zu configure -search finden Sie unter Aktuellen Wert eines Tokens ermitteln.

Token suchen

In den meisten Fällen werden die Tokens, die Sie festlegen müssen, in diesem Leitfaden identifiziert. Wenn Sie jedoch den Wert eines vorhandenen Tokens überschreiben müssen, dessen vollständiger Name oder Speicherort Sie nicht sicher sind, verwenden Sie grep, um das source-Verzeichnis der Komponente zu durchsuchen.

Wenn Sie beispielsweise wissen, dass Sie in einer vorherigen Version von Edge das Attribut session.maxAge festgelegt haben und wissen möchten, mit welchem Tokenwert es festgelegt wurde, verwenden Sie grep für das Attribut im Verzeichnis /opt/apigee/edge-ui/source:

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

Das Ergebnis sollte folgendes Format haben:

/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}

Das folgende Beispiel zeigt den Wert des session.maxAge-Tokens der UI:

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

Der String zwischen den {T}{/T}-Tags ist der Name des Tokens, das Sie in der Datei .properties der UI festlegen können.

Token festlegen, das derzeit auskommentiert ist

Einige Tokens sind in den Edge-Konfigurationsdateien auskommentiert. Wenn Sie versuchen, ein Token festzulegen, das in einer Installations- oder Komponentenkonfigurationsdatei auskommentiert ist, wird Ihre Einstellung ignoriert.

Verwenden Sie eine spezielle Syntax in der folgenden Form, um den Wert eines Tokens festzulegen, das in einer Edge-Konfigurationsdatei auskommentiert ist:

conf/filename+propertyName=propertyValue

Wenn Sie beispielsweise das Attribut HTTPClient.proxy.host für den Message Processor festlegen möchten, müssen Sie zuerst grep für das Attribut verwenden, um sein Token zu ermitteln:

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

Der Befehl grep gibt Ergebnisse zurück, die den Tokennamen enthalten. Der Attributname ist auskommentiert, wie durch das Präfix # angegeben:

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=

Wenn Sie den Wert dieses Attributs festlegen möchten, bearbeiten Sie /opt/apigee/customer/application/message-processor.properties. Verwenden Sie jedoch eine spezielle Syntax, wie im folgenden Beispiel gezeigt:

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

In diesem Fall müssen Sie dem Attributnamen das Präfix conf/http.properties+ voranstellen. Dies ist der Speicherort und der Name der Konfigurationsdatei, die das Attribut gefolgt von „+“ enthält.

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

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

Am Ende der Datei wird die festgelegte Eigenschaft in folgendem Format angezeigt:

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