Łączenie Hostingu aplikacji Firebase z siecią VPC

Backend hostingu aplikacji Firebase App Hosting może łączyć się z siecią prywatnego środowiska wirtualnego w chmurze (VPC). Dzięki temu backend hostingu aplikacji Firebase może uzyskiwać dostęp do usług backendu, które są niedostępne przy użyciu publicznych adresów IP, takich jak Cloud SQL, Spanner, Cloud Memorystore, Compute Engine, czy wewnętrzne mikroserwisy Kubernetes.Firebase App Hosting

Dostęp do sieci VPC jest dostępny tylko w czasie działania (z kontenera Cloud Run ), a nie w czasie kompilacji (Cloud Build).

Wybierz sposób łączenia się z siecią VPC

  • Bezpośredni ruch wychodzący VPC: prostszy, szybszy i tańszy. Używa 1 adresu IP na kontener. Zalecany do większości zastosowań.
  • Łączniki bezserwerowe: pulują adresy IP na potrzeby większych aplikacji. Wymagają płatności za bazową maszynę wirtualną. Szczegółowe informacje o cenach znajdziesz w sekcji „Bezserwerowy dostęp do VPC” na stronie z cennikiem VPC.

Konfigurowanie w apphosting.yaml

Aby skonfigurować dostęp, użyj mapowania vpcAccess w pliku apphosting.yaml. Użyj pełnej i jednoznacznej nazwy sieci lub łącznika albo identyfikatora. Używanie identyfikatorów umożliwia przenoszenie między środowiskami testowymi i produkcyjnymi z różnymi łącznikami lub sieciami.

Konfiguracja bezpośredniego połączenia VPC dla ruchu wychodzącego (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

Konfiguracja łącznika bezserwerowego (apphosting.yaml):

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

Przykład: łączenie się z Memorystore for Redis z aplikacji Next.js

Systemy buforowania, takie jak Redis czy Memcached, są powszechnie używane do tworzenia szybkiej warstwy buforowania danych w aplikacji. W tym przykładzie pokazujemy, jak skonfigurować Memorystore for Redis w tym samym Google Cloud projekcie co backend Firebase App Hosting i połączyć się z nim przy użyciu bezpośredniego ruchu wychodzącego VPC.

Krok 0. Utwórz instancję Memorystore for Redis

  1. W konsoli otwórz stronę Memorystore for Redis.Google Cloud
    • Upewnij się, że wybrany jest ten sam projekt, którego używasz na potrzeby Firebase App Hosting jest wybrany.
    • Jeśli nie możesz otworzyć tej strony, sprawdź, czy w projekcie jest włączona płatność i czy masz włączony interfejs Memorystore API.
  2. Kliknij Utwórz instancję.
  3. Skonfiguruj nową instancję z preferowanymi ustawieniami. Oto kilka przykładowych wartości, których możesz użyć:
    • W polu Identyfikator instancji wpisz my-redis-cache.
    • W polu Wyświetlana nazwa wpisz Redis cache.
    • W selektorze typu wybierz Podstawowy. Typ podstawowy oznacza samodzielny węzeł Redis, w przeciwieństwie do typu standardowego, który używa węzła repliki do tworzenia kopii zapasowych danych.
    • W selektorze Region wybierz region backendu App Hosting. Upewnij się, że ta wartość jest zgodna z regionem backendu.
    • W selektorze strefy wybierz dowolny.
    • W polu Rozmiar wpisz 5. Ustawia to rozmiar instancji na 5 GB.
    • W sekcji Wersja wybierz 5.0 (zalecane).
    • W selektorze Autoryzowana sieć wybierz default (domyślna).

Krok 1. Zaktualizuj apphosting.yaml o identyfikator sieci VPC

  1. W konsoli otwórz stronę Sieci VPC .Google Cloud
  2. Znajdź identyfikator sieci VPC dla instancji Memorystore for Redis (często będzie to default).

  3. Skonfiguruj bezpośredni ruch wychodzący VPC w apphosting.yaml za pomocą identyfikatora sieci VPC:

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

Krok 2. Dodaj zmienne środowiskowe, które kierują aplikację do Redis

  1. Informacje o połączeniu (host i port) znajdziesz w konsoli Google Cloud na karcie „Połączenia” instancji Memorystore for Redis.

  2. Połącz się z Redis za pomocą zmiennych środowiskowych REDISPORT i REDISHOST. Ustaw je w apphosting.yaml za pomocą wartości hosta i portu z Google Cloud konsoli:

    env:
  # Sample only. Use actual values provided by Memorystore
  - variable: REDISPORT
    value: 6379
  - variable: REDISHOST
    value: 10.127.16.3

Krok 3. Użyj Redis w aplikacji

  1. Zainstaluj pakiel npm redis:

    npm install redis@latest

  2. Uzyskaj dostęp do pamięci podręcznej Redis z kodu. Użyj zmiennych środowiskowych skonfigurowanych w poprzednim kroku. Oto przykład, jak można odczytać dane z pamięci podręcznej w obsłudze trasy 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 });
}

Krok 4 (opcjonalny). Skonfiguruj aplikację na potrzeby lokalnego programowania

Emulator Firebase App Hosting może zastępować wartości za pomocą apphosting.emulator.yaml. W tym miejscu możesz zmienić wartość REDISHOST, aby wskazywała localhost, dzięki czemu możesz programować lokalnie za pomocą lokalnej instalacji Redis.

  1. Zainstaluj Redis na komputerze lokalnym.

  2. Utwórz lub edytuj apphosting.emulators.yaml, aby odwoływać się do instancji lokalnej:

    env:
  - variable: REDISHOST
    value: 127.0.0.1