Edge for Private Cloud Version 4.17.09
Um Edge nach der Installation zu konfigurieren, verwenden Sie eine Kombination aus .properties-Dateien und Edge-Dienstprogrammen. Für Um TLS/SSL in der Edge-Benutzeroberfläche zu konfigurieren, bearbeiten Sie beispielsweise .properties-Dateien, um die erforderlichen Eigenschaften. Bei Änderungen an .properties-Dateien müssen Sie den betroffene Edge-Komponente.
Bei Apigee wird die Technik des Bearbeitens von .properties-Dateien als Code mit config (Konfiguration angeben) auf. 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 konfigurieren, werden die Schlüssel als Tokens bezeichnet. Daher legen Sie zum Konfigurieren von Edge Tokens fest. in .properties-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:
- Kunde
- Installierer
- Apigee
Verwendung von .properties-Dateien
Als Kunde können Sie nur die .properties-Dateien in den /opt/apigee/customer/application -Verzeichnis. Jede Komponente hat in diesem Verzeichnis eine eigene .properties-Datei. Beispiel: router.properties und management-server.properties.
So erstellen Sie beispielsweise eine .properties-Datei:
- Erstellen Sie die Datei in einem Editor als beliebiger Nutzer.
- Wählen Sie den Eigentümer der Datei apigee:apigee aus oder, wenn Sie den Benutzer geändert haben Ausführen des Edge-Dienstes über den Apigee-Benutzer, wählen Sie die Datei an den Benutzer aus, der den Edge-Dienst ausführt.
Um eine Eigenschaft für eine Komponente festzulegen, bearbeiten Sie die entsprechende .properties-Datei, um ein Token festzulegen. und starten Sie die Komponente neu:
> /opt/apigee/apigee-service/bin/apigee-service component restart
Nachdem Sie router.properties bearbeitet haben, starten Sie den Router neu:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Wenn Sie ein Upgrade von Edge durchführen, werden die .properties-Dateien im /opt/apigee/customer/application gelesen werden. Das bedeutet, dass beim Upgrade alle Properties beibehalten werden, die Sie auf der Seite Komponente.
Speicherort der .properties-Dateien
Es gibt drei Verzeichnisse der obersten Ebene für .properties-Dateien für Edge. Komponenten: Inhaber der Installation und Kunden. Hier sehen Sie die Standardstandorte. Tabelle:
Warnung: Edge-Kunden können nur die .properties-Dateien ändern unter /opt/apigee/customer. Während Sie können Dateien unter den Komponenten- und Installationsverzeichnissen anzeigen und keine Dateien ändern.
|
Inhaber |
Standard-Token-Stammverzeichnis |
|---|---|
|
Komponente |
/opt/apigee/<prefix>-<component>/conf Wo? /<prefix>-<component> identifiziert die Komponente, z. B. Edge-Router oder Apigee-Cassandra. |
|
Installation |
/opt/apigee/token |
|
Kunde |
/opt/apigee/customer |
Aktuellen Wert eines Tokens ermitteln
Bevor Sie in der .properties-Datei ein Token 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 comp configure -search token
Dabei ist comp der Name der Komponente und token ist das zu prüfende Token.
Mit diesem Befehl wird die Hierarchie der .properties-Dateien durchsucht, um zu ermitteln, Aktueller Wert des Tokens.
Um beispielsweise den aktuellen Wert des Tokens conf_http_HTTPRequest.line.limit auf 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:
- Bearbeiten Sie die .properties-Datei für den Komponente zum Festlegen des Tokenwerts. Wenn die Datei nicht vorhanden ist, erstellen Sie sie.
- Starten Sie die Komponente neu.
- Prüfen Sie den Tokenwert.
So legen Sie beispielsweise das Limit für Anfragezeilen für den Edge Router fest:
- Bearbeiten Sie die Datei /opt/apigee/customer/application/router.properties
Datei zum Festlegen des Tokens conf_http_HTTPRequest.line.limit:
conf_http_HTTPRequest.line.limit=8k - Starten Sie den Edge Router neu:
> /opt/apigee/apigee-service/bin/apigee-service Edge-Router-Neustart - Prüfen Sie den Wert des Tokens:
> /opt/apigee/apigee-service/bin/apigee-service Edge-router konfigurieren -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. Zum Beispiel das Token conf_security_rbac.restricted.resources verwendet eine Liste von URIs, die so eingeschränkt ist, dass nur der Systemadministrator sie aufrufen kann. Um die von conf_security_rbac.restricted.resources an:
> 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 .properties-Datei. Um den URI /myuri/* also conf_security_rbac.restricted.resources hinzuzufügen, /opt/apigee/customer/application/management-server.properties bearbeiten wie unten dargestellt:
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 eine Eigenschaft überschrieben wird, führen Sie den Befehl grep im Ordner source der Komponente aus.
Wenn Sie beispielsweise wissen, dass Sie in einer vorherigen Version von Edge die Eigenschaft session.maxAge festgelegt haben und wissen möchten, Tokenwert, mit dem er festgelegt wurde, und anschließend grep für die Eigenschaft 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 der Datei .properties.
Token festlegen, das derzeit kommentiert ist aus
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 die Eigenschaft HTTPClient.proxy.host für die Nachricht festlegen. Prozessor. Dann geben Sie grep für den Befehl , um das zugehörige Token zu ermitteln:
> cd /opt/apigee/edge-message-processor > grep -ri "HTTPClient.proxy.host" *
Der Befehl grep gibt führt zu dem Format, das den Tokenwert enthält. Der Eigenschaftsname ist auskommentiert. Dies wird durch das Präfix # im Attributnamen 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=
Bearbeiten Sie /opt/apigee/customer/application/message-processor.properties, um die Eigenschaft festzulegen. um die Eigenschaft festzulegen:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Beachten Sie, wie dem Property-Namen conf/http.properties+, der Speicherort und der Name vorangestellt wird. der Konfigurationsdatei mit der Eigenschaft gefolgt von "+".
Nachdem Sie den Message Processor neu gestartet haben, überprüfen Sie die Datei /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