Pour configurer Edge après l'installation, vous utilisez une combinaison de fichiers .properties
et d'utilitaires Edge. Par exemple, pour configurer TLS/SSL sur l'interface utilisateur Edge, vous devez modifier les fichiers .properties
pour définir les propriétés nécessaires. Les modifications apportées aux fichiers .properties
nécessitent que vous redémarriez le composant Edge concerné.
Apigee fait référence à la technique de modification des fichiers .properties
en tant que code avec configuration (parfois abrégé CwC). Globalement, le code avec configuration est un outil de recherche clé/valeur basé sur les paramètres des fichiers .properties
. Dans le code avec config, les clés sont appelées jetons. Par conséquent, pour configurer Edge, vous devez définir des jetons dans des fichiers .properties
.
L'option "Code avec configuration" permet aux composants Edge de définir des valeurs par défaut fournies avec le produit, à l'équipe d'installation de remplacer ces paramètres en fonction de la topologie de l'installation, puis aux clients de remplacer les propriétés de leur choix.
Si vous considérez cela comme une hiérarchie, les paramètres sont organisés comme suit (les paramètres client ayant la priorité la plus élevée remplacent les paramètres de l'équipe d'installation ou d'Apigee) :
- Client
- Installateur
- Composant
Déterminer la valeur actuelle d'un jeton
Avant de définir une nouvelle valeur de jeton dans un fichier .properties
, vous devez d'abord déterminer sa valeur actuelle à l'aide de la commande suivante:
/opt/apigee/apigee-service/bin/apigee-service component_name configure -search token
Où component_name est le nom du composant et token est le jeton à inspecter.
Cette commande recherche dans la hiérarchie des fichiers .properties
du composant pour déterminer la valeur actuelle du jeton.
L'exemple suivant vérifie la valeur actuelle du jeton conf_http_HTTPRequest.line.limit
pour le routeur:
/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Le résultat devrait ressembler à ceci:
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
Si la valeur du jeton commence par #
, celui-ci a été commenté. Vous devez utiliser une syntaxe spéciale pour le modifier. Pour en savoir plus, consultez la section Définir un jeton actuellement commenté.
Si vous ne connaissez pas le nom complet du jeton, utilisez un outil tel que grep
pour effectuer une recherche par nom de propriété ou par mot clé. Pour en savoir plus, consultez la section Localiser un jeton.
Fichiers de propriétés
Il existe des fichiers de configuration des composants modifiables et non modifiables. Cette section décrit ces fichiers.
Fichiers de configuration des composants modifiables
Le tableau suivant répertorie les composants Apigee et les fichiers de propriétés que vous pouvez modifier pour configurer ces composants:
Composant | Nom du composant | Fichier de configuration modifiable |
---|---|---|
Cassandra | apigee-cassandra |
/opt/apigee/customer/application/cassandra.properties |
Authentification unique Apigee | apigee-sso |
/opt/apigee/customer/application/sso.properties |
Serveur de gestion | edge-management-server |
/opt/apigee/customer/application/management-server.properties |
Processeur de messages | edge-message-processor |
/opt/apigee/customer/application/message-processor.properties |
apigee-monit |
apigee-monit |
/opt/apigee/customer/application/monit.properties |
Interface utilisateur classique (n'affecte pas la nouvelle interface utilisateur Edge) | edge-ui |
/opt/apigee/customer/application/ui.properties |
Interface utilisateur Edge (nouvelle interface utilisateur Edge uniquement ; n'affecte pas l'interface utilisateur classique) | apigee-management-ui |
N/A (utilisez le fichier de configuration d'installation) |
OpenLDAP | apigee-openldap |
/opt/apigee/customer/application/openldap.properties |
Serveur Postgres | edge-postgres-server |
/opt/apigee/customer/application/postgres-server.properties |
Base de données PostgreSQL | apigee-postgresql |
/opt/apigee/customer/application/postgressql.properties |
Serveur Qpid | edge-qpid-server |
/opt/apigee/customer/application/qpid-server.properties |
QPIDd | apigee-qpidd |
/opt/apigee/customer/application/qpidd.properties |
Routeur | edge-router |
/opt/apigee/customer/application/router.properties |
ZooKeeper | apigee-zookeeper |
/opt/apigee/customer/application/zookeeper.properties |
Si vous souhaitez définir une propriété dans l'un de ces fichiers de configuration de composant, mais qu'il n'existe pas, vous pouvez la créer à l'emplacement indiqué ci-dessus.
De plus, vous devez vous assurer que le fichier de propriétés appartient à l'utilisateur « apigee » :
chown apigee:apigee /opt/apigee/customer/application/configuration_file.properties
Fichiers de configuration des composants non modifiables
Outre les fichiers de configuration des composants modifiables, il existe des fichiers de configuration que vous ne pouvez pas modifier.
Les fichiers d'information (non modifiables) incluent les éléments suivants:
Propriétaire | Nom de fichier ou répertoire |
---|---|
Installation | /opt/apigee/token |
Composant | /opt/apigee/component_name/conf Où component_name identifie le composant. Les valeurs possibles sont les suivantes :
|
Définir une valeur de jeton
Vous ne pouvez modifier les fichiers .properties
que dans le répertoire /opt/apigee/customer/application
. Chaque composant possède son propre fichier .properties
dans ce répertoire. Par exemple, router.properties
et management-server.properties
. Pour obtenir la liste complète des fichiers de propriétés, consultez la section Emplacement des fichiers .properties.
Pour créer un fichier .properties
:
- Créez un fichier texte dans un éditeur. Le nom du fichier doit correspondre à la liste affichée dans le tableau ci-dessus pour les fichiers client.
- Remplacez le propriétaire du fichier par "apigee:apigee", comme le montre l'exemple suivant :
chown apigee:apigee /opt/apigee/customer/application/router.properties
Si vous avez changé l'utilisateur qui exécute le service Edge à partir de l'utilisateur "apigee", utilisez
chown
pour transférer la propriété à l'utilisateur qui exécute le service Edge.
Lorsque vous mettez à niveau Edge, les fichiers .properties
du répertoire /opt/apigee/customer/application
sont lus. Cela signifie que la mise à niveau conservera toutes les propriétés que vous avez définies sur le composant.
Pour définir la valeur d'un jeton:
- Modifiez le fichier
.properties
du composant. - Ajoutez ou modifiez la valeur du jeton. L'exemple suivant définit la valeur de la propriété
conf_http_HTTPRequest.line.limit
sur "10k" :conf_http_HTTPRequest.line.limit=10k
Si le jeton accepte plusieurs valeurs, séparez chaque valeur par une virgule, comme le montre l'exemple suivant:
conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*
Pour ajouter une nouvelle valeur à une liste de ce type, vous devez généralement ajouter la nouvelle valeur à la fin de la liste.
- Redémarrez le composant :
/opt/apigee/apigee-service/bin/apigee-service component_name restart
où component_name est l'un des éléments suivants :
apigee-cassandra
(Cassandra)apigee-openldap
(OpenLDAP)apigee-postgresql
(base de données PostgreSQL)apigee-qpidd
(Qpidd)apigee-sso
(authentification unique Edge)apigee-zookeeper
(ZooKeeper)edge-management-server
(serveur de gestion)edge-management-ui
(nouvelle interface utilisateur de périphérie)edge-message-processor
(processeur de messages)edge-postgres-server
(serveur Postgres)edge-qpid-server
(serveur Qpid)edge-router
(routeur périphérique)edge-ui
(interface utilisateur classique)
Par exemple, après avoir modifié
router.properties
, redémarrez le routeur:/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- (Facultatif) Vérifiez que la valeur du jeton est définie sur votre nouvelle valeur à l'aide de l'option
configure -search
. Exemple :/opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Pour en savoir plus sur
configure -search
, consultez Déterminer la valeur actuelle d'un jeton.
Localiser un jeton
Dans la plupart des cas, les jetons que vous devez définir sont identifiés dans ce guide. Toutefois, si vous devez remplacer la valeur d'un jeton existant dont vous n'êtes pas sûr du nom complet ou de l'emplacement, utilisez grep
pour effectuer une recherche dans le répertoire source
du composant.
Par exemple, si vous savez que dans une version précédente d'Edge, vous avez défini la propriété session.maxAge
et que vous souhaitez connaître la valeur du jeton utilisée pour la définir, grep
pour la propriété dans le répertoire /opt/apigee/edge-ui/source
:
grep -ri "session.maxAge" /opt/apigee/edge-ui/source
Le résultat devrait se présenter sous la forme suivante:
/opt/apigee/component_name/source/conf/application.conf:property_name={T}token_name{/T}
L'exemple suivant montre la valeur du jeton session.maxAge
de l'interface utilisateur:
/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}
La chaîne entre les balises {T}{/T} correspond au nom du jeton que vous pouvez définir dans le fichier .properties
de l'interface utilisateur.
Définir un jeton actuellement commenté
Certains jetons sont commentés dans les fichiers de configuration Edge. Si vous essayez de définir un jeton qui est commenté dans un fichier de configuration d'installation ou de composant, ce paramètre est ignoré.
Pour définir la valeur d'un jeton commenté dans un fichier de configuration Edge, utilisez une syntaxe spéciale au format suivant:
conf/filename+propertyName=propertyValue
Par exemple, pour définir la propriété nommée HTTPClient.proxy.host
sur le processeur de messages, commencez par grep
pour que la propriété détermine son jeton:
grep -ri /opt/apigee/edge-message-processor/ -e "HTTPClient.proxy.host"
La commande grep
renvoie des résultats qui incluent le nom du jeton. Notez que le nom de la propriété est commenté, comme indiqué par le préfixe #:
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=
Pour définir la valeur de cette propriété, modifiez /opt/apigee/customer/application/message-processor.properties
, mais utilisez une syntaxe spéciale, comme le montre l'exemple suivant:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Dans ce cas, vous devez ajouter le préfixe conf/http.properties+
au nom de la propriété. Il s'agit de l'emplacement et du nom du fichier de configuration contenant la propriété suivie du signe "+".
Après avoir redémarré le processeur de messages, examinez le fichier /opt/apigee/edge-message-processor/conf/http.properties
:
cat /opt/apigee/edge-message-processor/conf/http.properties
À la fin du fichier, vous verrez la propriété définie sous la forme:
conf/http.properties:HTTPClient.proxy.host=myhost.name.com