Una instalación típica de Edge consta de componentes de Edge distribuidos en varios nodos. Después de instalar Edge en un nodo, debes instalar y configurar uno o más componentes de Edge el nodo.
Proceso de instalación
La instalación de Edge en un nodo es un proceso de varios pasos:
- Inhabilita SELinux en el nodo o configúralo en modo permisivo. Consulta Instala la utilidad de Apigee-setup de Edge para más.
- Decide si quieres habilitar la autenticación de Cassandra.
- Decide si deseas configurar la replicación en espera de instancia principal para Postgres.
- Selecciona la configuración de Edge en la lista de topologías recomendadas. Por ejemplo, puedes instalar Edge en un solo nodo para las pruebas o en 13 nodos para la producción. Consulta Installation Topologys (Topologías de instalación) para obtener más información.
- En cada nodo de la topología seleccionada, instala la utilidad
apigee-setup
de Edge:- Descarga el archivo
bootstrap_4.52.00.sh
de Edge en/tmp/bootstrap_4.52.00.sh
- Instala la utilidad y las dependencias
apigee-service
de Edge. - Instala la utilidad y las dependencias
apigee-setup
de Edge.Consulta Instala el entorno de Apigee-setup de Edge utilitario para obtener más información.
- Descarga el archivo
- Usa la utilidad
apigee-setup
para instalar uno o más componentes de Edge en cada uno según la topología seleccionada.Consulta Instala componentes de Edge en un nodo.
- En el nodo del servidor de administración, usa la utilidad
apigee-setup
para instalarapigee-provision
, las utilidades que usas para crear y administrar Edge organizaciones.Consulta Integra una organización para obtener más información.
- Reinicia el componente de IU clásica en cada nodo después de que se complete la instalación.
como se muestra en el siguiente ejemplo:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(Recomendado) Después de completar la instalación inicial, Apigee recomienda instalar la nueva IU de Edge (cuyo nombre de componente es
edge-management-ui
), que es una interfaz de usuario mejorada para desarrolladores y administradores de Apigee Edge para la nube privada.Para obtener más información, consulta Instala la nueva IU de Edge.
Una vez finalizada la instalación, consulta esta lista de acciones comunes posteriores a la instalación.
Quién puede realizar la instalación
Los archivos de distribución de Apigee Edge se instalan como un conjunto de RPM y dependencias. Para instalar, desinstalar y actualizar los RPM de Edge, el usuario raíz o un usuario raíz deben ejecutar los comandos con acceso total a sudo. Para obtener acceso completo sudo, el usuario tiene acceso sudo para realizar las mismas operaciones que la raíz.
Cualquier usuario que quiera ejecutar los siguientes comandos o secuencias de comandos debe ser raíz o ser usuario con acceso completo a sudo:
- apigee-service:
- Comandos de apigee-service:
install, uninstall, update
- Comandos de apigee-all:
install, uninstall, update
- Comandos de apigee-service:
- setup.sh para instalar los componentes de Edge (a menos que ya hayas usado
“
apigee-service install
” para instalar los RPM requeridos. Luego, raíz o sudo completo acceso si no es necesario). - secuencia de comandos update.sh para actualizar los componentes de Edge
Además, el instalador de Edge crea un usuario nuevo en el sistema, llamado “apigee”. Muchos comandos de Edge invocar sudo para que se ejecute como “apigee” usuario.
Cualquier usuario que quiera ejecutar todos los demás comandos que no se muestran arriba debe ser un usuario con acceso completo sudo al “Apigee” usuario. Entre estos comandos, se incluyen los siguientes:
-
apigee-service, incluidos los siguientes:
- Comandos de apigee-service, como
start, stop, restart, configure
. - comandos apigee-all como
start, stop, restart, configure
- Comandos de apigee-service, como
Crea un usuario con acceso completo de sudo a “apigee” usuario
Configurar un usuario para que tenga acceso completo sudo a “apigee” usuario, utiliza el comando "visudo" para edita el archivo sudoers y agrega lo siguiente:
installUser ALL=(apigee) NOPASSWD: ALL
installUser es el nombre de usuario de la persona que trabaja con Edge.
Establecer permisos en los archivos de configuración
Todos los archivos o recursos que usan los comandos de Edge deben ser accesibles para el “Apigee” usuario. Esta Incluye el archivo de licencia de Edge y todos los archivos de configuración.
Al crear un archivo de configuración, puede cambiar su propietario a “apigee:apigee” para garantizar que se podrá acceder a ellos a través de los siguientes comandos de Edge:
- Crea el archivo en un editor como cualquier usuario.
chown
es el propietario del archivo de “apigee:apigee” o si cambiaste el usuario ejecutar el servicio de Edge desde el servicio “Apigee” usuario, cambiar el archivo al usuario que está ejecutando el servicio perimetral.
Separa las tareas de instalación de Edge entre los usuarios raíz y los no raíz
Si bien es más sencillo realizar todo el proceso de instalación de Edge como administrador o por parte de un usuario tiene acceso completo sudo. Eso no siempre es posible. En su lugar, puedes separar proceso en tareas realizadas por la raíz y tareas realizadas por un usuario con acceso completo sudo al “Apigee” usuario.
- Tareas realizadas por raíz:
- Descarga y ejecuta el archivo
bootstrap_4.52.00.sh
:curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
En este paso, se instala la utilidad
apigee-service
y se crea el “apigee” usuario. - Configurar un usuario para que tenga acceso completo sudo a “apigee” usuario, como se describe en Crea un usuario con acceso completo de sudo a “apigee” usuario.
- Instala la utilidad
apigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Usa la utilidad
apigee-setup
para instalar los RPM de Edge en el nodo:/opt/apigee/apigee-service/bin/apigee-service compName install
Los RPM de Edge que instalas en el nodo dependen de tu topología. La lista de componentes disponibles incluyen:
apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server
.
- Descarga y ejecuta el archivo
- Después de que el usuario raíz instala los RPM de Edge en el nodo, el usuario con acceso sudo completo a
el “Apigee” usuario completa el proceso de configuración:
- Usa la utilidad
setup.sh
para completar la configuración de Edge componentes en el nodo. La forma del comando depende de los componentes que instalada en el nodo. Para obtener una lista completa, consulta Instala componentes de Edge en un nodo.Por ejemplo, para completar la instalación de ZooKeeper y Cassandra, usa lo siguiente :
/opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile
En el ejemplo anterior, configFile es el archivo de configuración de Edge.
Como alternativa, usa el siguiente comando para realizar una instalación todo en uno:
/opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile
- Usa la utilidad
Ubicación de los archivos de configuración de la instalación
Debes pasar un archivo de configuración a la utilidad apigee-setup
que contenga el
para obtener más información sobre la instalación de Edge. El único requisito para las instalaciones silenciosas es que
de configuración de Terraform debe ser accesible y legible por el “Apigee” usuario. Por ejemplo, coloca el archivo
en el directorio /usr/local/var
o /usr/local/share
del nodo
chown
a “apigee:apigee”.
Se requiere toda la información del archivo de configuración, excepto para el sistema de Edge
contraseña de administrador. Si omites la contraseña, la utilidad apigee-setup
solicita una.
para ingresarlo en la línea de comandos.
Consulta Instala componentes de Edge en un nodo para obtener más información.
Manejo de una falla de instalación
Si se produce una falla durante la instalación de un componente de Edge, puedes intentar corregir el problema y, luego, vuelve a ejecutar el instalador. El instalador está diseñado para ejecutarse de manera repetida en casos en los que se detecta una falla, o si más adelante deseas cambiar o actualizar un componente después de instalación.
Después de instalar o actualizar, asegúrate de reiniciar el componente de IU de Edge en cada nodo en el que mientras se está ejecutando.
Instalación con o sin Internet
Para instalar Edge en un nodo, este debe poder acceder al repositorio de Apigee:
- Nodos con conexión a Internet externa
Los nodos con una conexión a Internet externa acceden al repositorio de Apigee para instalar Edge los RPM y las dependencias.
- Nodos sin conexión a Internet externa
Los nodos que no tienen conexión externa a Internet pueden acceder a una versión duplicada de Apigee que se configura internamente. Este repositorio contiene todos los RPM de Edge, pero debes asegúrate de tener todas las demás dependencias disponibles en los repositorios en el en cada red.
Para crear el repositorio interno de Apigee, necesitas un nodo con una conexión de Internet externa para poder descargar los RPM y las dependencias de Edge. Una vez que hayas creado un repositorio interno, puede moverlo a otro nodo o hacer que sea accesible para Edge para la instalación.
Usa un repositorio de Edge local para mantener tu versión de Edge
Una de las razones para usar un repositorio local o duplicado es para instalar Edge en los nodos sin conexión externa a Internet, como se describió en la sección anterior.
Cómo resolver dependencias de instalación de RPM
Los archivos de distribución de Apigee Edge se instalan como un conjunto de archivos de RPM, cada uno de los cuales puede tener su propia cadena de dependencias de instalación. Muchas de estas dependencias son definidas por recursos que están fuera del control de Apigee y que pueden cambiar en cualquier momento. Por lo tanto, el no incluye el número de versión explícito de cada dependencia.
Si realizas la instalación en una máquina con acceso a Internet, el nodo puede descargar los RPM y las dependencias necesarios. Sin embargo, si instalas desde un nodo sin Internet por lo general, se configura un repositorio interno con todas las dependencias necesarias. La única forma para garantizar que se incluyan todas las dependencias en tu repositorio local es intentar realizar una instalación, identificar las dependencias faltantes y copiarlas en el repositorio local hasta que finalice la instalación. tiene éxito.
Comandos comunes de Yum
Las herramientas de instalación de Edge para Linux dependen de Yum para instalar y actualizar componentes. Quizás debes usar varios comandos de Yum para administrar una instalación en un nodo.
- Limpia todas las cachés de Yum:
sudo yum clean all
- Sigue estos pasos para actualizar un componente de Edge:
sudo yum update componentName
Por ejemplo:
sudo yum update apigee-setup
sudo yum update edge-management-server
Estructura del sistema de archivos
Edge instala todos los archivos del directorio /opt/apigee
.
En esta guía y en la Guía de operaciones de Edge, el directorio de instalación raíz se indica de la siguiente manera:
/opt/apigee
En la instalación, se usa la siguiente estructura de sistema de archivos para implementar Apigee Edge para aplicaciones de Google Cloud.
Archivos de registro
El archivo de registro de apigee-setup
y la secuencia de comandos setup.sh
se escriben en
/tmp/setup-root.log
Los archivos de registro de cada componente se encuentran en el archivo /opt/apigee/var/log
.
. Cada componente tiene su propio subdirectorio. Por ejemplo, los registros de la administración
servidor están en el directorio:
/opt/apigee/var/log/edge-management-server
En las siguientes tablas, se muestra la ubicación de los archivos de registro:
Componente | Ubicación |
---|---|
Servidor de administración |
/opt/apigee/var/log/edge-management-server
|
Router |
/opt/apigee/var/log/edge-router
El router perimetral se implementa con Nginx. Para obtener registros adicionales, consulta lo siguiente:
|
Message Processor |
/opt/apigee/var/log/edge-message-processor
|
Servidor Qpid de Apigee |
/opt/apigee/var/log/edge-qpid-server
|
Servidor de Apigee Postgres | /opt/apigee/var/log/edge-postgres-server |
IU clásica (no la nueva IU de Edge, cuyo nombre de componente es
edge-management-ui ) |
/opt/apigee/var/log/edge-ui |
ZooKeeper | /opt/apigee/var/log/apigee-zookeeper |
OpenLDAP | /opt/apigee/var/log/apigee-openldap |
Cassandra | /opt/apigee/var/log/apigee-cassandra/system.log |
Qpidd | /opt/apigee/var/log/apigee-qpidd |
Base de datos de PostgreSQL | /opt/apigee/var/log/apigee-postgresql |
apigee-monit |
/opt/apigee/var/log/apigee-monit |
Datos
Componente | Ubicación |
---|---|
Servidor de administración | /opt/apigee/data/edge-management-server |
Router | /opt/apigee/data/edge-router |
Message Processor | /opt/apigee/data/edge-message-processor |
Agente de Qpid de Apigee | /opt/apigee/data/edge-qpid-server |
Agente de Apigee Postgres | /opt/apigee/data/edge-postgres-server |
ZooKeeper | /opt/apigee/data/apigee-zookeeper |
OpenLDAP | /opt/apigee/data/apigee-openldap |
Cassandra | /opt/apigee/data/apigee-cassandra/data |
Qpidd | /opt/apigee/data/apigee-qpid/data |
Base de datos de PostgreSQL | /opt/apigee/data/apigee-postgres/pgdata |
apigee-monit |
/opt/apigee/data/apigee-monit |
Habilitar la verificación del sistema durante la instalación
El archivo de configuración de instalación de Edge admite la siguiente propiedad:
ENABLE_SYSTEM_CHECK=y
Si estableces esta propiedad en "y", el instalador verifica que el sistema cumpla con los requisitos los requisitos de memoria del componente que se está instalando. El valor predeterminado es "n". para inhabilitar la de verificación.