Edge para nube privada v. 4.17.05
En esta sección, se abordan varias operaciones administrativas, como 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 la 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.
Verificar el estado de los usuarios, la organización y el entorno
Management Server desempeña un rol fundamental para mantener todos los demás componentes juntos en una instalación local de la nube privada perimetral. Puedes verificar el estado del usuario, la organización y la implementación en el servidor de administración mediante la emisión de los siguientes comandos 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 debe mostrar el estado HTTP 200 para todas las llamadas. Si fallan, haz lo siguiente:
- Revisa los registros de Management Server en /opt/apigee/var/log/apigee/management-server para detectar errores.
- Realiza una llamada al servidor de administración para verificar si funciona correctamente.
- Quita el servidor del ELB y, luego, reinicia el servidor de administración:
/opt/apigee/bin/apigee-service management-server restart
Información 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, pasa 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 la información sobre las propiedades que puedes establecer en el archivo de configuración, consulta Integra una organización.
Información para configurar un host virtual
Un host virtual en Edge define los dominios y los puertos del router perimetral 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 a través del protocolo HTTP o 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.
- Es el puerto del router para el host virtual. Por lo general, estos puertos comienzan en 9001 y se incrementan en uno por cada host virtual nuevo.
- El alias de host del host virtual. Por lo general, es el nombre de DNS del host virtual.
El router perimetral compara el encabezado del 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 del host de un host virtual o especifica la dirección IP del router y el encabezado del host que contiene el alias del host.
Por ejemplo, si creaste un host virtual con un alias de host de myapis.apigee.net en el puerto 9001, una solicitud de 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:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - Si no tienes una entrada de DNS para myapis.apigee.net:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
En el segundo formato, debes especificar la dirección IP del router y pasar el alias del host en el encabezado del host.
Nota: El comando curl, la mayoría de los navegadores y muchas otras utilidades agregan automáticamente el encabezado Host con el dominio como parte de la solicitud para que puedas usar un comando curl en el formato:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
Opciones cuando no tienes una entrada de DNS para el host virtual
Cuando no tienes una entrada de DNS, puedes establecer el alias del host para la dirección IP del router y el puerto del host virtual, como <routerIP>:port. Por ejemplo:
192.168.1.31:9001
Cuando ejecutes un comando curl en el siguiente formulario:
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 router 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 del host a tu archivo /etc/hosts. Por ejemplo, agrega la siguiente línea a /etc/hosts:
192.168.1.31 temp.hostalias.com
Luego, puedes realizar una solicitud como si tuviera una entrada DNS:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}