Menghubungkan Firebase App Hosting ke jaringan VPC

Backend Firebase App Hosting Anda dapat terhubung ke jaringan Virtual Private Cloud (VPC). Hal ini memungkinkan backend Firebase App Hosting Anda mengakses layanan backend yang tidak dapat diakses menggunakan alamat IP publik, seperti Cloud SQL, Spanner, Cloud Memorystore, Compute Engine, atau microservice internal Kubernetes.

Akses VPC hanya tersedia saat runtime (dari container Cloud Run Anda), bukan saat waktu build (Cloud Build).

Memilih cara terhubung ke jaringan VPC

  • Egress VPC Langsung: Lebih sederhana, lebih cepat, dan lebih murah. Menggunakan satu alamat IP per container. Direkomendasikan untuk sebagian besar kasus penggunaan.
  • Konektor Serverless: Menggabungkan alamat IP untuk aplikasi yang lebih besar. Memerlukan pembayaran untuk VM yang mendasarinya. Lihat "Akses VPC Serverless" di halaman harga VPC untuk mengetahui detail harga.

Konfigurasi di apphosting.yaml

Gunakan pemetaan vpcAccess dalam file apphosting.yaml Anda untuk mengonfigurasi akses. Gunakan nama jaringan/konektor yang sepenuhnya memenuhi syarat atau ID. Penggunaan ID memungkinkan portabilitas antara lingkungan staging dan produksi dengan konektor/jaringan yang berbeda.

Konfigurasi Traffic Keluar VPC Langsung (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

Konfigurasi Konektor Serverless (apphosting.yaml):

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

Contoh: terhubung ke Memorystore for Redis dari aplikasi Next.js

Sistem caching seperti Redis atau Memcached umum digunakan untuk membangun lapisan caching data yang cepat untuk aplikasi. Contoh ini menunjukkan cara menyiapkan Memorystore for Redis di project Google Cloud yang sama dengan backend Firebase App Hosting Anda dan menghubungkannya menggunakan Direct VPC egress.

Langkah 0: Membuat instance Memorystore for Redis

  1. Buka halaman Memorystore for Redis di Google Cloud console.
    • Pastikan project yang sama dengan yang Anda gunakan untuk Firebase App Hosting dipilih.
    • Jika Anda tidak dapat mengakses halaman ini, pastikan penagihan diaktifkan untuk project Anda dan Anda telah mengaktifkan Memorystore API.
  2. Pilih Create Instance.
  3. Konfigurasikan instance baru dengan setelan yang Anda inginkan. Berikut beberapa contoh nilai yang dapat Anda gunakan:
    • Masukkan my-redis-cache di bagian Instance ID.
    • Masukkan Redis cache di bagian Display name.
    • Pilih Basic di bagian pemilih paket. Paket dasar menetapkan node Redis mandiri, berbeda dengan paket standar, yang menggunakan node replika untuk mencadangkan data Anda.
    • Pilih region backend App Hosting Anda dari pemilih Region. Pastikan untuk menetapkan nilai ini agar sesuai dengan region backend Anda.
    • Pilih any dari pemilih zona.
    • Masukkan 5 di bagian Capacity. Tindakan ini menetapkan kapasitas instance Anda ke 5 GB.
    • Pilih 7.0 (atau versi yang direkomendasikan secara default) di bagian Version.
    • Pilih default dari pemilih Authorized network.

Langkah 1: Perbarui apphosting.yaml dengan ID jaringan VPC Anda

  1. Buka halaman jaringan VPC di konsol Google Cloud.
  2. Temukan ID jaringan VPC untuk instance Memorystore for Redis Anda (sering kali berupa default).
  3. Tetapkan konfigurasi traffic keluar VPC langsung di apphosting.yaml menggunakan ID jaringan VPC:

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

Langkah 2: Tambahkan variabel lingkungan yang mengarahkan aplikasi Anda ke Redis

  1. Temukan informasi koneksi (host dan port) di tab "Connections" pada instance Memorystore for Redis Anda di Google Cloud console.
  2. Hubungkan ke Redis dengan variabel lingkungan REDISPORT dan REDISHOST. Tetapkan ini di apphosting.yaml menggunakan nilai host dan port dari konsol Google Cloud:

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

Langkah 3: Menggunakan redis dari aplikasi Anda

  1. Instal paket npm redis:

    npm install redis@latest

  2. Mengakses cache Redis dari kode Anda. Gunakan variabel lingkungan yang dikonfigurasi di langkah sebelumnya. Misalnya, berikut cara membaca dari cache di pengendali rute 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({
            socket: {
              host: REDISHOST,
              port: Number(REDISPORT),
            },
          })
            .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 });
      }
      

Langkah 4 (opsional): Konfigurasikan aplikasi Anda untuk pengembangan lokal

Emulator Firebase App Hosting dapat mengganti nilai menggunakan apphosting.emulator.yaml. Di sini, Anda dapat mengubah nilai REDISHOST agar mengarah ke localhost sehingga Anda dapat melakukan pengembangan secara lokal menggunakan penginstalan Redis lokal.

  1. Menginstal Redis di komputer lokal Anda
  2. Buat atau edit apphosting.emulator.yaml untuk mereferensikan instance lokal Anda:

    env:
      - variable: REDISHOST
        value: 127.0.0.1