Résoudre les problèmes liés aux vues régionales des ressources globales

Ce document explique comment résoudre les problèmes de cohérence, les retards de réplication et le comportement des métriques de quota lorsque vous interrogez des ressources mondiales via des points de terminaison d'API de vue régionale Compute Engine. Pour en savoir plus sur les points de terminaison en lecture seule régionalisés, consultez Vues régionales des ressources mondiales.

Retards de réplication ou ressources manquantes

Lorsque vous interrogez des points de terminaison de métadonnées régionaux, vous pouvez constater que les ressources mondiales nouvellement créées ou les champs de métadonnées récemment mis à jour n'apparaissent pas immédiatement dans les réponses régionales.

Les API de vue régionale traitent les requêtes de lecture en interrogeant une instance répliquée en lecture seule régionale de la base de données mondiale centrale. Les mises à jour apportées aux ressources mondiales principales à l'aide de points de terminaison mondiaux standards sont répliquées de manière asynchrone sur ces instances répliquées régionales.

Cette réplication asynchrone signifie que les vues régionales sont cohérentes à terme. La latence de réplication P99 de la base de données mondiale centrale vers les instances répliquées régionales est généralement inférieure à 60 secondes.

Résolution : Pour résoudre ce problème, essayez l'une des solutions suivantes :

  • Attendez la réplication : la plupart des mises à jour de réplication sont effectuées en moins de 60 secondes. Si un script automatisé ou une charge de travail client interroge une ressource nouvellement créée, assurez-vous que votre client implémente une logique de nouvelle tentative avec un délai exponentiel.
  • Comprendre le basculement transparent : si une requête GET explicite pour un ID de ressource spécifique ciblant une instance répliquée régionale entraîne un échec de cache, Compute Engine tente automatiquement une lecture de secours dans la base de données mondiale centrale au cours de la même transaction.
  • Interroger les points de terminaison mondiaux pour une cohérence forte : si votre pipeline de déploiement nécessite une cohérence immédiate en lecture après écriture sans latence de réplication, interrogez directement les points de terminaison mondiaux canoniques au lieu des vues régionales. Par exemple, interrogez projects.get, images.get, ou images.list.

Réponses 404 Not Found

Vous pouvez recevoir un code d'état HTTP 404 Not Found lorsque vous tentez de récupérer une image ou une vue de projet spécifique.

Une erreur 404 Not Found peut se produire pour les raisons suivantes :

  • La ressource cible n'existe pas dans la base de données mondiale centrale.
  • La ressource cible a été créée au cours des dernières secondes, la réplication sur l'instance répliquée régionale n'est pas terminée et la requête de basculement transparente vers la base de données mondiale centrale a expiré ou a échoué.
  • Vous avez spécifié un paramètre de région ou un ID de projet non valide dans l'URL de la requête.

Résolution : Pour résoudre ce problème, procédez comme suit :

  1. Vérifiez que la ressource demandée existe globalement en exécutant une requête standard mondiale describe ou list. Par exemple, gcloud compute images describe IMAGE_NAME ou gcloud compute project-info describe --project=PROJECT_ID.
  2. Inspectez le chemin de l'URL de la requête pour vous assurer que la chaîne REGION cible est valide et active.
  3. Si la ressource a été créée récemment, réessayez la requête après 60 secondes.

Tableau quota manquant dans les réponses projectViews

Lorsque vous interrogez une ressource compute.Project à l'aide de points de terminaison projectViews.get régionaux, le tableau quota est exclu de la réponse.

Pour maintenir l'isolation des pannes régionales et la haute disponibilité, le point de terminaison projectViews lit strictement à partir de son instance répliquée régionale. Comme il n'effectue pas de fan-out interrégional pour collecter l'utilisation des quotas dans toutes les zones, le tableau quota est exclu.

Résolution : Pour résoudre ce problème, procédez comme suit :

  • Assurez-vous que vos applications n'attendent pas le tableau quota dans les réponses renvoyées par les points de terminaison projectViews régionaux.
  • Pour récupérer la configuration précise des quotas et les métriques d'utilisation en temps réel dans toutes les régions et zones, interrogez le point de terminaison mondial projects.get ou surveillez les métriques de quota de l'API Compute Engine dans Cloud Monitoring.

Étape suivante