Skip to content
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.

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

docs: improve ADC related error and warning messages #449

Merged
merged 3 commits into from Sep 7, 2023

Conversation

bajajneha27
Copy link
Contributor

@bajajneha27 bajajneha27 commented Sep 5, 2023

Fixes #415

@bajajneha27 bajajneha27 requested a review from a team as a code owner September 5, 2023 09:00
"You are authenticating using user credentials." \
"For production, we recommend using service account credentials." \
"To learn more about service account credentials, see" \
"http://cloud.google.com/docs/authentication/external/set-up-adc-on-cloud".freeze
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the intent to drop the note about being able to suppress the message with an environment variable?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't think so. I'll remove it. Thanks.

@dazuma dazuma merged commit 4bb8c5c into googleapis:main Sep 7, 2023
12 checks passed
Copy link
Member

@TimurSadykov TimurSadykov left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Passing by review, added one comment

"server applications use service accounts instead. If your application continues to use end user credentials " \
'from Cloud SDK, you might receive a "quota exceeded" or "API not enabled" error. For more information about ' \
"service accounts, see https://cloud.google.com/docs/authentication/. To suppress this message, set the " \
"You are authenticating using user credentials." \
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Per the document we want to REMOVe the old message. (1.2.1)
The substitution has different logic (show in prod only) and for now we implement it only for Java/Python. (1.2.2)

So in case of Ruby you can just remove this logic and message completely.

@@ -21,7 +21,7 @@ module Google
module Auth
NOT_FOUND_ERROR = <<~ERROR_MESSAGE.freeze
Could not load the default credentials. Browse to
https://developers.google.com/accounts/docs/application-default-credentials
https://cloud.google.com/docs/authentication/provide-credentials-adc
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Per (1.2.3) both mesage and link has to be updated. the "external" link does redirect and is expected, it allows tech writer to make changes later:

Your credentials were not found. To set up Application Default Credentials for your environment, see https://cloud.google.com/docs/authentication/external/set-up-adc

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Improve local user experience for User Credentials
3 participants