Skip to content

GCP

Google Cloud is a cloud platform with services for compute, storage, databases, networking, data analytics and AI, in regions around the world. It’s strongest at data and machine learning, with BigQuery, Spanner, and Vertex AI with Gemini, and at Kubernetes, with GKE.

New to Google Cloud? Start with What is GCP?.

A quick example

Section titled “A quick example”

A Firestore database is a declaration:

src/links.ts
import * as GCP from "@alchemy.run/gcp";


export const Links = GCP.Firestore.Database("Links", { type: "FIRESTORE_NATIVE" });

A Cloud Run service binds it, and reads and writes documents as plain objects. The binding grants the service’s account access to that one database:

src/api.ts
import * as GCP from "@alchemy.run/gcp";
import * as Effect from "effect/Effect";
import * as HttpServerResponse from "effect/http/HttpServerResponse";
import { Links } from "./links.ts";


export default class Api extends GCP.Function<Api>()(
  "Api",
  { main: import.meta.url, invokerIamDisabled: true },
  Effect.gen(function* () {
    const db = yield* GCP.Firestore.ReadWriteDatabase(Links);
    return {
      fetch: Effect.gen(function* () {
        yield* db.set("links/demo", { url: "https://alchemy.run" });
        const link = yield* db.get("links/demo");
        return yield* HttpServerResponse.json(link?.fields ?? {});
      }).pipe(Effect.orDie),
    };
  }).pipe(Effect.provide(GCP.Firestore.ReadWriteDatabaseHttp)),
) {}

And the Stack deploys it to the project your profile names:

alchemy.run.ts
import * as Alchemy from "alchemy";
import * as GCP from "@alchemy.run/gcp";
import * as Effect from "effect/Effect";
import Api from "./src/api.ts";


export default Alchemy.Stack(
  "MyApp",
  { providers: GCP.providers(), state: GCP.state() },
  Effect.gen(function* () {
    const api = yield* Api;
    return { url: api.uri };
  }),
);

Where to start

Section titled “Where to start”

Want to build? The tutorial goes from an empty folder to a tested service deployed from CI, one step at a time. Start with Setup to connect your project.

Looking for something specific? Every section of these docs is listed below, and every resource is in the generated API reference.

The docs

Section titled “The docs”

Accounts & access

Compute

Storage & databases

Messaging & events

Networking

Observability

Frontend

APIs

AI