Remarques :
- Ce tutoriel nécessite un accès à Oracle Cloud. Pour vous inscrire à un compte gratuit, reportez-vous à Introduction au niveau gratuit d'Oracle Cloud Infrastructure.
- Il utilise des exemples de valeur pour les informations d'identification, la location et les compartiments Oracle Cloud Infrastructure. A la fin de l'exercice, remplacez ces valeurs par des valeurs propres à votre environnement cloud.
Déploiement d'un site Web statique à l'aide d'Oracle Cloud Infrastructure API Gateway
Introduction
Oracle Cloud Infrastructure (OCI) API Gateway est un service entièrement géré sans serveur dans OCI qui peut être utilisé pour protéger les adresses d'API et les applications Web. Il fournit de nombreuses fonctionnalités de sécurité telles que la limitation de débit, l'application des autorisations, le routage dynamique, l'application SSL, etc. Dans ce tutoriel, nous expliquons comment propager un site Web statique vers OCI API Gateway en tant que site Web
Objectifs
- Déployez un site Web statique sur OCI API Gateway en tant que site Web.
Prérequis
-
Accédez à OCI API Gateway avec les droits d'accès appropriés pour configurer la passerelle d'API et le déploiement.
-
Site Web statique prêt à être exécuté derrière OCI API Gateway.
Tâche 1 : préparer votre site Web statique
Assurez-vous que le contenu de votre site Web statique est prêt, ce qui inclut les fichiers HTML, CSS, Javascript et tous les autres éléments contenus dans votre site Web.
Tâche 2 : exécution du script Python pour créer un fichier json
Téléchargez le script Python à l'adresse suivante : ap_gw.py. Le script accepte deux entrées, un répertoire qui contient tous vos fichiers de site Web statiques et le répertoire (avec le nom de fichier) où le fichier json
sera stocké. Le fichier json
généré peut ensuite être téléchargé sur la passerelle d'API OCI en tant que spécification qui créera des chemins distincts pour chaque fichier et les chemins respectifs peuvent être réorganisés dans les fichiers pour atteindre le fichier HTML, CSS, Javascript ou tout autre fichier hébergé derrière la passerelle d'API. La passerelle d'API OCI a une restriction selon laquelle la taille de corps maximale autorisée est de 4096 octets. Par conséquent, lors de l'exécution du script, si la taille de corps dans la section de corps lors de la création de json
dépasse 4096 octets, le script génère une erreur et l'exécution s'arrête. Voici un exemple de la façon dont le script peut être exécuté sous Windows.
Remarque :
C:\Website
est le chemin d'accès aux fichiers de votre site Web etC:\Test\output.json
est le chemin d'accès au fichierjson
.
Tâche 3 : configurer OCI API Gateway et télécharger le fichier json
en tant que spécification d'API sur OCI API Gateway
-
Connectez-vous à la console OCI, accédez à Services de développeur, à API Management et à API Gateway.
-
Sous Passerelles, accédez à la passerelle d'API sur laquelle exécuter ce déploiement. Si vous n'avez pas créé de passerelle d'API, cliquez sur Créer une passerelle pour créer une passerelle d'API.
-
Sur la page Détails de la passerelle, sélectionnez Déploiements dans la liste Ressources, puis cliquez sur Créer un déploiement.
-
Sur la page Détails de base, entrez les informations suivantes et cliquez sur Suivant. En outre, vous pouvez également ajouter l'authentification et d'autres contrôles si nécessaire.
- Sélectionnez Télécharger une API de déploiement existante.
- Nom : entrez un nom de déploiement.
- Préfixe de chemin : entrez un chemin unique. Par exemple,
/
. - Spécification : téléchargez le fichier
json
créé dans la tâche 2.
-
Sur la page Vérifier, vérifiez le déploiement et cliquez sur Créer.
Une fois cela fait, vous pouvez parcourir la page d'accueil de votre site Web ou le index.html (ou tout autre chemin applicable à votre site Web). Désormais, vous pouvez parcourir la page d'accueil de votre site Web ou le index.html
(ou tout autre chemin applicable à votre site). Votre site Web sera désormais exécuté derrière OCI API Gateway, généralement accessible à l'aide d'une URL telle que https://xxxxxxxxxxx.apigateway.us-ashburn-1.oci.customer-oci.com/index.html
.
Liens connexes
Remerciements
- Auteur - Aqib Javid Bhat (ingénieur cloud senior)
Ressources de formation supplémentaires
Parcourez d'autres ateliers sur docs.oracle.com/learn ou accédez à davantage de contenus de formation gratuits sur le canal Oracle Learning YouTube. De plus, rendez-vous sur education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.
Pour obtenir de la documentation sur le produit, visitez Oracle Help Center.
Deploy a Static Website using Oracle Cloud Infrastructure API Gateway
G11490-01
July 2024