Bigtable

Emulates the control plane of Cloud Bigtable, GCP's wide-column NoSQL database — the admin API that provisions instances and clusters, creates tables with column families, and manages app profiles and backups. The data plane (reading and writing rows) is out of scope, so it has its own driver. An instance owns clusters and tables; backups live under a cluster and restore into a new table.

Reach for it when your provisioning code creates a Bigtable instance, adds clusters, defines tables and column families, or backs up and restores a table — without a real (billed) instance. Served as GCP REST/JSON under /v2/..., so a real google.golang.org/api/bigtableadmin/v2 client with a custom endpoint works unchanged; the wire layer uses the SDK's own types for exact fidelity.

Drive it with the real SDK#

Run cloudemu as a server and point a bigtableadmin service at it — the same client, with only the endpoint redirected. Start it with cloudemu serve (or docker run --rm -p 4569:4569 ghcr.io/stackshy/cloudemu), which serves the GCP API on http://localhost:4569:

cloudemu serve   # GCP API on http://localhost:4569

Then point the stock bigtableadmin service at that endpoint. Long-running RPCs return a done Operation carrying the resulting resource, so SDK LRO waits complete immediately:

import (
    "google.golang.org/api/bigtableadmin/v2"
    "google.golang.org/api/option"
)

svc, _ := bigtableadmin.NewService(ctx,
    option.WithEndpoint("http://localhost:4569"), option.WithoutAuthentication())

svc.Projects.Instances.Create("projects/my-project", &bigtableadmin.CreateInstanceRequest{
    InstanceId: "app",
    Instance:   &bigtableadmin.Instance{DisplayName: "App", Type: "PRODUCTION"},
    Clusters: map[string]bigtableadmin.Cluster{
        "c1": {Location: "projects/my-project/locations/us-central1-a",
            ServeNodes: 3, DefaultStorageType: "SSD"},
    },
}).Do()

See the SDK-Compat Server page for the full quick start.

In-process (Go unit tests)#

For Go unit tests written inside cloudemu-aware code, stand the same wire server up in-process with httptest.NewServer and point the client at ts.URL. The Drivers you pass name exactly the drivers this service needs:

import (
    "github.com/stackshy/cloudemu/v2"
    gcpserver "github.com/stackshy/cloudemu/v2/server/gcp"
)

cloud := cloudemu.NewGCP()
ts := httptest.NewServer(gcpserver.New(gcpserver.Drivers{Bigtable: cloud.Bigtable}))
defer ts.Close()
// point the same bigtableadmin service at ts.URL instead of the running endpoint

Call the driver directly#

For in-process setup or assertions you can skip the HTTP hop and call the driver. CreateInstance and other long-running calls return the resource plus an *Operation:

import btdriver "github.com/stackshy/cloudemu/v2/services/bigtable/driver"

inst, _, _ := gcp.Bigtable.CreateInstance(ctx, btdriver.CreateInstanceConfig{
    Name: "projects/my-project/instances/app", DisplayName: "App", Type: "PRODUCTION",
    Clusters: []btdriver.CreateClusterConfig{{
        Name:     "projects/my-project/instances/app/clusters/c1",
        Location: "projects/my-project/locations/us-central1-a",
        ServeNodes: 3, DefaultStorageType: "SSD",
    }},
})

gcp.Bigtable.CreateTable(ctx, btdriver.CreateTableConfig{
    Parent:  "projects/my-project/instances/app",
    TableID: "events",
})

Behavior & fidelity#

SDK-compat — Live#

Real bigtableadmin/v2 clients drive it end-to-end (GCP REST/JSON under /v2/...) — see SDK-Compat for the full operation list.