Note:
- Este tutorial requiere acceso a Oracle Cloud. Para registrarse en una cuenta gratuita, consulte Introducción a la cuenta gratuita de Oracle Cloud Infrastructure.
- Utiliza valores de ejemplo para credenciales, arrendamiento y compartimentos de Oracle Cloud Infrastructure. Al completar el laboratorio, sustituya estos valores por otros específicos de su entorno en la nube.
Despliegue de un sitio web estático mediante Oracle Cloud Infrastructure API Gateway
Introducción
Oracle Cloud Infrastructure (OCI) API Gateway es un servicio totalmente gestionado sin servidor en OCI que se puede utilizar para proteger puntos finales de API y aplicaciones web. Proporciona muchas funcionalidades de seguridad, como limitación de frecuencia, aplicación de autorización, enrutamiento dinámico, aplicación de SSL, etc. En este tutorial analizamos cómo podemos transferir un sitio web estático a OCI API Gateway para que sirva como sitio web
Objetivos
- Despliegue un sitio web estático en OCI API Gateway para que sirva como sitio web.
Requisitos
-
Acceso al gateway de API de OCI con los permisos adecuados para configurar el gateway y el despliegue de API.
-
Un sitio web estático listo para ejecutarse detrás de OCI API Gateway.
Tarea 1: Preparar su sitio web estático
Asegúrese de tener el contenido estático de su sitio web listo, esto incluye archivos HTML, CSS, Javascript y cualquier otro activo contenido en su sitio web.
Tarea 2: Ejecución del script de Python para crear un archivo json
Descargue el script de Python desde aquí: ap_gw.py. El script acepta dos entradas, un directorio que contiende todos los archivos del sitio web estático y el directorio (con el nombre de archivo) donde se almacenará el archivo json
. El archivo json
de salida se puede cargar en OCI API Gateway como una especificación que creará rutas separadas para cada archivo y las rutas respectivas se pueden refrenar dentro de los archivos para alcanzar el HTML, CSS, Javascript específico o cualquier otro archivo alojado detrás del gateway de API. El gateway de API de OCI tiene una restricción de que el tamaño máximo de cuerpo permitido es de 4096 bytes, por lo que al ejecutar el script si el tamaño de cuerpo de la sección de cuerpo al crear json
supera los 4096 bytes, el script devolverá un error y la ejecución se detendrá. A continuación se muestra un ejemplo de cómo se puede ejecutar el script en Windows.
Nota:
C:\Website
es la ruta de acceso donde se encuentran los archivos del sitio web yC:\Test\output.json
es la ruta de acceso donde se almacenará el archivojson
.
Tarea 3: Configuración de OCI API Gateway y carga del archivo json
como especificación de API en OCI API Gateway
-
Conéctese a la consola de OCI, vaya a Developer Services, API Management y API Gateway.
-
En Gateways, vaya a su gateway de API donde desea ejecutar este despliegue. Si no ha creado un gateway de API, haga clic en Crear gateway para crear un gateway de API.
-
En la página Detalles de gateway, seleccione Despliegues en la lista Recursos y haga clic en Crear despliegue.
-
En la página Detalles básicos, introduzca la siguiente información y haga clic en Siguiente. Además, también puede agregar autenticación y otros controles si es necesario.
- Seleccione Cargar una API de despliegue existente.
- Nombre: introduzca un nombre de despliegue.
- Prefijo de Ruta de Acceso: Introduzca una ruta de acceso única. Por ejemplo,
/
. - Especificación: cargue el archivo
json
creado en la tarea 2.
-
En la página Revisar, revise el despliegue y haga clic en Crear.
Una vez hecho esto, puede navegar por la página de inicio de su sitio web o la index.html (o cualquier otra ruta que sea aplicable a su sitio web). Ahora, puede navegar por la página de inicio de su sitio web o index.html
(o cualquier otra ruta aplicable para su sitio). Su sitio web ahora se ejecutará detrás del gateway de API de OCI, al que normalmente se puede acceder mediante una URL como https://xxxxxxxxxxx.apigateway.us-ashburn-1.oci.customer-oci.com/index.html
.
Enlaces relacionados
Agradecimientos
- Autor: Aqib Javid Bhat (ingeniero sénior en la nube)
Más recursos de aprendizaje
Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en Oracle Learning Explorer.
Para obtener documentación sobre el producto, visite Oracle Help Center.
Deploy a Static Website using Oracle Cloud Infrastructure API Gateway
G11488-01
July 2024