Cette page a été traduite par l'API Cloud Translation.

Connecter Firebase App Hosting à un réseau VPC

Votre backend Firebase App Hosting peut se connecter à un réseau de cloud privé virtuel (VPC). Cela permet à votre backend Firebase App Hosting d'accéder aux services de backend qui ne sont pas accessibles à l'aide d'adresses IP publiques, tels que Cloud SQL, Spanner, Cloud Memorystore, Compute Engine ou les microservices internes Kubernetes.

L'accès au VPC n'est disponible qu'au moment de l'exécution (à partir de votre conteneur Cloud Run), et non au moment de la compilation (Cloud Build).

Choisir comment se connecter à un réseau VPC

Sortie VPC directe : plus simple, plus rapide et moins coûteuse. Utilise une adresse IP par conteneur. Recommandé pour la plupart des cas d'utilisation.
Connecteurs sans serveur : met en pool les adresses IP pour les applications plus volumineuses. Nécessite le paiement de la VM sous-jacente. Pour en savoir plus sur les tarifs, consultez la section "Accès au VPC sans serveur" sur la page des tarifs de VPC.

Configurer dans `apphosting.yaml`

Utilisez le mappage vpcAccess dans votre fichier apphosting.yaml pour configurer l'accès. Utilisez un nom de réseau/connecteur complet ou un ID. L'utilisation d'ID permet la portabilité entre les environnements de préproduction et de production avec différents connecteurs/réseaux.

Configuration de la sortie VPC directe (`apphosting.yaml`) :

runConfig:
  vpcAccess:
    egress: PRIVATE_RANGES_ONLY # Default value
    networkInterfaces:
      # Specify at least one of network and/or subnetwork
      - network: my-network-id
        subnetwork: my-subnetwork-id

Configuration du connecteur sans serveur (`apphosting.yaml`) :

runConfig:
  vpcAccess:
    egress: ALL_TRAFFIC
    connector: connector-id

Exemple : se connecter à Memorystore pour Redis depuis une application Next.js

Les systèmes de mise en cache comme Redis ou Memcached sont couramment utilisés pour créer une couche de mise en cache de données rapide pour une application. Cet exemple vous montre comment configurer Memorystore pour Redis dans le même projet Google Cloud que votre backend Firebase App Hosting et comment vous y connecter à l'aide de la sortie VPC directe.

Étape 0 : Créez une instance Memorystore pour Redis

Accédez à la page Memorystore pour Redis dans la console Google Cloud.
- Assurez-vous que le même projet que celui que vous utilisez pour Firebase App Hosting est sélectionné.
- Si vous ne parvenez pas à accéder à cette page, assurez-vous que la facturation est activée pour votre projet et que vous avez activé l'API Memorystore.
Sélectionnez Créer une instance.
Configurez la nouvelle instance avec les paramètres de votre choix. Voici quelques exemples de valeurs que vous pouvez utiliser :
- Saisissez my-redis-cache sous ID de l'instance.
- Saisissez Redis cache sous Nom à afficher.
- Sélectionnez De base sous le sélecteur de niveau. Le niveau de base désigne un nœud Redis autonome, contrairement au niveau standard qui utilise un nœud dupliqué pour sauvegarder vos données.
- Choisissez la région de votre backend App Hosting dans le sélecteur Région. Veillez à définir cette valeur pour qu'elle corresponde à la région de votre backend.
- Sélectionnez N'importe quelle dans le sélecteur de zone.
- Saisissez 5 sous Capacité. La capacité de votre instance est alors définie sur 5 Go.
- Sélectionnez 5.0 sous Version (recommandé).
- Sélectionnez Par défaut dans le sélecteur Réseau autorisé.

Étape 1 : Remplacez `apphosting.yaml` par l'ID de votre réseau VPC

Accédez à la page Réseaux VPC dans la console Google Cloud.
Recherchez l'ID du réseau VPC de votre instance Memorystore pour Redis (il s'agit souvent de default).

Définissez la configuration de sortie VPC directe dans apphosting.yaml à l'aide de l'ID du réseau VPC :

runConfig:
  vpcAccess:
    egress: PRIVATE_RANGES_ONLY # Default value
  networkInterfaces:
    - network: my-network-id

Étape 2 : Ajoutez des variables d'environnement qui redirigent votre application vers Redis

Recherchez les informations de connexion (hôte et port) dans l'onglet "Connexions" de votre instance Memorystore pour Redis dans la console Google Cloud.
Connectez-vous à Redis avec les variables d'environnement REDISPORT et REDISHOST. Définissez-les dans apphosting.yaml en utilisant les valeurs d'hôte et de port de la console Google Cloud :
```
env:
  # Sample only. Use actual values provided by Memorystore
  - variable: REDISPORT
    value: 6379
  - variable: REDISHOST
    value: 10.127.16.3
```

Étape 3 : Utilisez Redis depuis votre application

Installez le package npm redis :

npm install redis@latest

Accédez à votre cache Redis depuis votre code. Utilisez les variables d'environnement configurées à l'étape précédente. Par exemple, voici comment lire à partir d'un cache dans un gestionnaire de route Next.js :

src/lib/redis.js

import { createClient } from "redis";

// Set these environment variables in apphosting.yaml
const REDISHOST = process.env.REDISHOST;
const REDISPORT = process.env.REDISPORT;

let redisClient;

export async function getClient(req, res) {
  // Only connect if a connection isn't already available
  if (!redisClient) {
    redisClient = await createClient(REDISPORT, REDISHOST)
      .on("error", (err) => console.error("Redis Client Error", err))
      .connect();
  }

  return redisClient;
}

src/app/counter/route.js

import { getClient } from "@/lib/redis.js";

export async function GET(request) {
  const redisClient = await getClient();
  const count = await redisClient.get("counter");

  return Response.json({ count });
}

export async function POST(request) {
  const redisClient = await getClient();
  const count = await redisClient.incr("counter");

  return Response.json({ count });
}

Étape 4 (facultatif) : Configurez votre application pour le développement local

L'émulateur Firebase App Hosting peut remplacer les valeurs à l'aide de apphosting.emulator.yaml. Ici, vous pouvez modifier la valeur de REDISHOST pour qu'elle pointe vers l'hôte local. Vous pourrez ainsi développer en local à l'aide d'une installation locale de Redis.

Installer Redis sur votre machine locale
Créez ou modifiez apphosting.emulators.yaml pour faire référence à votre instance locale :
```
env:
  - variable: REDISHOST
    value: 127.0.0.1
```