starred/fake-gcs-server

Fork 0

mirror of https://github.com/fsouza/fake-gcs-server.git synced 2026-04-25 13:45:52 +03:00

[GH-ISSUE #587] Update examples to include documentation on how to run/required configuration #106

New issue

Open

opened 2026-03-03 12:08:20 +03:00 by kerem · 11 comments

kerem commented

2026-03-03 12:08:20 +03:00

Owner

Originally created by @potatochip on GitHub (Sep 30, 2021).
Original GitHub issue: https://github.com/fsouza/fake-gcs-server/issues/587

Raises error from gcs client

Originally created by @potatochip on GitHub (Sep 30, 2021). Original GitHub issue: https://github.com/fsouza/fake-gcs-server/issues/587 Raises error from gcs client

kerem added the

enhancement

documentation

labels

2026-03-03 12:08:20 +03:00

kerem commented

2026-03-03 12:08:20 +03:00

Author

Owner

@fsouza commented on GitHub (Oct 1, 2021):

Can you provide more details? Which command did you run? How did you start the server? What error did you get?

@fsouza commented on GitHub (Oct 1, 2021): Can you provide more details? Which command did you run? How did you start the server? What error did you get?

kerem commented

2026-03-03 12:08:20 +03:00

Author

Owner

@potatochip commented on GitHub (Oct 1, 2021):

$ docker run -d --name fake-gcs-server -p 4443:4443 fsouza/fake-gcs-server

# roughly verbatim from examples/python/python.py
from google.auth.credentials import AnonymousCredentials
from google.cloud import storage

client = storage.Client(
    credentials=AnonymousCredentials(),
    project="test",
)
list(client.list_buckets())

BadRequest: 400 GET https://storage.googleapis.com/storage/v1/b?project=test&projection=noAcl&prettyPrint=false: Unknown project id: 0

@potatochip commented on GitHub (Oct 1, 2021): ```shell $ docker run -d --name fake-gcs-server -p 4443:4443 fsouza/fake-gcs-server ``` ```python # roughly verbatim from examples/python/python.py from google.auth.credentials import AnonymousCredentials from google.cloud import storage client = storage.Client( credentials=AnonymousCredentials(), project="test", ) list(client.list_buckets()) ``` ``` BadRequest: 400 GET https://storage.googleapis.com/storage/v1/b?project=test&projection=noAcl&prettyPrint=false: Unknown project id: 0 ```

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@fsouza commented on GitHub (Oct 1, 2021):

Oh I see, it's trying to connect to the real server, you need to set the endpoint, either via an environment variable or the proper parameters in the client.

Take a look on how we do it in CI: https://github.com/fsouza/fake-gcs-server/blob/main/ci/run-python-example.sh.

@fsouza commented on GitHub (Oct 1, 2021): Oh I see, it's trying to connect to the real server, you need to set the endpoint, either via an environment variable or the proper parameters in the client. Take a look on how we do it in CI: https://github.com/fsouza/fake-gcs-server/blob/main/ci/run-python-example.sh.

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@potatochip commented on GitHub (Oct 5, 2021):

Thanks for checking. It does work after doing that. Might want to update documentation to mention env var or other options in order to get things working.

@potatochip commented on GitHub (Oct 5, 2021): Thanks for checking. It does work after doing that. Might want to update documentation to mention env var or other options in order to get things working.

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@fsouza commented on GitHub (Oct 5, 2021):

Do you think that replicating the comment at the top of the Go example is enough or do we need more?

@fsouza commented on GitHub (Oct 5, 2021): Do you think that replicating the comment at the top of the [Go example](https://github.com/fsouza/fake-gcs-server/blob/main/examples/go/main.go) is enough or do we need more?

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@potatochip commented on GitHub (Oct 5, 2021):

Should be fine

On Tue, Oct 5, 2021 at 10:57 AM francisco souza @.***>
wrote:

Do you think that replicating the comment at the top of the Go example
https://github.com/fsouza/fake-gcs-server/blob/main/examples/go/main.go
is enough or do we need more?

—
You are receiving this because you authored the thread.
Reply to this email directly, view it on GitHub
https://github.com/fsouza/fake-gcs-server/issues/587#issuecomment-934589916,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/ACTKRCGI34WZFOMEI34A2P3UFMU7DANCNFSM5FDL7VQQ
.

@potatochip commented on GitHub (Oct 5, 2021): Should be fine On Tue, Oct 5, 2021 at 10:57 AM francisco souza ***@***.***> wrote: > Do you think that replicating the comment at the top of the Go example > <https://github.com/fsouza/fake-gcs-server/blob/main/examples/go/main.go> > is enough or do we need more? > > — > You are receiving this because you authored the thread. > Reply to this email directly, view it on GitHub > <https://github.com/fsouza/fake-gcs-server/issues/587#issuecomment-934589916>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/ACTKRCGI34WZFOMEI34A2P3UFMU7DANCNFSM5FDL7VQQ> > . >

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@wwwjn commented on GitHub (Apr 22, 2022):

Same problem make me stuck for a while! I believe we might need better documentation for examples. (Cause It's very easy to ignore the comment on the top.

@wwwjn commented on GitHub (Apr 22, 2022): Same problem make me stuck for a while! I believe we might need better documentation for examples. (Cause It's very easy to ignore the comment on the top.

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@fsouza commented on GitHub (Apr 22, 2022):

@wwwjn where do you think we should put the documentation?

@fsouza commented on GitHub (Apr 22, 2022): @wwwjn where do you think we should put the documentation?

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@wwwjn commented on GitHub (Apr 22, 2022):

Thanks a lot for your quick response! For example, we can add a short markdown file in the /examples folder.
Btw, Thanks for create such a great project!

@wwwjn commented on GitHub (Apr 22, 2022): Thanks a lot for your quick response! For example, we can add a short markdown file in the /examples folder. Btw, Thanks for create such a great project!

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@fsouza commented on GitHub (Apr 22, 2022):

Thanks a lot for your quick response! For example, we can add a short markdown file in the /examples folder.
Btw, Thanks for create such a great project!

That's a good idea! We can add the markdown file with the generic information that applies to all examples and then have some inline comments in the code whenever there are any specifics. I will try to find time to work on that on the weekend or early next week.

@fsouza commented on GitHub (Apr 22, 2022): > Thanks a lot for your quick response! For example, we can add a short markdown file in the /examples folder. > Btw, Thanks for create such a great project! > That's a good idea! We can add the markdown file with the generic information that applies to all examples and then have some inline comments in the code whenever there are any specifics. I will try to find time to work on that on the weekend or early next week.

kerem commented

2026-03-03 12:08:21 +03:00

Author

Owner

@somen440 commented on GitHub (May 1, 2022):

I had a similar problem. The sample worked locally with the following command.

docker run --rm --name fake-gcs-server -p 8080:8080 -v ${PWD}/examples/data:/data fsouza/fake-gcs-server -scheme http -backend memory -port 8080 -public-host localhost:8080

@somen440 commented on GitHub (May 1, 2022): I had a similar problem. The sample worked locally with the following command. ```sh docker run --rm --name fake-gcs-server -p 8080:8080 -v ${PWD}/examples/data:/data fsouza/fake-gcs-server -scheme http -backend memory -port 8080 -public-host localhost:8080 ```

kerem referenced this issue

2026-03-03 12:29:35 +03:00

[PR #106] [MERGED] build(deps): bump cloud.google.com/go/storage from 1.1.1 to 1.1.2 #343