Skip to content

docs(storage): a GCS emulator needs a disable_oauth key file; fake-gcs-server is not one #1187

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ertime037 merged 1 commit into from
Oct 27, 2026
Merged

docs(storage): a GCS emulator needs a disable_oauth key file; fake-gcs-server is not one #1187

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions nora-registry/src/config/storage.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,10 +47,15 @@ pub struct StorageConfig {
/// Workload Identity / GCE service accounts need no key material).
#[serde(default)]
pub gcs_service_account_path: Option<String>,
/// GCS: endpoint override for emulators (fake-gcs-server) or Private
/// Google Access endpoints. Unset = https://storage.googleapis.com.
/// GCS: endpoint override for emulators or Private Google Access
/// endpoints. Unset = https://storage.googleapis.com.
/// Emulator-only caveat: an `http://` override also disables request
/// signing — do not point this at a plaintext non-emulator endpoint.
/// Writes still ask for a token, so against an emulator also set
/// `gcs_service_account_path` to a key file with `"disable_oauth": true`
/// (`private_key`, `private_key_id` and `client_email` must be present but
/// are not used). The emulator must serve the GCS XML API, including
/// object PUT and `x-goog-copy-source` copies: fake-gcs-server does not.
#[serde(default)]
pub gcs_base_url: Option<String>,
}
Expand Down
6 changes: 4 additions & 2 deletions nora-registry/src/storage/object.rs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -118,8 +118,10 @@ impl ObjectStorage {
/// `GOOGLE_APPLICATION_CREDENTIALS`, ...), then the instance metadata
/// server — so GKE Workload Identity and GCE service accounts work with no
/// key material at all. `base_url` overrides the endpoint for emulators
/// (fake-gcs-server) or private access endpoints; an `http://` base_url
/// also skips request signing (emulators don't verify signatures).
/// or private access endpoints; an `http://` base_url also skips request
/// signing (emulators don't verify signatures). object_store still asks the
/// credential provider for a token on writes, so an emulator needs a key
/// file with `"disable_oauth": true` (see `StorageConfig::gcs_base_url`).
pub fn new_gcs(
bucket: &str,
service_account_path: Option<&str>,
Expand Down
Loading