Cómo configurar Edge

Para configurar Edge después de la instalación, debes usar una combinación de archivos .properties y utilidades de Edge. Por ejemplo, para configurar TLS/SSL en la IU de Edge, edita los archivos .properties para establecer las propiedades necesarias. Los cambios en los archivos .properties requieren que reinicies el componente de Edge afectado.

Apigee se refiere a la técnica de editar archivos .properties como código con configuración (a veces abreviado como CwC). Básicamente, el código con configuración es una herramienta de búsqueda de clave/valor basada en la configuración de los archivos .properties. En el código con configuración, las claves se denominan tokens. Por lo tanto, para configurar Edge, debes establecer tokens en los archivos .properties.

El código con configuración permite que los componentes de Edge establezcan valores predeterminados que se incluyen con el producto, permite que el equipo de instalación anule esos parámetros de configuración según la topología de instalación y, luego, permite que los clientes anulen las propiedades que elijan.

Si lo piensas como una jerarquía, la configuración se organiza de la siguiente manera, con la configuración del cliente como la prioridad más alta para anular cualquier configuración del equipo del instalador o de Apigee:

1. Cliente
2. Instalador
3. Componente

Cómo determinar el valor actual de un token

Antes de establecer un valor nuevo para un token en un archivo .properties, primero debes determinar su valor actual con el siguiente comando:

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

Donde component_name es el nombre del componente y token es el token que se inspeccionará.

Este comando busca en la jerarquía de los archivos .properties del componente para determinar el valor actual del token.

En el siguiente ejemplo, se verifica el valor actual del token conf_http_HTTPRequest.line.limit para el Router:

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

Deberías ver un resultado similar al siguiente:

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

Si el valor del token comienza con un #, se comentó y debes usar una sintaxis especial para cambiarlo. Para obtener más información, consulta Cómo establecer un token que está comentado actualmente.

Si no conoces el nombre completo del token, usa una herramienta como grep para buscar por el nombre de la propiedad o la palabra clave. Para obtener más información, consulta Cómo ubicar un token.

Archivos de propiedades

Existen archivos de configuración de componentes editables y no editables. En esta sección, se describen estos archivos.

Archivos de configuración de componentes editables

En la siguiente tabla, se enumeran los componentes de Apigee y los archivos de propiedades que puedes editar para configurar esos componentes:

Si deseas establecer una propiedad en uno de estos archivos de configuración de componentes, pero no existe, puedes crearla en la ubicación que se indicó anteriormente.

Además, debes asegurarte de que el archivo de propiedades sea propiedad del usuario "apigee":

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

Archivos de configuración de componentes no editables

Además de los archivos de configuración de componentes editables, también hay archivos de configuración que no puedes editar.

Los archivos informativos (no editables) incluyen lo siguiente:

/opt/apigee/token

/opt/apigee/component_name/conf

Establece un valor de token

Solo puedes modificar los archivos .properties en el directorio /opt/apigee/customer/application. Cada componente tiene su propio archivo .properties en ese directorio. Por ejemplo, router.properties y management-server.properties. Para obtener una lista completa de los archivos de propiedades, consulta Ubicación de los archivos .properties.

Sigue estos pasos para crear un archivo .properties:

1. Crea un archivo de texto nuevo en un editor. El nombre del archivo debe coincidir con la lista que se muestra en la tabla anterior para los archivos de clientes.
2. Cambia el propietario del archivo a "apigee:apigee", como se muestra en el siguiente ejemplo:

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

   Si cambiaste el usuario que ejecuta el servicio de Edge del usuario "apigee", usa chown para cambiar la propiedad al usuario que ejecuta el servicio de Edge.

Cuando actualizas Edge, se leen los archivos .properties en el directorio /opt/apigee/customer/application. Esto significa que la actualización conservará las propiedades que establezcas en el componente.

Para establecer el valor de un token, haz lo siguiente:

1. Edita el archivo .properties del componente.
2. Agrega o cambia el valor del token. En el siguiente ejemplo, se establece el valor de la propiedad conf_http_HTTPRequest.line.limit en "10k":

   conf_http_HTTPRequest.line.limit=10k

   Si el token toma varios valores, sepáralos con una coma, como se muestra en el siguiente ejemplo:

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

   Para agregar un valor nuevo a una lista como esta, por lo general, se agrega el valor nuevo al final de la lista.

3. Reinicia el componente:

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

   En el ejemplo anterior, component_name es una de las siguientes opciones:

   • apigee-cassandra (Cassandra)
   • apigee-openldap (OpenLDAP)
   • apigee-postgresql (base de datos de PostgreSQL)
   • apigee-qpidd (trinquete)
   • apigee-sso (SSO de Edge)
   • apigee-zookeeper (ZooKeeper)
   • edge-management-server (servidor de administración)
   • edge-management-ui (nueva IU de Edge)
   • edge-message-processor (Procesador de mensajes)
   • edge-postgres-server (servidor de Postgres)
   • edge-qpid-server (servidor Qpid)
   • edge-router (router perimetral)
   • edge-ui (IU clásica)

   Por ejemplo, después de editar router.properties, reinicia el router:

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

4. (Opcional) Verifica que el valor del token esté establecido en el valor nuevo con la opción configure -search. Por ejemplo:

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

   Para obtener más información sobre configure -search, consulta Cómo determinar el valor actual de un token.

Cómo encontrar un token

En la mayoría de los casos, los tokens que debes configurar se identifican en esta guía. Sin embargo, si necesitas anular el valor de un token existente cuyo nombre completo o ubicación no conoces, usa grep para buscar en el directorio source del componente.

