Déployer une API sur une passerelle
Prérequis
Pour pouvoir déployer une configuration d'API sur API Gateway, assurez-vous d'avoir :
Préparé votre environnement de développement, comme décrit dans la section Configurer votre environnement de développement.
Créé une configuration d'API à partir de votre définition d'API.
Exigences concernant les ID de passerelle
La plupart des commandes gcloud
présentées ci-dessous nécessitent de spécifier l'ID de la passerelle, au format suivant : GATEWAY_ID.
API Gateway applique les exigences suivantes pour l'ID de passerelle :
- Ne doit pas comporter plus de 49 caractères.
- Ne doit contenir que des lettres minuscules, des chiffres ou des tirets.
- Il ne doit pas commencer par un tiret.
- Il ne doit pas contenir de trait de soulignement.
Définir le point de terminaison de la configuration d'API déployée
Lorsque vous déployez une configuration d'API sur une passerelle, API Gateway crée un bucket unique
URL de la passerelle dans le domaine gateway.dev
. Vos clients API
Utilisez une URL au format ci-dessous pour accéder à la configuration de l'API déployée:
https://GATEWAY_ID-HASH.REGION_CODE.gateway.dev
où GATEWAY_ID est le nom de la passerelle, HASH est le code de hachage unique généré lors du déploiement de l'API et REGION_CODE est le code de la région GCP où vous avez déployé la passerelle.
Exemple :
https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev
Déployer une configuration d'API sur une passerelle
Utiliser la Google Cloud CLI pour déployer une configuration d'API sur une passerelle Lorsque vous déployez la configuration d'API, vous devez spécifier le nom de l'API. Si la passerelle n'existe pas encore pour l'API, cette commande la crée également.
Pour déployer une configuration d'API sur une passerelle, procédez comme suit :
Validez l'ID de projet renvoyé par la commande suivante, afin de vous assurer que la passerelle est créée dans le projet correct.
gcloud config list project
Si vous devez changer le projet par défaut, exécutez la commande suivante et remplacez PROJECT_ID par l'ID du projet Google Cloud dans lequel vous souhaitez créer le service :
gcloud config set project PROJECT_ID
Affichez l'aide de la commande
gateway create
:gcloud api-gateway gateways create --help
Exécutez la commande suivante pour déployer la configuration de l'API sur la passerelle :
gcloud api-gateway gateways create GATEWAY_ID \ --api=API_ID --api-config=CONFIG_ID \ --location=GCP_REGION --project=PROJECT_ID
où :
- GATEWAY_ID spécifie l'ID de la nouvelle passerelle. Si la passerelle n'existe pas encore, cette commande la crée.
- API_ID spécifie l'ID de l'API API Gateway associée à cette passerelle.
- CONFIG_ID spécifie l'ID de la configuration d'API déployée sur la passerelle. Vous devez spécifier une configuration d'API lorsque vous créez une passerelle.
GCP_REGION spécifie la région GCP de la passerelle déployée.
PROJECT_ID spécifie l'ID du projet Google Cloud.
Lors de la création de la passerelle,
gcloud
envoie des informations au terminal.Si l'opération réussit, vous pouvez utiliser la commande suivante pour afficher les détails de la passerelle :
gcloud api-gateway gateways describe GATEWAY_ID \ --location=GCP_REGION --project=PROJECT_ID
Cette commande renvoie les éléments suivants :
apiConfig: projects/PROJECT_ID/locations/global/apis/API_ID/configs/CONFIG_ID createTime: '2020-02-05T13:44:12.997862831Z' defaultHostname: my-gateway-a12bcd345e67f89g0h.uc.gateway.dev displayName: GATEWAY_ID name: projects/PROJECT_ID/locations/GCP_REGION/gateways/GATEWAY_ID serviceAccount: email: gateway-111111@222222-tp.iam.gserviceaccount.com state: ACTIVE updateTime: '2020-02-05T13:45:00.844705087Z'
Notez la valeur de la propriété
defaultHostname
. Il s'agit de la partie nom d'hôte de l'URL de la passerelle. Pour accéder à une configuration d'API déployée sur cette passerelle, utilisez une URL au format suivant:https://my-gateway-a12bcd345e67f89g0h.uc.gateway.dev
La Google Cloud CLI nécessite de nombreuses options, y compris celles décrites dans le document Documentation de référence gcloud De plus, Pour API Gateway, vous pouvez définir les options suivantes lorsque vous créez une passerelle:
--async
: rend le contrôle immédiatement au terminal, sans attendre la fin de l'opération.--display-name=NAME
: spécifie le nom à afficher de la passerelle, c'est-à-dire le nom affiché dans l'interface utilisateur. N'utilisez pas d'espaces dans le nom. Utilisez plutôt des traits d'union et des traits de soulignement. La valeur par défaut est GATEWAY_ID.--labels=KEY1=VALUE1,KEY2=VALUE2,...
: spécifie les libellés associés à la passerelle.
Répertorier les passerelles
Pour répertorier les passerelles d'un projet spécifique, procédez comme suit :
gcloud api-gateway gateways list --project=PROJECT_ID
Cette commande renvoie un résultat au format suivant :
GATEWAY_ID LOCATION DISPLAY_NAME STATE CREATE_TIME UPDATE_TIME my-gateway us-central1 my-gateway ACTIVE 2021-01-07T00:04:19 2022-05-21T00:33:46
Pour répertorier les passerelles d'un projet et d'une région spécifiques, procédez comme suit :
gcloud api-gateway gateways list --location=GCP_REGION --project=PROJECT_ID
Utilisez une expression filter
pour répertorier les passerelles associées à une API spécifique :
gcloud api-gateway gateways list \ --filter="apiConfig:projects/PROJECT_ID/locations/global/apis/API_ID/*" \ --project=PROJECT_ID
Vous pouvez également utiliser cette filter
pour répertorier les passerelles pour une configuration d'API spécifique :
gcloud api-gateway gateways list \ --filter="apiConfig:projects/PROJECT_ID/locations/global/apis/API_ID/configs/CONFIG_ID" \ --project=PROJECT_ID
Utilisez les ID de projet, de région et de passerelle pour obtenir des informations détaillées sur la passerelle, y compris l'identité de la configuration d'API déployée sur la passerelle :
gcloud api-gateway gateways describe GATEWAY_ID \ --location=GCP_REGION --project=PROJECT_ID
Mettre à jour une passerelle
Mettez à jour une passerelle pour :
- Déployer une autre configuration d'API sur la passerelle
- Modifier le nom à afficher
- Mettre à jour les étiquettes.
Exécutez la commande gcloud
suivante pour mettre à jour une passerelle existante, en remplaçant UPDATE_OPTIONS par l'option de passerelle et la valeur à mettre à jour:
gcloud api-gateway gateways update GATEWAY_ID \ UPDATE_OPTIONS --api=API_ID --location=GCP_REGION --project=PROJECT_ID
Par exemple, pour mettre à jour la configuration d'API déployée sur la passerelle :
gcloud api-gateway gateways update GATEWAY_ID \ --api-config=NEW_CONFIG_ID --api=API_ID --location=GCP_REGION --project=PROJECT_ID
où NEW_CONFIG_ID spécifie la nouvelle configuration d'API à déployer sur la passerelle.
Pour obtenir la liste complète des indicateurs et des arguments de mise à jour disponibles, consultez la documentation de référence sur gcloud api-gateway Gateways update ou utilisez la commande suivante pour afficher toutes les options de mise à jour:
gcloud api-gateway gateways update --help
Supprimer une passerelle
Utilisez la commande gcloud
suivante pour supprimer une passerelle existante :
gcloud api-gateway gateways delete GATEWAY_ID \ --location=GCP_REGION --project=PROJECT_ID