Mantenimiento de la organización y el entorno

En esta sección, se abarcan varias operaciones administrativas, por ejemplo, la creación, la administración y la eliminación de organizaciones, entornos y hosts virtuales de Apigee en una instalación de Apigee Edge para nube privada.

Para obtener una introducción a las organizaciones, los entornos y los hosts virtuales, consulta Acerca de los planetas, las regiones, los pods, las organizaciones, los entornos y los hosts virtuales.

Verifica el estado de los usuarios, la organización y el entorno

El servidor de administración desempeña un papel fundamental para mantener unidos todos los demás componentes en una instalación local de Edge para la nube privada. Puedes verificar el estado del usuario, de la organización y de la implementación en el servidor de administración emitiendo los siguientes comandos de curl:

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

El sistema debería mostrar el estado HTTP 200 para todas las llamadas. Si estos fallan, haz lo siguiente:

  1. Revisa los registros del servidor de administración en /opt/apigee/var/log/apigee/management-server para ver si hay errores.
  2. Realiza una llamada al servidor de administración para verificar si funciona correctamente.
  3. Quita el servidor del ELB y, luego, reinicia el servidor de administración:
    /opt/apigee/bin/apigee-service management-server restart

Acerca del uso de archivos de configuración

Los comandos que se muestran a continuación toman un archivo de configuración como entrada. Por ejemplo, pasas un archivo de configuración al comando setup-org para definir todas las propiedades de la organización, incluidos el entorno y el host virtual.

Para obtener un archivo de configuración completo y más información sobre las propiedades que puedes establecer en el archivo de configuración, consulta Incorpora una organización.

Acerca de la configuración de un host virtual

Un host virtual en Edge define los dominios y los puertos del router de Edge en los que se expone un proxy de API y, por extensión, la URL que usan las apps para acceder a un proxy de API. Un host virtual también define si se accede al proxy de API con el protocolo HTTP o con el protocolo HTTPS encriptado.

Usa las secuencias de comandos y las llamadas a la API que se muestran a continuación para crear un host virtual. Cuando creas el host virtual, debes especificar la siguiente información:

  • El nombre del host virtual que usas para hacer referencia a él en tus proxies de API.
  • El puerto en el router para el host virtual. Por lo general, estos puertos comienzan en 9001 y se incrementan en uno para cada host virtual nuevo.
  • El alias de host del host virtual. Por lo general, el nombre de DNS del host virtual.

    El router de Edge compara el encabezado Host de la solicitud entrante con la lista de alias de host como parte de la determinación del proxy de API que controla la solicitud. Cuando realices una solicitud a través de un host virtual, especifica un nombre de dominio que coincida con el alias de host de un host virtual o especifica la dirección IP del router y el encabezado Host que contiene el alias de host.

Por ejemplo, si creaste un host virtual con un alias de host de myapis.apigee.net en el puerto 9001, ejecuta una solicitud curl a una API a través de ese host virtual podría usar una de las siguientes formas:

  • Si tienes una entrada de DNS para myapis.apigee.net, haz lo siguiente:
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • Si no tienes una entrada de DNS para myapis.apigee.net, haz lo siguiente:
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    En la segunda, se especifica la dirección IP del router y se pasa el alias de host en el encabezado Host.

Opciones cuando no tienes una entrada de DNS para el host virtual

Una opción cuando no tienes una entrada de DNS es configurar el alias de host en la dirección IP del router y el puerto del host virtual, como routerIP:port. Por ejemplo:

192.168.1.31:9001

Luego, ejecuta un comando curl con el siguiente formato:

curl http://routerIP:9001/proxy-base-path/resource-path

Se prefiere esta opción porque funciona bien con la IU de Edge.

Si tienes varios routers, agrega un alias de host para cada uno y especifica la dirección IP de cada router y el puerto del host virtual.

Como alternativa, puedes establecer el alias del host en un valor, como temp.hostalias.com. Luego, debes pasar el encabezado Host en cada solicitud:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

También puedes agregar el alias de host a tu archivo /etc/hosts. Por ejemplo, agrega esta línea a /etc/hosts:

192.168.1.31   temp.hostalias.com

Luego, puedes realizar una solicitud como si tuvieras una entrada de DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path