Descripción general de la instalación de Edge

Edge for Private Cloud v. 4.17.09

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 el entorno de Apigee-setup de Edge utilitario para obtener más información.
• 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 Topologías de instalación para más.
• En cada nodo de la topología seleccionada, instala la utilidad apigee-setup de Edge:
  • Descarga el archivo bootstrap_4.17.09.sh de Edge en /tmp/bootstrap_4.17.09.sh
  • Instalar la utilidad apigee-service de Edge y dependencias.
  • Instalar la utilidad apigee-setup de Edge dependencias.
    
    Consulte Cómo instalar el Utilidad de configuración de Apigee de Edge para obtener más.
• Usa apigee-setup para instalar uno o más componentes de Edge en cada nodo según la y la topología de red.
  Consulta Cómo instalar componentes de Edge en un nodo dentro de un nodo.
• En el nodo de Management Server, use la utilidad apigee-setup para instalar apigee-provision, las utilidades que se usan para crear y administrar organizaciones de Edge.
  Consulta Integra una organización para lo siguiente: más.

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: instalación, desinstalación, actualización.
  • Comandos apigee-all: instala, desinstala y actualiza.
• setup.sh para instalar los componentes de Edge (a menos que ya hayas usado “apigee-service install” a instalar los RPM requeridos. Luego, accede con permisos de administrador o sudo completo si no se requiere).
• 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 de apigee-all como start, stop, restart, configure

Crear un usuario con Acceso completo 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.

Activar permisos de configuración de Terraform

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:

1. Crea el archivo en un editor como cualquier usuario.
2. Cómprale el propietario del archivo a “apigee:apigee” o si cambiaste el usuario que ejecuta Edge de la API de Apigee usuario, cambiar el archivo al usuario que ejecuta Edge servicio.

Separar Tareas de instalación perimetral entre un usuario raíz y otro no raíz

Aunque es más sencillo realizar todo el proceso de instalación de Edge como raíz o hacerlo solo con un usuario sudo completo, eso no siempre es posible. En cambio, puedes dividir el proceso en tareas que realiza la raíz y las tareas que realiza un usuario con acceso completo de sudo al “apigee” usuario.

1. Tareas realizadas por raíz:
   1. Descarga y ejecuta el archivo bootstrap_4.17.09.sh:
      > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
      
      En este paso, se instala la utilidad apigee-service y se crea la “Apigee” usuario.
   2. Configurar un usuario para que tenga acceso completo sudo a “apigee” usuario, como se describió anteriormente.
   3. Instala la utilidad apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   4. Usa apigee-setup para instalar los RPM de Edge en el nodo:
      > /opt/apigee/apigee-service/bin/apigee-service compName instalación
      
      Los RPM de Edge que instalas en el nodo dependen de tu topología. La lista de los recursos disponibles incluyen los siguientes: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, Edge-ui, Edge-management-server Edge-ui, Edge-router, Edge-message-processor, apigee-postgresql, apigee-qpidd Edge-postgres-server y Edge-qpid-server
2. 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:
   1. Usa el archivo setup.sh para completar la configuración de los componentes de Edge en el nodo. El formato del depende de los componentes que instalaste 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 comando:
      > /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

Ubicación de la configuración de la instalación archivos

Debes pasar un archivo de configuración a la utilidad apigee-setup que contenga la 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 /usr/local/var o directorio /usr/local/share en el y cambiarlo 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 te solicita que la ingreses. en la línea de comandos.

Consulta Instala Edge. componentes 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.

Instalación con o sin Internet

Para instalar Edge en un nodo, este debe poder acceder al repositorio de Apigee:

• Nodos con una 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 y asegurarse de tener todas las demás dependencias disponibles en los repositorios de la red interna.
  
  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.
  
  Nota: Apigee no aloja todas las dependencias de terceros en nuestra de Cloud Storage. Debes descargar e instalar estas dependencias desde archivos de acceso público de Cloud Storage.