Por ejemplo, si sabes que en una versión anterior de Edge estableciste la propiedad session.maxAge y quieres conocer el valor del token que se usó para establecerla, ejecuta grep para la propiedad en el directorio /opt/apigee/edge-ui/source:

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

Deberías ver un resultado como el siguiente:

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

En el siguiente ejemplo, se muestra el valor del token session.maxAge de la IU:

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

La cadena entre las etiquetas {T}{/T} es el nombre del token que puedes establecer en el archivo .properties de la IU.

Cómo establecer un token que actualmente está comentado

Algunos tokens están comentados en los archivos de configuración de Edge. Si intentas establecer un token que está comentado en un archivo de configuración de instalación o de componente, se ignorará tu configuración.

Para establecer el valor de un token que se comenta en un archivo de configuración de Edge, usa una sintaxis especial con el siguiente formato:

conf/filename+propertyName=propertyValue

Por ejemplo, para establecer la propiedad llamada HTTPClient.proxy.host en el procesador de mensajes, primero grep para la propiedad y determinar su token:

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

El comando grep devuelve resultados que incluyen el nombre del token. Observa cómo el nombre de la propiedad está comentado, como lo indica el prefijo #:

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=

Para establecer el valor de esta propiedad, edita /opt/apigee/customer/application/message-processor.properties, pero usa una sintaxis especial, como se muestra en el siguiente ejemplo:

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

En este caso, debes agregar el prefijo conf/http.properties+ al nombre de la propiedad. Esta es la ubicación y el nombre del archivo de configuración que contiene la propiedad, seguido de un signo "+".

Después de reiniciar el procesador de mensajes, examina el archivo /opt/apigee/edge-message-processor/conf/http.properties:

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

Al final del archivo, verás el conjunto de propiedades, de la siguiente manera:

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

Configura el proxy de reenvío para las solicitudes de la sección Send Requests de la IU de Trace

En esta sección, se explica cómo configurar un proxy de reenvío para las solicitudes de la sección Send Requests de la IU de Trace con credenciales de proxy opcionales. Sigue estos pasos para configurar el proxy de reenvío:

1. Edita el archivo /opt/apigee/customer/application/ui.properties y asegúrate de que apigee:apigee sea el propietario.
2. Agrega los siguientes reemplazos (cambia los valores a la configuración específica de tu proxy):

   conf_application_http.proxyhost=proxy.example.com
   conf_application_http.proxyport=8080
   conf_application_http.proxyuser=apigee
   conf_application_http.proxypassword=Apigee123!

3. Guarda y reinicia la IU clásica.

Agrega un formato de registro personalizado en el enrutador o Nginx de Apigee

En algunos casos, es posible que debas cambiar el formato de registro predeterminado del enrutador de Apigee o Nginx, o bien agregar variables. Para actualizar la configuración predeterminada del formato de registro del enrutador o Nginx de Apigee, haz lo siguiente:

1. Crea un archivo router.properties, si no existe, con la ruta que se muestra a continuación:

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

2. Agrega el siguiente contenido al archivo router.properties para crear una nueva configuración de log_format con el nombre router_new:

   conf_load_balancing_load.balancing.driver.nginx.global.http.parameters.template.extra=log_format router_new 'time_iso8601\\\\thostname\\\\tremote_addr:remote_port\\\\t'\\\\n\\n 'upstream_addr\\\\trequest_time\\\\t-\\\\t-\\\\t'\\\\n\\n 'status\\\\tupstream_status\\\\trequest_length\\\\t'\\\\n\\n 'body_bytes_sent\\\\t'\\\\n\\n 'request\\\\tupstream_http_x_apigee_message_id\\\\t'\\\\n\\n 'http_user_agent\\\\thost\\thostname-pid-connection-connection_requests\\\\tmy_nginx_var_xff\\t'\\\\n\\n 'upstream_http_x_apigee_fault_flag\\\\tupstream_http_x_apigee_fault_source\\\\tupstream_http_x_apigee_fault_code\\\\t'\\\\n\\n 'upstream_http_x_apigee_fault_policy\\tupstream_http_x_apigee_fault_flow\\tupstream_http_x_apigee_fault_revision\\t'\\\\n\\n 'upstream_http_x_apigee_dp_color\\\\tmy_x_apigee_target_latency\\\\t'\\\\n\\n 'upstream_http_x_apigee_proxy\\\\tupstream_http_x_apigee_proxy_basepath\\\\t'\\\\n\\n 'self_region\\\\tself_pod\\\\tself_color\\\\tssl_protocol\\\\tssl_client_verify\\\\tssl_session_id\\\\tssl_session_reused\\\\tupstream_pod\\\\tupstream_region';\\\\n\\n\n
   conf_load_balancing_load.balancing.driver.nginx.access.log={conf_load_balancing_load.balancing.driver.nginx.log.dir}/{org}~{env}.{port}_access_log router_new

   Actualiza las variables en los comandos anteriores según corresponda. Puedes encontrar los valores de configuración predeterminados para log_format en el siguiente archivo:

   /opt/apigee/edge-router/conf/load_balancing.properties

   En http://nginx.org/en/docs/varindex.html, se muestra una lista de variables de Nginx.

3. Reinicia el router para aplicar la nueva configuración:

   apigee-service edge-router restart

4. Verifica si se agregó la nueva configuración log_format (router_new) al archivo /opt/nginx/conf.d/0-default.conf:

       
   cat /opt/nginx/conf.d/0-default.conf | grep router_new -A 10

5. Envía algunas solicitudes a la API a un proxy de API y verifica el nuevo formato de registro en el archivo.

   /opt/apigee/var/log/edge-router/nginx/${org}~${env}.${port}_access_log file