Edge per il cloud privato v4.19.01
Per configurare Edge dopo l'installazione, utilizzi una combinazione di file .properties
e utilità di Edge. Ad esempio, per configurare TLS/SSL nell'interfaccia utente perimetrale, devi modificare
i file .properties
per impostare le proprietà necessarie. Le modifiche ai file .properties
richiedono il riavvio del componente Edge interessato.
Apigee fa riferimento alla tecnica di modifica dei file .properties
come codice con
configurazione (a volte abbreviata in CwC). In sostanza, il codice con la configurazione è uno strumento di ricerca chiave/valore basato sulle impostazioni nei file .properties
. Nel codice con configurazione, le chiavi sono chiamate
token. Pertanto, per configurare Edge, devi impostare i token in file
.properties
.
Il codice con configurazione consente ai componenti Edge di impostare i valori predefiniti forniti con il prodotto, consente al team di installazione di eseguire l'override di queste impostazioni in base alla topologia di installazione e ai clienti di eseguire l'override di qualsiasi proprietà scelta.
Se la pensi come una gerarchia, le impostazioni sono organizzate come segue, con le impostazioni dei clienti con la priorità massima di ignorare qualsiasi impostazione del team di installazione o di Apigee:
- Cliente
- Installatore
- Componente
Determina il valore corrente di un token
Prima di impostare un nuovo valore per un token in un file .properties
, è necessario determinare il suo valore corrente utilizzando il seguente comando:
/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token
Dove component_name è il nome del componente e token è il token da esaminare.
Questo comando esegue una ricerca nella gerarchia dei file .properties
del componente per determinare il valore corrente del token.
L'esempio seguente controlla il valore corrente del token conf_http_HTTPRequest.line.limit
per il router:
/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Dovresti vedere un output simile al seguente:
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
Se il valore del token inizia con #
, è stato commentato e devi usare una sintassi speciale per modificarlo. Per maggiori informazioni, consulta la pagina
Impostare un token attualmente commentato.
Se non conosci l'intero nome del token, utilizza uno strumento come grep
per eseguire una ricerca in base al nome della proprietà o alla parola chiave. Per maggiori informazioni, consulta la pagina Individuare un
token.
File delle proprietà
Sono presenti file di configurazione dei componenti modificabili e non modificabili. In questa sezione vengono descritti questi file.
File di configurazione dei componenti modificabili
La tabella seguente elenca i componenti Apigee e i file delle proprietà che puoi modificare per configurarli:
Componente | Nome componente | File di configurazione modificabile |
---|---|---|
Cassandra | apigee-cassandra |
/opt/apigee/customer/application/cassandra.properties |
Interfaccia utente perimetrale | edge-ui |
/opt/apigee/customer/application/ui.properties |
SSO perimetrale | apigee-sso |
/opt/apigee/customer/application/sso.properties |
Server di gestione | edge-management-server |
/opt/apigee/customer/application/management-server.properties |
processore di messaggi | edge-message-processor |
/opt/apigee/customer/application/message-processor.properties |
apigee-monit |
apigee-monit |
/opt/apigee/customer/application/monit.properties |
Nuova UE | apigee-management-ui |
n/d (utilizza il file di configurazione dell'installazione) |
OpenLDAP | apigee-openldap |
/opt/apigee/customer/application/openldap.properties |
Server Postgres | edge-postgres-server |
/opt/apigee/customer/application/postgres-server.properties |
Database PostgreSQL | apigee-postgresql |
/opt/apigee/customer/application/postgressql.properties |
Server Qpid | edge-qpid-server |
/opt/apigee/customer/application/qpid-server.properties |
QPIGG | apigee-qpidd |
/opt/apigee/customer/application/qpidd.properties |
Router | edge-router |
/opt/apigee/customer/application/router.properties |
Zookeeper | apigee-zookeeper |
/opt/apigee/customer/application/zookeeper.properties |
Se vuoi impostare una proprietà in uno di questi file di configurazione dei componenti, ma non esiste, puoi crearla nella posizione sopra indicata.
Inoltre, devi assicurarti che il file delle proprietà sia di proprietà dell'utente "Apigee":
chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties
File di configurazione dei componenti non modificabili
Oltre ai file di configurazione dei componenti modificabili, esistono anche file di configurazione che non puoi modificare.
I file informativi (non modificabili) includono:
Proprietario | Nome file o directory |
---|---|
Installazione | /opt/apigee/token |
Componente | /opt/apigee/component_name/conf Dove component_name identifica il componente. I valori possibili sono:
|
Imposta un valore per il token
Puoi modificare solo i file .properties
nella directory /opt/apigee/customer/application
. Ogni componente ha il proprio
file .properties
in quella directory. Ad esempio, router.properties
e management-server.properties
. Per un elenco completo dei file delle proprietà, consulta la sezione Posizione dei file .properties.
Per creare un file .properties
:
- Crea un nuovo file di testo in un editor. Il nome del file deve corrispondere all'elenco mostrato nella tabella precedente per i file dei clienti.
- Cambia il proprietario del file in "apigee:Apigee", come mostrato nell'esempio seguente:
chown apigee:apigee /opt/apigee/customer/application/router.properties
Se hai modificato l'utente che esegue il servizio Edge dall'utente "Apigee", utilizza
chown
per passare la proprietà all'utente che esegue il servizio Edge.
Quando esegui l'upgrade di Edge, i file .properties
nella
directory /opt/apigee/customer/application
vengono letti. Ciò significa che l'upgrade conserverà tutte le proprietà impostate sul componente.
Per impostare il valore di un token:
- Modifica il file
.properties
del componente. - Aggiungi o modifica il valore del token. L'esempio seguente imposta il valore della
proprietà
conf_http_HTTPRequest.line.limit
su "10k":conf_http_HTTPRequest.line.limit=10k
Se il token utilizza più valori, separali con una virgola, come illustrato nell'esempio seguente:
conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*
Per aggiungere un nuovo valore a un elenco come questo, in genere aggiungi il nuovo valore alla fine dell'elenco.
- Riavvia il componente:
/opt/apigee/apigee-service/bin/apigee-service component_name restart
Dove component_name è uno dei seguenti:
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)
Ad esempio, dopo aver modificato
router.properties
, riavvia il router:/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- (Facoltativo) Verifica che il valore del token sia impostato sul nuovo valore utilizzando l'opzione
configure -search
. Ad esempio:/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Per maggiori informazioni su
configure -search
, consulta Determinare il valore corrente di un token.
Individuare un token
Nella maggior parte dei casi, i token che devi impostare sono identificati in questa guida. Tuttavia, se devi sostituire il valore di un token esistente di cui non sai con certezza il nome completo o la posizione, utilizza grep
per eseguire ricerche nella directory source
del componente.
Ad esempio, se sai che in una release precedente di Edge hai impostato la proprietà session.maxAge
e vuoi conoscere il valore del token utilizzato per impostarla, 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 seguente formato:
/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}
L'esempio seguente mostra il valore del token session.maxAge
dell'interfaccia utente:
/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}
La stringa tra i tag {T}{/T} è il nome del token che puoi impostare nel file .properties
dell'interfaccia utente.
Impostare un token attualmente commentato
Alcuni token sono commentati nei file di configurazione Edge. Se tenti di impostare un token commentato in un file di configurazione di installazione o componenti, l'impostazione viene ignorata.
Per impostare il valore di un token commentato in un file di configurazione Edge, utilizza la sintassi speciale nel seguente formato:
conf/filename+propertyName=propertyValue
Ad esempio, per impostare la proprietà denominata HTTPClient.proxy.host
nell'Elaboratore messaggi, devi prima grep
per determinare il relativo token:
grep -ri /opt/apigee/edge-message-processor/ -e "HTTPClient.proxy.host"
Il comando grep
restituisce i risultati che includono il nome del token. Nota
come viene commentato il nome della proprietà, come indicato dal prefisso #:
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 il valore di questa proprietà, modifica /opt/apigee/customer/application/message-processor.properties
, ma utilizza una sintassi speciale, come illustrato nell'esempio seguente:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
In questo caso, devi aggiungere il prefisso conf/http.properties+
al nome della proprietà. ovvero il percorso e il nome del file di configurazione che contiene 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