Come configurare Edge

Edge per Private Cloud v4.18.05

Per configurare Edge dopo l'installazione, utilizza una combinazione di file .properties e le utilità Edge. Ad esempio, per configurare TLS/SSL nella UI Edge, .properties per impostare le proprietà necessarie. Modifiche a .properties file richiedono il riavvio del componente Edge interessato.

Apigee si riferisce alla tecnica di modifica dei file .properties come codice con config. In sostanza, il codice con Config è uno strumento di ricerca di coppie chiave/valore basato sulle impostazioni i file .properties. Nel codice con configurazione, le chiavi sono chiamate . Di conseguenza, per configurare Edge, devi impostare i token in .properties .

Il codice con configurazione consente ai componenti Edge di impostare valori predefiniti che vengono forniti con prodotto, consente al team di installazione di eseguire l'override di queste impostazioni in base alla topologia di installazione, e poi consente ai clienti di eseguire l'override delle strutture scelte da loro.

Se la pensi come una gerarchia, le impostazioni sono organizzate come segue con impostazioni con la massima priorità, per sostituire quelle del team di installazione; oppure Apigee:

  1. Cliente
  2. Installatore
  3. Apigee

Come utilizzare i file .properties

Come cliente, puoi modificare solo i file .properties in Directory /opt/apigee/customer/application. Ogni componente ha il suo .properties in quella directory. Ad esempio, router.properties e management-server.properties.

Ad esempio, per creare un file .properties:

  1. Crea il file in un editor come qualsiasi utente.
  2. Utilizza chown per modificare il proprietario del file in "apigee:apigee" o, se hai modificato l'utente che esegue il servizio Edge dall'app "apigee" l'utente, sottoponi il file all'utente che se il servizio Edge è in esecuzione.

Per impostare una proprietà per un componente, modifica il file .properties corrispondente da impostare un token, quindi riavvia il componente:

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

Ad esempio, dopo aver modificato router.properties, riavvia il router:

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

Quando esegui l'upgrade di Edge, i file .properties La directory /opt/apigee/customer/application è stata letta. Ciò significa che l'upgrade tutte le proprietà impostate sul componente.

Percorso dei file .properties

Esistono tre directory di primo livello per i file .properties per Edge componenti: installazione, proprietario e clienti. Le località predefinite vengono mostrate di seguito tabella:

Proprietario Directory root token predefinita
Componente 
/opt/apigee/component_name/conf

Dove component_name identifica il componente. Valori possibili include:

  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (database PostgreSQL)
  • apigee-qpidd (qpidd)
  • apigee-sso (SSO perimetrale)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (server di gestione)
  • edge-management-ui (nuova UI di Edge)
  • edge-message-processor (Elaboratore messaggi)
  • edge-postgres-server (server Postgres)
  • edge-qpid-server (server Qpid)
  • edge-router (router Edge)
  • edge-ui (UI classica)
Installazione 
/opt/apigee/token
Cliente 
/opt/apigee/customer

Determina il valore attuale di un token

Prima di impostare un token nel file .properties per il componente, puoi innanzitutto determinarne il valore attuale utilizzando il comando seguente:

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

Dove component_name è il nome del componente e token è il token da ispezionare.

Questo comando cerca nella gerarchia dei file .properties per determinare i attuale del token.

Ad esempio, per controllare il valore corrente dell'attributo conf_http_HTTPRequest.line.limit token per il router:

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

L'output dovrebbe essere visualizzato nel seguente formato:

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

Impostare i token nei file .properties

Per eseguire l'override del valore di un token:

  1. Modifica il file .properties del componente per impostare il valore del token. Se il file non esiste, quindi crearla.
  2. Riavvia il componente.
  3. Controlla il valore del token.

Ad esempio, per impostare il limite di righe di richiesta per il router Edge:

  1. Modifica il file /opt/apigee/customer/application/router.properties per impostare Token conf_http_HTTPRequest.line.limit: 
    conf_http_HTTPRequest.line.limit=8k
  2. Riavvia il router perimetrale: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  3. Verifica il valore del token: 
    /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit

Impostare un token che accetta più valori

Alcuni token utilizzano un elenco di valori separati da virgole. Ad esempio, Il token conf_security_rbac.restricted.resources accetta un elenco di URI limitati in modo che solo l'amministratore di sistema può chiamarli. Per visualizzare il valore di conf_security_rbac.restricted.resources:

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

L'output contiene quanto segue:

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

Per impostare un token che accetti un elenco di valori, aggiungi eventuali nuovi valori al valore attuale dell'attributo nel file .properties. Di conseguenza, per aggiungere l'URI /myuri/* a conf_security_rbac.restricted.resources, modifica il file /opt/apigee/customer/application/management-server.properties come mostrato sotto:

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

Individuare un token

Nella maggior parte dei casi, i token da impostare sono identificati in questa guida. Tuttavia, se hai bisogno per determinare il token utilizzato per eseguire l'override di una proprietà, esegui grep nel source del componente.

Ad esempio, se sai che in una release precedente di Edge hai impostato session.maxAge e vuoi conoscere il valore del token utilizzato per impostarla, poi grep per la proprietà nella directory /opt/apigee/edge-ui/source:

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

Dovresti vedere un risultato nel modulo:

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

La stringa tra i tag {T}{/T} è il token che imposti in il file .properties.

Imposta un token attualmente commentato

Alcuni token sono commentato nei file di configurazione di Edge. Se provi a impostare un token viene commentato, l'impostazione viene ignorata.

Per impostare un token che viene commentato, utilizza una sintassi speciale, nel formato:

conf/file.extension+propertyName=propertyValue

Ad esempio, vuoi impostare la proprietà denominata HTTPClient.proxy.host nella proprietà Processore. Devi quindi grep affinché la proprietà determini il relativo token:

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

Il comando grep restituisce i risultati nel formato che include il valore del token. Avvisi come viene commentato il nome della proprietà, come indicato dal prefisso # nella nome proprietà:

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=

Per impostare la proprietà, modifica /opt/apigee/customer/application/message-processor.properties per impostare la proprietà come:

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

Nota come il nome della proprietà è preceduto dal prefisso conf/http.properties+, la località e il nome del file di configurazione contenente la proprietà seguito da "+".

Dopo aver riavviato il processore di messaggi, esamina il file /opt/apigee/edge-message-processor/conf/http.properties:

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

Alla fine del file, vedrai la proprietà impostata nel formato:

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