A useful first test is one object written and read back through the same client your application uses. This guide uses CloudBurrow v0.1.0 and the official Python Cloud Storage client. You will start a local instance, set up a separate shell and check the bytes you read.
Start the local instance
Install the v0.1.0 binary for your Mac or Linux machine and have Docker, kind and kubectl ready. The install page lists the supported engines and release options. Use a shell where you can leave CloudBurrow running while you try the client in another one. Get Started, pinned install prerequisites.
cloudburrow version --short
cloudburrow doctor
cloudburrow up
Check that the version is v0.1.0. Read the doctor output before starting. It can point you to a missing tool, a stopped Docker daemon or a port another process is using. Once the instance is ready, leave it running. CloudBurrow creates a kind cluster in Docker and writes a kubeconfig for its own instance. Pinned install checks.
Point a second shell at the local services
Open another shell. Export the environment from the instance you just started. If you set a name or service list at startup, use the same configuration flags for env.
eval "$(cloudburrow env)"
printf 'Project: %s\nStorage endpoint: %s\n' \
"$GOOGLE_CLOUD_PROJECT" "$STORAGE_EMULATOR_HOST"
For a default instance, the Storage endpoint is http://127.0.0.1:9001. Keep the scheme in that value, since the Python client uses it. The project is the local project exported by CloudBurrow. The environment also points Application Default Credentials at the generated local fixture and sets the local metadata endpoint. Use this shell for the example so the SDK gets those values together. Credentials at v0.1.0.
Write and read an object with the Python client
In a scratch directory, create a virtual environment and install the Storage client version pinned by the release’s Python suite.
python3 -m venv .venv
. .venv/bin/activate
python -m pip install google-cloud-storage==3.14.1
Save this as storage-example.py and run python storage-example.py in the shell where you exported the environment. This matches the release documentation’s example, which the Python suite runs from that file. Storage example at v0.1.0, example test at v0.1.0.
import uuid
from google.cloud import storage
client = storage.Client()
bucket = client.create_bucket(f"example-{uuid.uuid4().hex[:12]}")
bucket.blob("hello.txt").upload_from_string("hello")
assert bucket.blob("hello.txt").download_as_text() == "hello"
bucket.delete(force=True)
A successful run creates a temporary bucket, writes the object, checks the downloaded text and removes the bucket. If the client cannot connect, check that the instance is still ready and that the project and endpoint printed in the same shell match the instance you started.
Close the test shell when finished. If you created the instance for this exercise, stop the foreground process and use cloudburrow delete to remove its cluster. For the next operation your application needs, look up the release column and its named test in the compatibility matrix. Pinned CLI commands.