El uso de un repositorio local de Edge 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.

Pero hay otra ventaja de usar un repositorio local, incluso para nodos con o a Internet. Cuando instalas Edge desde el repositorio público de Apigee, los RPM de Edge más recientes. Por lo tanto, si quieres descargar y almacenar los RPM de Edge para un una versión de Edge, entonces, debes crear un repositorio local para esa versión. Luego, puedes usar un repositorio local para realizar instalaciones de cualquier versión de Edge.

Por ejemplo, primero debes usar el repositorio local para instalar un entorno de desarrollo de Edge. Luego, Cuando esté todo listo para pasar a un entorno de producción, instalarás de nuevo Edge desde la versión local. repo. Si lo instalas desde el repositorio local, garantizas que el desarrollo y la producción que los entornos de búsqueda coincidan.

Un repositorio duplicado es muy flexible. Por ejemplo, puedes crear un repositorio duplicado a partir del último RPM de Edge o de una versión específica de Edge Después de que crees el repositorio, también puedes actualizarlo para agregar RPM de distintas versiones de Edge. Consulta Instala el entorno de Apigee-setup de Edge utilitario para obtener más información.

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:
  actualización de sudo yum componentName
  Por ejemplo:
  sudo yum update apigee-setup
  sudo yum actualiza Edge-management-server

Estructura del sistema de archivos

Edge instala todos los archivos en el directorio /opt/apigee.

En esta guía y en la guía de operaciones de Edge, se indica el directorio de instalación raíz como:

/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 escribe en /tmp/setup-root.log.

Los archivos de registro de cada componente se encuentran en el directorio /opt/apigee/var/log. Cada componente tiene su propio subdirectorio. Por ejemplo, los registros del servidor de administración se encuentran en el directorio:

/opt/apigee/var/log/edge-management-server

En las siguientes tablas, se muestra la ubicación de los archivos de registro:

Datos

Tareas posteriores de instalación

Una vez finalizada la instalación, puedes realizar acciones adicionales en los componentes de Edge.

Configura Edge componentes posteriores a la instalación

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

Los archivos .properties son ubicado en el directorio /opt/apigee/customer/application. Cada componente tiene su propio archivo .properties en ese directorio. Para por ejemplo, router.properties y management-server.properties.

Si deseas configurar una propiedad para un componente, edita el archivo .properties correspondiente y, luego, reinicia la componente:

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

Por ejemplo:

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

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

Consulta Cómo configurar Edge más información sobre la configuración de Edge.

Cómo invocar comandos en Edge componentes

Edge instala utilidades de administración en /opt/apigee/apigee-service/bin que puedes usar para administrar una instalación de Edge. Por ejemplo, puedes usar la utilidad apigee-all para iniciar, detener, reiniciar, o determinar el estado de todos los componentes de Edge en el nodo:

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

Usar la utilidad apigee-service para controlar y configurar componentes individuales. La utilidad apigee-service tiene la siguiente forma:

/opt/apigee/apigee-service/bin/apigee-service component action

Por ejemplo, para reiniciar el router perimetral, sigue estos pasos:

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

Puede determinar la lista de componentes instalados en el nodo examinando el directorio /opt/apigee. Ese directorio contiene un subdirectorio para cada componente de Edge instalado en el nodo. Cada subdirectorio es precedido por:

• apigee: un servicio de terceros componente que usa Edge. Por ejemplo, apigee-cassandra.
• edge: Un componente de Edge de Apigee. Por ejemplo, edge-management-server.
• edge-mint: una función de monetización este componente. Por ejemplo, edge-mint-management-server.
• baas: una BaaS de API este componente. Por ejemplo, baas-usergrid.

La lista completa de acciones de un componente depende de este, pero todas componentes admiten las siguientes acciones:

• iniciar, detener, reiniciar
• estado, versión
• copia de seguridad, restablecimiento
• instalar, desinstalar